Resource: Izin
Izin untuk file. Izin memberikan akses ke file atau hierarki folder kepada pengguna, grup, domain, atau semua orang.
Secara default, permintaan izin hanya menampilkan sebagian kolom. Jenis, ID, jenis, dan peran izin selalu ditampilkan. Untuk mengambil kolom tertentu, lihat https://developers.google.com/drive/api/guides/fields-parameter.
Beberapa metode resource (seperti permissions.update
) memerlukan permissionId
. Gunakan metode permissions.list
untuk mengambil ID file, folder, atau drive bersama.
Representasi JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Kolom | |
---|---|
id |
Hanya output. ID izin ini. Ini adalah ID unik untuk penerima hibah, dan dipublikasikan di Resource pengguna sebagai |
displayName |
Hanya output. Nama "unik" dari nilai izin. Berikut adalah daftar contoh untuk setiap jenis izin:
|
type |
Jenis penerima. Nilai yang valid adalah:
Saat membuat izin, jika |
kind |
Hanya output. Mengidentifikasi jenis resource ini. Nilai: string tetap |
permissionDetails[] |
Hanya output. Detail tentang apakah izin pada item drive bersama ini diwariskan atau langsung pada item ini. Ini adalah kolom khusus output yang hanya ada untuk item drive bersama. |
permissionDetails[].permissionType |
Hanya output. Jenis izin untuk pengguna ini. Meskipun nilai baru dapat ditambahkan pada masa mendatang, nilai berikut saat ini dapat digunakan:
|
permissionDetails[].inheritedFrom |
Hanya output. ID item tempat izin ini diwarisi. Ini adalah kolom khusus output. |
permissionDetails[].role |
Hanya output. Peran utama untuk pengguna ini. Meskipun nilai baru dapat ditambahkan di masa mendatang, berikut adalah nilai yang saat ini memungkinkan:
|
permissionDetails[].inherited |
Hanya output. Apakah izin ini diwariskan. Kolom ini selalu diisi. Ini adalah kolom khusus output. |
photoLink |
Hanya output. Link ke foto profil pengguna, jika tersedia. |
emailAddress |
Alamat email pengguna atau grup yang dirujuk oleh izin ini. |
role |
Peran yang diberikan oleh izin ini. Meskipun nilai baru mungkin didukung pada masa mendatang, nilai berikut saat ini diizinkan:
|
allowFileDiscovery |
Apakah izin tersebut memungkinkan file ditemukan melalui penelusuran. Hal ini hanya berlaku untuk izin jenis |
domain |
Domain yang dirujuk oleh izin ini. |
expirationTime |
Waktu saat izin ini akan berakhir masa berlakunya (waktu tanggal RFC 3339). Waktu habis masa berlaku memiliki batasan berikut:
|
teamDrivePermissionDetails[] |
Hanya output. Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
teamDrivePermissionDetails[] |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
teamDrivePermissionDetails[] |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
teamDrivePermissionDetails[] |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
teamDrivePermissionDetails[] |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
deleted |
Hanya output. Apakah akun yang terkait dengan izin ini telah dihapus. Kolom ini hanya berkaitan dengan izin pengguna dan grup. |
view |
Menunjukkan tampilan untuk izin ini. Hanya diisi untuk izin yang termasuk dalam tampilan. 'published' adalah satu-satunya nilai yang didukung. |
pendingOwner |
Apakah akun yang terkait dengan izin ini adalah pemilik yang tertunda. Hanya diisi untuk izin jenis |
Metode |
|
---|---|
|
Membuat izin untuk file atau drive bersama. |
|
Menghapus izin. |
|
Mendapatkan izin berdasarkan ID. |
|
Mencantumkan izin file atau drive bersama. |
|
Memperbarui izin dengan semantik patch. |