REST Resource: permissions

Resource: Izin

Izin untuk file. Izin memberikan akses kepada pengguna, grup, domain, atau semua orang ke file atau hierarki folder. Untuk mengetahui informasi selengkapnya, lihat Membagikan file, folder, dan drive.

Secara default, permintaan izin hanya menampilkan subset kolom. Izin kind, ID, type, dan role selalu ditampilkan. Untuk mengambil kolom tertentu, lihat Menampilkan kolom tertentu.

Beberapa metode resource (seperti permissions.update) memerlukan permissionId. Gunakan metode permissions.list untuk mengambil ID file, folder, atau drive bersama.

Representasi JSON 
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
Kolom
permissionDetails[]

object

Hanya output. Detail apakah izin pada item ini diwarisi atau langsung ada pada item ini.
permissionDetails[].permissionType

string

Hanya output. Jenis izin untuk pengguna ini. Nilai yang didukung meliputi:

  • file
  • member
permissionDetails[].inheritedFrom

string

Hanya output. ID item tempat izin ini diwarisi. Kolom ini hanya diisi untuk item di drive bersama.
permissionDetails[].role

string

Hanya output. Peran utama untuk pengguna ini. Nilai yang didukung meliputi:

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

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.
permissionDetails[].inherited

boolean

Hanya output. Apakah izin ini diwarisi. Kolom ini selalu terisi. Kolom ini hanya output.
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.
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 "Dana A."
  • group - Nama Grup Google, seperti "Administrator Perusahaan".
  • domain - Nama domain string, seperti "cymbalgroup.com".
  • anyone - Tidak ada displayName.
type

string

Jenis penerima hibah. Nilai yang didukung meliputi:

  • 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. Jika type adalah anyone, tidak ada informasi tambahan yang diperlukan.
kind

string

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

string

Alamat email pengguna atau grup yang dirujuk oleh izin ini.
role

string

Peran yang diberikan oleh izin ini. Nilai yang didukung meliputi:

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

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.
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 saat izin ini akan berakhir (tanggal dan waktu RFC 3339). Waktu habis masa berlaku memiliki batasan berikut:

  • Waktu habis hanya dapat disetel pada izin pengguna dan grup.
  • Waktu harus di masa mendatang.
  • Waktu tidak boleh lebih dari satu tahun ke depan.
deleted

boolean

Hanya output. Apakah akun yang terkait dengan izin ini telah dihapus. Kolom ini hanya berkaitan dengan izin jenis user atau group.
view

string

Menunjukkan tampilan untuk izin ini. Hanya diisi untuk izin yang termasuk dalam tampilan.

Satu-satunya nilai yang didukung adalah published dan metadata:

  • published: Peran izin adalah publishedReader.
  • metadata: Item hanya terlihat di tampilan metadata karena item memiliki akses terbatas dan cakupan memiliki setidaknya akses baca ke induk. Tampilan metadata hanya didukung di folder.

Untuk mengetahui informasi selengkapnya, lihat Tampilan.
pendingOwner

boolean

Apakah akun yang terkait dengan izin ini adalah pemilik yang menunggu keputusan. Hanya diisi untuk izin jenis user untuk file yang tidak ada di drive bersama.
inheritedPermissionsDisabled

boolean

Jika true, hanya penyelenggara, pemilik, dan pengguna dengan izin yang ditambahkan langsung pada item yang dapat mengaksesnya.

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.