REST Resource: permissions

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

string

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

displayName

string

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

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

string

Jenis penerima. 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 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

string

Hanya output. Jenis izin untuk pengguna ini. Meskipun nilai baru dapat ditambahkan pada masa mendatang, nilai berikut saat ini dapat digunakan:

  • file
  • member
permissionDetails[].inheritedFrom

string

Hanya output. ID item tempat izin ini diwarisi. Ini adalah kolom khusus output.

permissionDetails[].role

string

Hanya output. Peran utama untuk pengguna ini. Meskipun nilai baru dapat ditambahkan di masa mendatang, berikut adalah nilai yang saat ini memungkinkan:

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

boolean

Hanya output. Apakah izin ini diwariskan. Kolom ini selalu diisi. 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 pada masa mendatang, nilai berikut saat ini diizinkan:

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

boolean

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

domain

string

Domain yang dirujuk oleh izin ini.

expirationTime

string

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

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

object

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

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Tidak digunakan lagi: Khusus 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. 'published' adalah satu-satunya nilai yang didukung.

pendingOwner

boolean

Apakah akun yang terkait dengan izin ini adalah pemilik yang tertunda. Hanya diisi untuk izin jenis user untuk 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.