REST Resource: labels.permissions
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: LabelPermission
Izin yang berlaku untuk prinsipal (pengguna, grup, audiens) pada label.
| Representasi JSON |
{
"name": string,
"email": string,
"role": enum (LabelRole),
// Union field principal can be only one of the following:
"person": string,
"group": string,
"audience": string
// End of list of possible types for union field principal.
} |
| Kolom |
name |
string
Nama resource izin ini.
|
email |
string
Menentukan alamat email untuk prinsipal pengguna atau grup. Tidak diisi untuk prinsipal audiens. Izin pengguna dan grup hanya dapat dimasukkan menggunakan alamat email. Pada permintaan pembaruan, jika alamat email ditentukan, tidak ada prinsipal yang boleh ditentukan.
|
role |
enum (LabelRole)
Peran yang harus dimiliki akun utama.
|
Kolom union principal. Akun utama yang izin ini berlaku untuknya. Harus berupa email, pengguna, grup, atau audiens. Contoh: * people/12345 * groups/45678 * audiences/default principal hanya dapat berupa salah satu dari berikut: |
person |
string
Nama resource orang.
|
group |
string
Nama resource grup.
|
audience |
string
Audiens yang akan diberi peran. Nilai ajaib audiences/default dapat digunakan untuk menerapkan peran ke audiens default dalam konteks organisasi yang memiliki label.
|
LabelRole
Peran bersifat konsentris dengan peran berikutnya.
| Enum |
LABEL_ROLE_UNSPECIFIED |
Peran tidak diketahui. |
READER |
Pembaca dapat membaca label dan metadata terkait yang diterapkan ke item Drive. |
APPLIER |
Penerap dapat menulis metadata terkait pada item Drive yang juga memiliki akses tulis. Menyiratkan READER. |
ORGANIZER |
Penyelenggara dapat menyematkan label ini di drive bersama yang mereka kelola dan menambahkan pendaftar baru ke label. |
EDITOR |
Editor dapat melakukan pembaruan apa pun, termasuk menghapus label yang juga menghapus metadata item Drive terkait. Menyiratkan APPLIER. |
Metode |
|
|
Menghapus izin label. |
|
|
Memperbarui izin label. |
|
|
Memperbarui izin label. |
|
|
Menghapus izin label. |
|
|
Mencantumkan izin label. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-05 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-05 UTC."],[],[],null,["# REST Resource: labels.permissions\n\n- [Resource: LabelPermission](#LabelPermission)\n - [JSON representation](#LabelPermission.SCHEMA_REPRESENTATION)\n - [LabelRole](#LabelPermission.LabelRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LabelPermission\n-------------------------\n\nThe permission that applies to a principal (user, group, audience) on a label.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"email\": string, \"role\": enum (/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission.LabelRole), // Union field `principal` can be only one of the following: \"person\": string, \"group\": string, \"audience\": string // End of list of possible types for union field `principal`. } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this permission. |\n| `email` | `string` Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified. |\n| `role` | `enum (`[LabelRole](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission.LabelRole)`)` The role the principal should have. |\n| Union field `principal`. The principal this permission applies to. Must be either an email, user, group, or audience. Example: \\* `people/12345` \\* `groups/45678` \\* `audiences/default` `principal` can be only one of the following: ||\n| `person` | `string` Person resource name. |\n| `group` | `string` Group resource name. |\n| `audience` | `string` Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label. |\n\n### LabelRole\n\nRoles are concentric with subsequent role.\n\n| Enums ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `LABEL_ROLE_UNSPECIFIED` | Unknown role. |\n| `READER` | A reader can read the label and associated metadata applied to Drive items. |\n| `APPLIER` | An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`. |\n| `ORGANIZER` | An organizer can pin this label in shared drives they manage and add new appliers to the label. |\n| `EDITOR` | Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|--------------------------------|\n| ### [batchDelete](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchDelete) | Deletes label permissions. |\n| ### [batchUpdate](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchUpdate) | Updates label permissions. |\n| ### [create](/workspace/drive/labels/reference/rest/v2/labels.permissions/create) | Updates a label's permissions. |\n| ### [delete](/workspace/drive/labels/reference/rest/v2/labels.permissions/delete) | Deletes a label's permission. |\n| ### [list](/workspace/drive/labels/reference/rest/v2/labels.permissions/list) | Lists a label's permissions. |"]]
