Peran adalah kumpulan izin yang memungkinkan pengguna melakukan tindakan tertentu pada resource Google Drive. Agar izin tersedia untuk pengguna, grup, dan akun layanan, Anda perlu menetapkan peran. Saat Anda menetapkan peran, Anda memberikan semua izin yang dimiliki oleh peran tersebut.
Setiap izin di Google Drive API memiliki peran yang menentukan tindakan yang dapat dilakukan pengguna terhadap file, folder, atau drive bersama. Untuk mengetahui informasi selengkapnya, lihat Skenario untuk berbagi resource Drive.
Operasi untuk file dan folder
Tabel berikut menunjukkan operasi yang dapat dilakukan pengguna untuk setiap peran, jika peran tidak dibatasi pada tampilan. Untuk mengetahui informasi selengkapnya, lihat Tampilan.
| Operasi yang diizinkan | owner |
organizer |
fileOrganizer |
writer |
commenter |
reader |
|---|---|---|---|---|---|---|
| Membaca metadata (seperti nama, deskripsi) file atau folder | ||||||
| Membaca konten file | ||||||
| Membaca daftar item dalam folder | ||||||
| Menambahkan komentar ke file | ||||||
| Mengubah metadata file atau folder | ||||||
| Ubah konten file | ||||||
| Mengakses revisi historis | ||||||
| Menambahkan item ke folder | ||||||
| Menghapus item dari folder Drive Saya | ||||||
| Membagikan item dari folder Drive Saya | ||||||
| Dapat mengakses izin file yang mendetail | ||||||
| Memindahkan item ke sampah | ||||||
| Memulihkan item dari sampah | ||||||
| Mengosongkan sampah | ||||||
| Menghapus file atau folder | ||||||
| Menambahkan batasan konten ke file di folder Drive Saya | ||||||
| Menetapkan atau membatalkan setelan akses terbatas di folder Drive Saya |
Operasi khusus untuk drive bersama
Tabel berikut menunjukkan operasi khusus drive bersama yang dapat dilakukan pengguna untuk setiap peran, jika peran tidak dibatasi pada tampilan. Untuk mengetahui informasi selengkapnya, lihat Tampilan.
| Operasi yang diizinkan | owner |
organizer |
fileOrganizer |
writer |
commenter |
reader |
|---|---|---|---|---|---|---|
| Membagikan item drive bersama | ||||||
| Menambahkan file ke drive bersama | ||||||
| Mengubah metadata drive bersama | ||||||
| Menambahkan anggota drive bersama | ||||||
| Mengatur ulang item dalam drive bersama [1] | ||||||
| Memindahkan item ke luar drive bersama [2] | ||||||
| Menghapus item di drive bersama [2] | ||||||
| Menghapus drive bersama yang kosong | ||||||
| Menambahkan pembatasan konten ke file di drive bersama | ||||||
| Menetapkan atau membatalkan setelan akses terbatas di folder drive bersama |
Korelasi antara peran Drive API dan UI Drive
Drive API dan UI Drive menggunakan sistem izin dasar yang sama. Namun, nama perannya sedikit berbeda di antara keduanya.
Tabel berikut menunjukkan korespondensi peran untuk file dan folder di Drive Saya.
| Peran API Drive | Peran UI Drive | Deskripsi |
|---|---|---|
owner |
Pemilik | Memberikan kontrol penuh atas file atau folder. |
writer |
Editor | Memberikan kemampuan untuk melihat file, menambahkan komentar, dan mengedit file. Untuk folder, dapat menambahkan, mengedit, dan menghapus file atau subfolder dalam folder tersebut. |
commenter |
Pemberi komentar | Memberikan kemampuan untuk melihat file dan menambahkan komentar. |
reader |
Pelihat | Memberikan kemampuan untuk melihat file. |
Tabel berikut menunjukkan kesesuaian peran untuk file dan folder di drive bersama.
| Peran API Drive | Peran UI Drive | Deskripsi |
|---|---|---|
organizer |
Pengelola | Memberikan kemampuan untuk mengelola file, folder, pengguna, dan setelan. |
fileOrganizer |
Content Manager | Memberikan kemampuan untuk berkontribusi dan mengelola konten. Peran default untuk anggota baru. |
writer |
Kontributor | Memberikan kemampuan untuk melihat file, menambahkan komentar, dan mengedit file. Juga dapat membuat file dalam drive bersama. |
commenter |
Pemberi komentar | Memberikan kemampuan untuk melihat file dan menambahkan komentar. |
reader |
Pelihat | Memberikan kemampuan untuk melihat file. |
Penayangan
Izin dapat dibatasi untuk
view, dalam hal ini
peran hanya berlaku untuk tampilan tertentu tersebut.
Izin dengan view=published dan role=reader memberikan akses reader ke tampilan file yang dipublikasikan, tetapi tidak memberikan akses reader ke file.
Izin dengan view=metadata dan role=reader memberikan akses reader ke metadata folder, tetapi tidak memberikan akses ke konten folder.
Sebaliknya, izin apa pun yang tidak dibatasi untuk tampilan tertentu, memberikan akses reader ke tampilan file yang dipublikasikan.