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,
  "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. "Cantik" nama 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 "perusahaan.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 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[].inheritedFrom

string

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

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

boolean

Hanya output. Apakah izin ini diwarisi atau tidak. Kolom ini selalu diisi. Kolom ini hanya menampilkan 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, hal-hal 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 habis masa berlaku izin ini (tanggal-waktu RFC 3339). Waktu habis masa berlaku memiliki batasan berikut:

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

view

string

Menunjukkan tampilan untuk izin ini. Hanya diisi untuk izin yang dimiliki tampilan. 'dipublikasikan' 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

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.