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 maksimum izin yang akan ditampilkan per halaman. Jika tidak ditetapkan untuk file di drive bersama, paling banyak 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. Parameter ini harus disetel ke nilai 'nextPageToken' dari respons sebelumnya.
supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.
supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Gunakan supportsAllDrives sebagai gantinya.
useDomainAdminAccess

boolean

Mengirim permintaan sebagai administrator domain; jika disetel ke benar (true), maka pemohon akan diberi akses jika parameter ID file merujuk ke drive bersama dan pemohon adalah administrator domain tempat drive bersama berada.
includePermissionsForView

string

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar izin untuk file.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Permission)

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

string

Token halaman untuk halaman izin berikutnya. Kolom ini tidak akan ada jika akhir daftar izin telah tercapai. Jika token ditolak karena alasan apa pun, token tersebut harus dibuang, 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 diharapkan mungkin berbeda.
kind

string

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

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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.