Method: permissions.list

Mencantumkan izin file atau drive bersama.

Permintaan HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID untuk file atau drive bersama.

Parameter kueri

Parameter
maxResults

integer

Jumlah maksimum izin yang akan ditampilkan per halaman. Jika file di drive bersama tidak ditetapkan, maksimum 100 hasil akan ditampilkan. Jika tidak ditetapkan untuk file yang tidak ada di drive bersama, seluruh daftar akan ditampilkan.

pageToken

string

Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Nilai ini harus ditetapkan ke nilai nextPageToken dari respons sebelumnya.

supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.

supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.

useDomainAdminAccess

boolean

Berikan permintaan sebagai administrator domain. Jika disetel ke benar (true), pemohon akan diberi akses jika parameter ID file merujuk ke drive bersama dan pemohon adalah administrator domain tempat drive bersama tersebut berada.

includePermissionsForView

string

Menentukan izin tampilan tambahan yang akan disertakan dalam respons. Hanya published yang didukung.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar izin yang terkait dengan file.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
Kolom
nextPageToken

string

Token halaman untuk halaman izin berikutnya. Kolom ini tidak akan ada jika akhir daftar izin telah tercapai. Jika ditolak karena alasan apa pun, token harus dihapus, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil.

kind

string

Nilainya selalu drive#permissionList.

etag

string

ETag daftar.

items[]

object (Permission)

Daftar izin.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.