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 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.

sendNotificationEmail

boolean

Apakah akan mengirim email notifikasi saat berbagi ke pengguna atau grup. Untuk pengguna dan grup, setelan defaultnya adalah benar, dan tidak diizinkan untuk permintaan lain. Kebijakan 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: Sebagai gantinya, gunakan supportsAllDrives.

transferOwnership

boolean

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

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/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.