- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Cobalah!
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 |
ID file atau drive bersama. |
Parameter kueri
Parameter | |
---|---|
pageSize |
Jumlah maksimum izin yang akan ditampilkan per halaman. Jika file di drive bersama tidak ditetapkan, maksimum 100 hasil akan ditampilkan. Jika tidak ditetapkan untuk file yang tidak ada di drive bersama, seluruh daftar akan ditampilkan. |
pageToken |
Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Nilai ini harus ditetapkan ke nilai 'nextPageToken' dari respons sebelumnya. |
supportsAllDrives |
Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama. |
supportsTeamDrives |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
useDomainAdminAccess |
Berikan 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 tempat drive bersama tersebut berada. |
includePermissionsForView |
Menentukan izin tampilan tambahan yang akan disertakan dalam respons. Hanya mendukung 'dipublikasikan'. |
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 ( |
Kolom | |
---|---|
nextPageToken |
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 valid selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang Anda harapkan mungkin berbeda. |
kind |
Mengidentifikasi jenis resource ini. Nilai: string tetap |
permissions[] |
Daftar izin. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman tambahan hasil 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.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.