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 untuk 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 sama dengan permissionId di resource Tentang dan File. Saat membuat permintaan drive.permissions.insert, hanya satu kolom id atau value yang harus ditentukan, kecuali jika jenis izinnya adalah anyone, dalam hal ini id dan value 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, hal-hal 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 pada 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 kolom id atau value yang harus ditentukan, kecuali jika jenis izinnya adalah anyone, dalam hal ini id dan value diabaikan.

kind

string

Hanya output. Ini selalu drive#permission.

emailAddress

string

Hanya output. Alamat email pengguna atau grup yang dirujuk oleh izin ini. Ini adalah kolom khusus output yang ada jika jenis izinnya adalah user atau group.

domain

string

Hanya output. Nama domain entitas yang dirujuk oleh izin ini. Ini adalah kolom khusus output yang ada jika jenis izinnya adalah user, group, atau domain.

etag

string

Hanya output. ETag izin.

permissionDetails[]

object

Hanya output. Detail apakah izin di item drive bersama ini diwariskan atau langsung pada 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 mungkin dilakukan saat ini:

  • file
  • member
permissionDetails[].role

string

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

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

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

permissionDetails[].inheritedFrom

string

Hanya output. ID item tempat izin ini diwarisi. Kolom ini hanya menampilkan output.

permissionDetails[].inherited

boolean

Hanya output. Apakah izin ini diwarisi atau tidak. Kolom ini selalu diisi. Kolom ini hanya menampilkan output.

expirationDate

string

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

  • Izin ini hanya dapat ditetapkan berdasarkan izin pengguna dan grup
  • Tanggal harus berada di masa mendatang
  • Tanggal tidak boleh lebih dari setahun yang akan datang
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. Bidang ini hanya berkaitan dengan izin akses pengguna dan grup.

view

string

Menunjukkan tampilan untuk izin ini. Hanya diisi untuk izin yang dimiliki tampilan. published adalah satu-satunya nilai yang didukung.

pendingOwner

boolean

Apakah akun yang terkait dengan izin ini adalah 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.