Permissions

Metode: tunedModels.permissions.create

Buat izin ke resource tertentu.

Endpoint

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

Parameter jalur

parent string

Wajib. Resource induk Permission. Format: tunedModels/{tunedModel} corpora/{corpus} Formatnya adalah tunedModels/{tunedmodel}.

Isi permintaan

Isi permintaan memuat instance Permission.

Kolom
granteeType enum (GranteeType)

Opsional. Tidak dapat diubah. Jenis penerima hibah.

emailAddress string

Opsional. Tidak dapat diubah. Alamat email pengguna atau grup yang dirujuk oleh izin ini. Kolom tidak ditetapkan jika jenis penerima izin adalah EVERYONE.

role enum (Role)

Wajib. Peran yang diberikan oleh izin ini.

Contoh permintaan

Python

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

Isi respons

Jika berhasil, isi respons memuat instance Permission yang baru dibuat.

Metode: tunedModels.permissions.get

Mendapatkan informasi tentang Izin tertentu.

Endpoint

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

Parameter jalur

name string

Wajib. Nama resource izin.

Format: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Formatnya adalah tunedModels/{tunedmodel}/permissions/{permission}.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

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

Isi respons

Jika berhasil, isi respons memuat instance Permission.

Metode: tunedModels.permissions.list

Mencantumkan izin untuk resource tertentu.

Endpoint

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

Parameter jalur

parent string

Wajib. Resource induk izin. Format: tunedModels/{tunedModel} corpora/{corpus} Formatnya adalah tunedModels/{tunedmodel}.

Parameter kueri

pageSize integer

Opsional. Jumlah maksimum Permission yang akan ditampilkan (per halaman). Layanan mungkin menampilkan lebih sedikit izin.

Jika tidak ditentukan, paling banyak 10 izin akan ditampilkan. Metode ini menampilkan maksimal 1.000 izin per halaman, meskipun Anda meneruskan pageSize yang lebih besar.

pageToken string

Opsional. Token halaman, diterima dari panggilan permissions.list sebelumnya.

Berikan pageToken yang ditampilkan oleh satu permintaan sebagai argumen ke permintaan berikutnya untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk permissions.list harus sesuai dengan panggilan yang menyediakan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

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

Isi respons

Jika berhasil, isi respons memuat instance ListPermissionsResponse.

Metode: tunedModels.permissions.patch

Memperbarui izin.

Endpoint

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

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

Parameter jalur

permission.name string

Hanya output. ID. Nama izin. Nama unik akan dibuat saat pembuatan. Contoh: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Hanya output. Formatnya adalah tunedModels/{tunedmodel}/permissions/{permission}.

Parameter kueri

updateMask string (FieldMask format)

Wajib. Daftar kolom yang akan diperbarui. Yang diterima: - role (kolom Permission.role)

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi permintaan

Isi permintaan memuat instance Permission.

Kolom
role enum (Role)

Wajib. Peran yang diberikan oleh izin ini.

Contoh permintaan

Python

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

Isi respons

Jika berhasil, isi respons memuat instance Permission.

Metode: tunedModels.permissions.delete

Menghapus izin.

Endpoint

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

Parameter jalur

name string

Wajib. Nama resource izin. Format: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Formatnya adalah tunedModels/{tunedmodel}/permissions/{permission}.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

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

Isi respons

Jika berhasil, isi respons adalah objek JSON kosong.

Metode: tunedModels.transferOwnership

Mentransfer kepemilikan model yang di-tune. Ini adalah satu-satunya cara untuk mengubah kepemilikan model yang di-tuning. Pemilik saat ini akan didowngrade ke peran penulis.

Endpoint

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

Parameter jalur

name string

Wajib. Nama resource model yang disesuaikan untuk mentransfer kepemilikan.

Format: tunedModels/my-model-id Formatnya adalah tunedModels/{tunedmodel}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Kolom
emailAddress string

Wajib. Alamat email pengguna yang menjadi tujuan transfer model yang di-tune.

Isi respons

Jika berhasil, isi respons akan kosong.

REST Resource: tunedModels.permissions

Resource: Izin

Resource izin memberikan akses pengguna, grup, atau seluruh dunia ke resource PaLM API (misalnya, model yang di-tune, korpus).

Peran adalah kumpulan operasi yang diizinkan yang memungkinkan pengguna melakukan tindakan tertentu pada resource PaLM API. Agar tersedia untuk pengguna, grup, atau akun layanan, Anda perlu menetapkan peran. Saat menetapkan peran, Anda memberikan izin yang dimiliki oleh peran tersebut.

Ada tiga peran konsentris. Setiap peran adalah superset operasi yang diizinkan dari peran sebelumnya:

  • pembaca dapat menggunakan resource (misalnya, model yang disesuaikan, korpus) untuk inferensi
  • penulis memiliki izin pembaca dan juga dapat mengedit dan membagikan
  • pemilik memiliki izin penulis dan juga dapat menghapus
Kolom
name string

Hanya output. ID. Nama izin. Nama unik akan dibuat saat pembuatan. Contoh: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Hanya output.

granteeType enum (GranteeType)

Opsional. Tidak dapat diubah. Jenis penerima hibah.

emailAddress string

Opsional. Tidak dapat diubah. Alamat email pengguna atau grup yang dirujuk oleh izin ini. Kolom tidak ditetapkan jika jenis penerima izin adalah EVERYONE.

role enum (Role)

Wajib. Peran yang diberikan oleh izin ini.

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

ListPermissionsResponse

Respons dari ListPermissions yang berisi daftar izin yang di-pagination.

Kolom
permissions[] object (Permission)

Izin yang dikembalikan.

nextPageToken string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya.

Jika kolom ini dihilangkan, tidak ada lagi halaman.

Representasi JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}