Method: permissions.list

Mencantumkan izin file atau drive bersama. Untuk mengetahui informasi selengkapnya, lihat Membagikan file, folder, dan drive.

Permintaan HTTP

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

URL ini 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. 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: Gunakan supportsAllDrives sebagai gantinya.
useDomainAdminAccess

boolean

Kirim permintaan sebagai administrator domain.

Jika disetel ke true, dan jika kondisi tambahan berikut terpenuhi, pemohon akan diberi akses:

  1. Parameter ID file merujuk ke drive bersama.
  2. Peminta adalah administrator domain tempat drive bersama berada.

Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
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 valid 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.