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,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
Kolom
id

string

ID pengguna yang dirujuk oleh izin ini, dan identik dengan permissionId di resource Tentang dan File. Saat membuat permintaan drive.permissions.insert, hanya satu dari kolom id atau value yang harus ditentukan kecuali jika jenis izinnya adalah anyone, dalam hal ini id dan value akan diabaikan.

name

string

Hanya output. Nama untuk izin ini.

type

string

Jenis akun. Nilai yang diperbolehkan adalah:

  • user
  • group
  • domain
  • anyone
role

string

Peran utama untuk pengguna ini. Meskipun nilai baru mungkin didukung di masa mendatang, nilai berikut saat ini diizinkan:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

Peran tambahan untuk pengguna ini. Saat ini hanya commenter yang diizinkan, meskipun lebih banyak lagi mungkin didukung di masa mendatang.

authKey
(deprecated)

string

Hanya output. Tidak digunakan lagi.

value

string

Alamat email atau nama domain untuk entitas. Ini digunakan selama penyisipan dan tidak diisi dalam respons. Saat membuat permintaan drive.permissions.insert, hanya satu dari kolom id atau value yang harus ditentukan kecuali jika jenis izinnya adalah anyone, dalam hal ini id dan value akan diabaikan.

kind

string

Hanya output. Nilainya selalu drive#permission.

emailAddress

string

Hanya output. Alamat email pengguna atau grup yang dirujuk oleh izin ini. Kolom ini hanya merupakan output yang ada jika jenis izinnya adalah user atau group.

domain

string

Hanya output. Nama domain entitas yang dirujuk oleh izin ini. Kolom ini hanya merupakan output yang ada ketika jenis izinnya adalah user, group, atau domain.

etag

string

Hanya output. ETag izin.

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[].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
  • reader
permissionDetails[].additionalRoles[]

string

Hanya output. Peran tambahan untuk pengguna ini. Saat ini, hanya commenter yang tersedia, meskipun lebih banyak lagi mungkin didukung di masa mendatang.

permissionDetails[].inheritedFrom

string

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

permissionDetails[].inherited

boolean

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

expirationDate

string

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

  • Hanya dapat ditetapkan berdasarkan izin pengguna dan grup
  • Tanggal harus di masa mendatang
  • Tanggal tidak boleh lebih dari setahun ke depan
teamDrivePermissionDetails[]
(deprecated)

object

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

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Hanya output. Tidak digunakan lagi: 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. published 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

delete

Menghapus izin dari file atau drive bersama.

get

Mendapatkan izin berdasarkan ID.

getIdForEmail

Menampilkan ID izin untuk alamat email.

insert

Menyisipkan izin untuk file atau drive bersama.

list

Mencantumkan izin file atau drive bersama.

patch

Memperbarui izin menggunakan semantik patch.

update

Memperbarui izin.