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 izin maksimum yang ditampilkan per halaman. Jika tidak ditetapkan untuk file di drive bersama, maksimal 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. Respons ini harus ditetapkan ke nilai nextPageToken dari respons sebelumnya.

supportsAllDrives

boolean

Apakah aplikasi permintaan mendukung Drive Saya dan drive bersama.

supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.

useDomainAdminAccess

boolean

Memberikan 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 yang mencakup drive bersama tersebut.

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

Ini 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.meet.readonly
  • 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.