Method: permissions.insert

Menyisipkan izin untuk file atau drive bersama.

Peringatan: Operasi izin serentak pada file yang sama tidak didukung; hanya update terakhir yang diterapkan.

Permintaan HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID untuk file atau drive bersama.

Parameter kueri

Parameter
emailMessage

string

Pesan khusus teks biasa untuk disertakan dalam email notifikasi.

enforceSingleParent
(deprecated)

boolean

Tidak digunakan lagi: Lihat moveToNewOwnersRoot untuk mengetahui detailnya.

moveToNewOwnersRoot

boolean

Parameter ini hanya akan berlaku jika item tidak ada di drive bersama dan permintaan mencoba mentransfer kepemilikan item tersebut. Jika ditetapkan ke true, item akan dipindahkan ke folder root Drive Saya pemilik baru dan semua orang tua sebelumnya akan dihapus. Jika ditetapkan ke false, status induk tidak akan diubah.

sendNotificationEmails

boolean

Apakah akan mengirim email notifikasi saat berbagi ke pengguna atau grup. Parameter ini diabaikan dan email akan dikirim jika role adalah owner.

supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.

supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.

useDomainAdminAccess

boolean

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.

Isi permintaan

Isi permintaan memuat instance Permission.

Isi respons

Jika berhasil, isi respons memuat instance Permission yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.