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. Layanan dapat menampilkan izin yang lebih sedikit dari nilai ini.

Jika tidak ditentukan, paling banyak 100 izin akan ditampilkan untuk drive bersama, dan seluruh daftar izin untuk drive non-bersama.

Nilai maksimum adalah 100; nilai di atas 100 akan dikonversi menjadi 100.
pageToken

string

Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Token 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

Mengirim permintaan sebagai administrator domain.

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

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

Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
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 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 dihapus, dan penomoran halaman harus dimulai ulang dari halaman hasil pertama. 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.