Method: permissions.list

Mencantumkan izin file atau drive bersama.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file atau drive bersama.

Parameter kueri

Parameter
pageSize

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. Ini harus disetel 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 'dipublikasikan' didukung.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar izin untuk file.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      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. Token halaman biasanya berlaku selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang Anda harapkan mungkin berbeda.

kind

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#permissionList".

permissions[]

object (Permission)

Daftar izin. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman hasil tambahan harus diambil.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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.