REST Resource: permissions

Resource: Izin

Izin untuk file. Izin memberikan akses ke file atau hierarki folder kepada pengguna, grup, domain, atau semua orang.

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

Representasi JSON 
{
  "additionalRoles": [
    string
  ],
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "expirationDate": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
Kolom
additionalRoles[]

string

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

object

Hanya output. Detail apakah izin pada item ini diwarisi atau langsung pada item ini.
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[].role

string

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

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

string

Hanya output. Peran tambahan untuk pengguna ini. Saat ini hanya commenter yang dapat digunakan, meskipun lebih banyak mungkin didukung di masa mendatang.
permissionDetails[].inheritedFrom

string

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

boolean

Hanya output. Apakah izin ini diwarisi. Kolom ini selalu diisi.
teamDrivePermissionDetails[]
(deprecated)

object

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails sebagai gantinya.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails/permissionType sebagai gantinya.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails/role sebagai gantinya.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails/additionalRoles sebagai gantinya.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails/inheritedFrom sebagai gantinya.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Hanya output. Tidak digunakan lagi: Gunakan permissionDetails/inherited sebagai gantinya.
id

string

ID pengguna yang dirujuk oleh izin ini, dan identik dengan permissionId di resource Tentang dan File. Saat membuat permintaan drive.permissions.insert, tepat satu kolom id atau value harus ditentukan, kecuali jika jenis izinnya adalah anyone. Jika demikian, 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 pada masa mendatang, nilai berikut saat ini diizinkan:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
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, tepat satu kolom id atau value harus ditentukan, kecuali jika jenis izinnya adalah anyone. Jika demikian, id dan value akan diabaikan.
kind

string

Hanya output. Nilai 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.
expirationDate

string

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

  • Izin hanya dapat ditetapkan pada izin pengguna dan grup
  • Tanggal harus di masa mendatang
  • Tanggal 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 pengguna dan grup.
view

string

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

published

dan

metadata

adalah satu-satunya nilai yang didukung.

  • published

    : Peran izin adalah published_reader.

  • metadata

    : Item hanya terlihat oleh tampilan metadata karena item memiliki akses terbatas dan cakupan memiliki setidaknya akses baca ke induk. Catatan:

    metadata

    tampilan saat ini hanya didukung di folder.

pendingOwner

boolean

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

boolean

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

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.