REST Resource: permissions

Resource: Izin

Izin akses untuk file. Izin memberikan akses kepada pengguna, grup, domain, atau dunia ke file atau hierarki folder.

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

string

Hanya output. ID izin ini. Ini adalah ID unik untuk penerima hibah, dan dipublikasikan di Referensi pengguna sebagai permissionId. ID harus diperlakukan sebagai nilai buram.

displayName

string

Hanya output. Nama "canggih" dari nilai izin. Berikut adalah daftar contoh untuk setiap jenis izin:

  • user - Nama lengkap pengguna, seperti yang didefinisikan untuk Akun Google mereka, seperti "Joe Smith".
  • group - Nama Grup Google, seperti "Administrator Perusahaan."
  • domain - Nama domain string, seperti "thecompany.com".
  • anyone - Tidak ada displayName.
type

string

Jenis penerima hibah. Nilai yang valid adalah:

  • user
  • group
  • domain
  • anyone

Saat membuat izin, jika type adalah user atau group, Anda harus memberikan emailAddress untuk pengguna atau grup. Jika type adalah domain, Anda harus memberikan domain. Tidak ada informasi tambahan yang diperlukan untuk jenis anyone.

kind

string

Hanya output. Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#permission".

permissionDetails[]

object

Hanya output. Detail tentang apakah izin di item drive bersama ini diwariskan atau langsung di item ini. Ini adalah kolom khusus output yang hanya ada untuk item drive bersama.

permissionDetails[].permissionType

string

Hanya output. Jenis izin untuk pengguna ini. Meskipun nilai baru dapat ditambahkan di masa mendatang, hal berikut saat ini mungkin terjadi:

  • file
  • member
permissionDetails[].inheritedFrom

string

Hanya output. ID item yang mewariskan izin ini. Ini adalah kolom khusus output.

permissionDetails[].role

string

Hanya output. Peran utama untuk pengguna ini. Meskipun nilai baru dapat ditambahkan di masa mendatang, hal berikut saat ini mungkin dilakukan:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

Hanya output. Apakah izin ini diwariskan. Kolom ini selalu terisi. Ini adalah kolom khusus output.

emailAddress

string

Alamat email pengguna atau grup yang dirujuk oleh izin ini.

role

string

Peran yang diberikan oleh izin ini. Meskipun nilai baru mungkin didukung di masa mendatang, nilai berikut saat ini diizinkan:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

Apakah izin tersebut memungkinkan file ditemukan melalui penelusuran. Ini hanya berlaku untuk izin jenis domain atau anyone.

domain

string

Domain yang dirujuk oleh izin ini.

expirationTime

string

Waktu izin ini akan berakhir (tanggal-waktu RFC 3339). Waktu habis masa berlaku memiliki batasan berikut:

  • Izin tersebut hanya dapat ditetapkan berdasarkan izin pengguna dan grup.
  • Waktunya harus di masa mendatang.
  • Waktunya tidak boleh lebih dari satu tahun ke depan.
teamDrivePermissionDetails[]
(deprecated)

object

Hanya output. Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan permissionDetails/inherited.

deleted

boolean

Hanya output. Apakah akun yang terkait dengan izin ini telah dihapus. Kolom ini hanya berkaitan dengan izin pengguna dan grup.

view

string

Menunjukkan tampilan untuk izin ini. Hanya diisi untuk izin yang termasuk dalam tampilan. 'dipublikasikan' adalah satu-satunya nilai yang didukung.

pendingOwner

boolean

Apakah akun yang dikaitkan dengan izin ini merupakan pemilik yang menunggu keputusan. Hanya diisi untuk izin jenis user bagi file yang tidak ada di drive bersama.

Metode

create

Membuat izin untuk file atau drive bersama.

delete

Menghapus izin.

get

Mendapatkan izin berdasarkan ID.

list

Mencantumkan izin file atau drive bersama.

update

Memperbarui izin dengan semantik patch.