Method: permissions.create

Membuat izin untuk file atau drive bersama. Untuk mengetahui informasi selengkapnya, lihat Membagikan file, folder, dan drive.

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

Permintaan HTTP

POST 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
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 berlaku jika item tidak berada di drive bersama dan permintaan mencoba mentransfer kepemilikan item. Jika disetel ke true, item akan dipindahkan ke folder root Drive Saya pemilik baru dan semua folder induk sebelumnya akan dihapus. Jika disetel ke false, orang tua tidak akan diubah.
sendNotificationEmail

boolean

Apakah akan mengirim email notifikasi saat berbagi ke pengguna atau grup. Nilai defaultnya adalah true untuk pengguna dan grup, dan tidak diizinkan untuk permintaan lainnya. 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 kepada pengguna yang ditentukan dan mendowngrade pemilik saat ini menjadi penulis. Parameter ini diperlukan sebagai konfirmasi efek samping. Untuk mengetahui informasi selengkapnya, lihat Mentransfer kepemilikan file.
useDomainAdminAccess

boolean

Kirim permintaan sebagai administrator domain.

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

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

Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
enforceExpansiveAccess

boolean

Apakah permintaan harus menerapkan aturan akses yang luas.

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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.