Permissions

Yöntem: tunedModels.permissions.create

Belirli bir kaynak için izin oluşturun.

Uç nokta

post https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Yol parametreleri

parent string

Zorunlu. Permission öğesinin üst kaynağı. Biçimler: tunedModels/{tunedModel} corpora/{corpus} tunedModels/{tunedmodel} biçimindedir.

İstek içeriği

İstek metni, Permission öğesinin bir örneğini içerir.

Alanlar
granteeType enum (GranteeType)

İsteğe bağlı. Değişmez. Hak sahibinin türü.

emailAddress string

İsteğe bağlı. Değişmez. Bu iznin ait olduğu kullanıcı veya grubun e-posta adresi. İzin verilenin türü EVERYONE olduğunda alan ayarlanmaz.

role enum (Role)

Zorunlu. Bu izinle verilen rol.

Örnek istek

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate

Yanıt gövdesi

Başarılı olursa yanıt metni, Permission öğesinin yeni oluşturulmuş bir örneğini içerir.

Yöntem: tunedModels.permissions.get

Belirli bir izin hakkında bilgi alır.

Uç nokta

get https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Yol parametreleri

name string

Zorunlu. İznin kaynak adı.

Biçimler: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} tunedModels/{tunedmodel}/permissions/{permission} biçimindedir.

İstek içeriği

İstek metni boş olmalıdır.

Örnek istek

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate

Yanıt gövdesi

Başarılıysa yanıt metni, Permission öğesinin bir örneğini içerir.

Yöntem: tunedModels.permissions.list

Belirli bir kaynağın izinlerini listeler.

Uç nokta

get https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Yol parametreleri

parent string

Zorunlu. İzinlerin üst kaynağı. Biçimler: tunedModels/{tunedModel} corpora/{corpus} tunedModels/{tunedmodel} biçimindedir.

Sorgu parametreleri

pageSize integer

İsteğe bağlı. Döndürülecek maksimum Permission sayısı (sayfa başına). Hizmet daha az izin döndürebilir.

Belirtilmediyse en fazla 10 izin döndürülür. Bu yöntem, daha büyük bir pageSize iletseniz bile sayfa başına en fazla 1.000 izin döndürür.

pageToken string

İsteğe bağlı. Önceki bir permissions.list çağrısından alınan sayfa jetonu.

Bir istek tarafından döndürülen pageToken değerini, sonraki sayfayı almak için sonraki isteğe bağımsız değişken olarak iletin.

Sayfalara ayırma işlemi yapılırken permissions.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek içeriği

İstek metni boş olmalıdır.

Örnek istek

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate

Yanıt gövdesi

Başarılıysa yanıt metni, ListPermissionsResponse öğesinin bir örneğini içerir.

Yöntem: tunedModels.permissions.patch

İzni günceller.

Uç nokta

patch https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

Yol parametreleri

permission.name string

Yalnızca çıkış. Tanımlayıcı. İzin adı. Oluşturma sırasında benzersiz bir ad oluşturulur. Örnekler: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Yalnızca çıkış. tunedModels/{tunedmodel}/permissions/{permission} biçimindedir.

Sorgu parametreleri

updateMask string (FieldMask format)

Zorunlu. Güncellenecek alanların listesi. Kabul edilenler: - rol (Permission.role alanı)

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "user.displayName,photo".

İstek içeriği

İstek metni, Permission öğesinin bir örneğini içerir.

Alanlar
role enum (Role)

Zorunlu. Bu izinle verilen rol.

Örnek istek

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate

Yanıt gövdesi

Başarılıysa yanıt metni, Permission öğesinin bir örneğini içerir.

Yöntem: tunedModels.permissions.delete

İzni siler.

Uç nokta

delete https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Yol parametreleri

name string

Zorunlu. İznin kaynak adı. Biçimler: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} tunedModels/{tunedmodel}/permissions/{permission} biçimindedir.

İstek içeriği

İstek metni boş olmalıdır.

Örnek istek

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate

Yanıt gövdesi

Başarılı olursa yanıt metni boş bir JSON nesnesi olur.

Yöntem: tunedModels.transferOwnership

Ayarlanmış modelin sahipliğini aktarır. Ayarlanmış modelin sahipliğini değiştirmenin tek yolu budur. Mevcut sahip, yazar rolüne düşürülür.

Uç nokta

post https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

Yol parametreleri

name string

Zorunlu. Sahipliği aktarılacak olan ayarlanmış modelin kaynak adı.

Biçim: tunedModels/my-model-id tunedModels/{tunedmodel} biçimindedir.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
emailAddress string

Zorunlu. Ayarlanmış modelin aktarıldığı kullanıcının e-posta adresi.

Yanıt gövdesi

Başarılı olursa yanıt metni boş olur.

REST Kaynağı: tunedModels.permissions

Kaynak: İzin

İzin kaynağı, kullanıcıya, gruba veya dünyanın geri kalanına PaLM API kaynağına (ör. ayarlanmış bir model, derlem) erişim izni verir.

Rol, kullanıcıların PaLM API kaynaklarında belirli işlemleri gerçekleştirmesine olanak tanıyan izin verilen işlemler topluluğudur. Bu kaynakları kullanıcılara, gruplara veya hizmet hesaplarına sunmak için roller atarsınız. Bir rol atadığınızda, rolün içerdiği izinleri vermiş olursunuz.

Üç eşmerkezli rol vardır. Her rol, önceki rolün izin verilen işlemlerinin üst kümesidir:

  • Okuyucu, çıkarım için kaynağı (ör.ayarlanmış model, derlem) kullanabilir.
  • yazarın okuyucu izinleri vardır ve ayrıca düzenleme ve paylaşma izni de vardır
  • sahibi, yazma izinlerine sahiptir ve ayrıca silebilir.
Alanlar
name string

Yalnızca çıkış. Tanımlayıcı. İzin adı. Oluşturma sırasında benzersiz bir ad oluşturulur. Örnekler: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Yalnızca çıkış.

granteeType enum (GranteeType)

İsteğe bağlı. Değişmez. Hak sahibinin türü.

emailAddress string

İsteğe bağlı. Değişmez. Bu iznin ait olduğu kullanıcı veya grubun e-posta adresi. İzin verilenin türü EVERYONE olduğunda alan ayarlanmaz.

role enum (Role)

Zorunlu. Bu izinle verilen rol.

JSON gösterimi
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

ListPermissions öğesinden, izinlerin sayfalandırılmış listesini içeren yanıt.

Alanlar
permissions[] object (Permission)

Döndürülen izinler.

nextPageToken string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton.

Bu alan atlanırsa başka sayfa yoktur.

JSON gösterimi
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}