Method: permissions.create

Membuat 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/v3/files/{fileId}/permissions

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file atau drive bersama.

Parameter kueri

Parameter
emailMessage

string

Pesan kustom teks biasa yang akan 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 berada di drive bersama dan permintaan mencoba mentransfer kepemilikan item. Jika ditetapkan ke true, item akan dipindahkan ke folder root Drive Saya pemilik baru dan semua induk sebelumnya akan dihapus. Jika ditetapkan ke false, induk tidak akan diubah.

sendNotificationEmail

boolean

Apakah akan mengirim email notifikasi saat berbagi dengan pengguna atau grup. Setelan ini ditetapkan secara default ke benar (true) untuk pengguna dan grup, dan tidak diizinkan untuk permintaan lain. Fitur ini tidak boleh dinonaktifkan untuk transfer kepemilikan.

supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.

supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Gunakan supportsAllDrives sebagai gantinya.

transferOwnership

boolean

Apakah akan mentransfer kepemilikan ke pengguna yang ditentukan dan mendowngrade pemilik saat ini menjadi penulis. Parameter ini diperlukan sebagai konfirmasi efek samping.

useDomainAdminAccess

boolean

Mengajukan permintaan sebagai administrator domain; jika disetel ke benar, pemohon akan diberi akses jika parameter ID file merujuk ke drive bersama dan pemohon adalah administrator domain tempat drive bersama 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/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.