Panduan ini berisi tugas terkait pengelolaan drive bersama, seperti membuat drive bersama dan mengelola anggota serta izin, menggunakan Google Drive API.
Untuk mengetahui informasi selengkapnya tentang batas folder drive bersama, lihat Batas folder.
Membuat drive bersama
Untuk membuat drive bersama, gunakan metode
drives.create
.
Java
Python
Node.js
PHP
.NET
Panggilan ke metode drives.create
bersifat
idempoten.
Parameter requestId
mengidentifikasi upaya logis untuk membuat drive bersama. Jika waktu tunggu permintaan habis atau menampilkan error backend yang tidak dapat ditentukan, permintaan yang sama dapat diulang. requestId
dan isi permintaan harus tetap sama.
Jika drive bersama berhasil dibuat pada permintaan sebelumnya atau karena percobaan ulang, respons normal akan ditampilkan. Terkadang, seperti setelah jangka waktu yang lama atau jika isi permintaan telah berubah, error 409
mungkin ditampilkan yang menunjukkan bahwa requestId
harus dibatalkan.
Menambahkan atau menghapus anggota drive bersama
Tambahkan atau hapus anggota drive bersama menggunakan resource
permissions
.
Untuk menambahkan anggota, buat izin di drive bersama. Metode izin juga dapat digunakan pada setiap file dalam drive bersama untuk memberikan hak istimewa tambahan kepada anggota atau mengizinkan pengguna yang bukan anggota berkolaborasi pada item tertentu.
Untuk mengetahui informasi selengkapnya dan kode contoh, lihat Membagikan file, folder, dan drive.
Menghapus drive bersama
Gunakan metode drives.delete
untuk menghapus
drive bersama. Semua konten di drive bersama harus dipindahkan ke sampah atau dihapus sebelum drive bersama dihapus.
Mengelola drive bersama untuk administrator domain
Terapkan parameter useDomainAdminAccess
dengan resource drives
dan permissions
untuk mengelola drive bersama di seluruh organisasi.
Pengguna yang memanggil metode ini dengan useDomainAdminAccess=true
harus memiliki
hak istimewa administrator
Drive and Docs
.
Administrator dapat menelusuri drive bersama atau memperbarui izin untuk drive bersama yang dimiliki oleh organisasi mereka, terlepas dari keanggotaan administrator di drive bersama tertentu.
Memulihkan drive bersama yang tidak memiliki penyelenggara
Contoh berikut menunjukkan cara menggunakan resource ini untuk memulihkan drive bersama yang tidak lagi memiliki penyelenggara.
Java
Python
Node.js
PHP
.NET
Mencegah pengguna mendownload, mencetak, atau menyalin file Anda
Anda dapat membatasi cara pengguna mendownload, mencetak, dan menyalin file dalam drive bersama.
Untuk menentukan apakah pengguna dapat mengubah batasan download yang diterapkan penyelenggara
pada drive bersama, periksa kolom boolean capabilities.canChangeDownloadRestriction
. Jika
capabilities.canChangeDownloadRestriction
disetel ke true
, pembatasan
download dapat diterapkan ke drive bersama. Untuk mengetahui informasi selengkapnya, lihat
Memahami kemampuan file.
Resource drives
berisi kumpulan
kolom restrictions
boolean yang digunakan untuk menunjukkan apakah tindakan dapat dilakukan di drive bersama.
Pembatasan berlaku untuk drive bersama atau item di dalam drive bersama.
Batasan dapat ditetapkan menggunakan metode drives.update
.
Untuk menerapkan pembatasan download ke drive bersama, pengelola drive bersama dapat menyetel kolom restrictions.downloadRestriction
resource drives
menggunakan objek DownloadRestriction
.
Menetapkan kolom boolean restrictedForReaders
ke true
menyatakan bahwa download dan penyalinan dibatasi untuk pembaca. Menetapkan kolom boolean restrictedForWriters
ke true
menyatakan bahwa download dan penyalinan dibatasi untuk
penulis. Perhatikan bahwa jika kolom restrictedForWriters
adalah true
, download dan
penyalinan juga dibatasi untuk pembaca. Demikian pula, menyetel restrictedForWriters
ke true
dan restrictedForReaders
ke false
sama dengan menyetel
restrictedForWriters
dan restrictedForReaders
ke true
.
Kompatibilitas mundur
Dengan diperkenalkannya objek DownloadRestriction
, fungsi kolom boolean
restrictions.copyRequiresWriterPermission
telah diperbarui.
Sekarang, menyetel restrictions.copyRequiresWriterPermission
ke true
akan memperbarui kolom boolean
restrictedForReaders
dari objek DownloadRestriction
ke true
untuk menyatakan bahwa download dan penyalinan dibatasi untuk pembaca.
Menetapkan kolom copyRequiresWriterPermission
ke false
akan memperbarui kolom
restrictedForWriters
dan restrictedForReaders
ke false
. Artinya, setelan pembatasan download atau penyalinan dihapus untuk semua pengguna.
Kolom yang mengontrol fitur download, cetak, dan salin
Tabel berikut mencantumkan kolom resource drives
yang memengaruhi fungsi download, cetak, dan salin:
Kolom | Deskripsi | Versi |
---|---|---|
capabilities.canCopy |
Apakah pengguna saat ini dapat menyalin file di drive bersama. | v2 & v3 |
capabilities.canDownload |
Apakah pengguna saat ini dapat mendownload file di drive bersama. | v2 & v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Apakah pengguna saat ini dapat mengubah copyRequiresWriterPermission pembatasan drive bersama. |
v2 & v3 |
capabilities.canResetDriveRestrictions |
Apakah pengguna saat ini dapat mereset pembatasan drive bersama ke setelan default. | v2 & v3 |
capabilities.canChangeDownloadRestriction |
Apakah pengguna saat ini dapat mengubah pembatasan download drive bersama. | Khusus v3 |
restrictions.copyRequiresWriterPermission |
Apakah opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama dinonaktifkan untuk pembaca dan pengomentar. Saat true , kolom dengan nama serupa akan disetel ke true untuk file apa pun di dalam drive bersama ini. |
v2 & v3 |
restrictions.downloadRestriction |
Pembatasan download yang diterapkan oleh pengelola drive bersama. | Khusus v3 |
Batas folder
Folder drive bersama memiliki beberapa batas penyimpanan. Untuk mengetahui informasinya, lihat Batas drive bersama di Google Drive.
Batas item
Setiap folder di drive bersama pengguna memiliki batas 500.000 item, termasuk file, folder, dan pintasan.
Saat batas tercapai, drive bersama tidak dapat lagi menerima item. Untuk menerima file lagi, pengguna harus menghapus item secara permanen dari folder. Perhatikan bahwa item di sampah dihitung dalam batas, tetapi item yang dihapus secara permanen tidak dihitung. Untuk mengetahui informasi selengkapnya, lihat Memindahkan file dan folder ke Sampah atau menghapusnya.
Batas kedalaman folder
Folder di drive bersama tidak boleh berisi lebih dari 100 tingkat folder bertingkat. Artinya, folder turunan tidak dapat disimpan di bawah folder yang memiliki kedalaman lebih dari 99 tingkat. Batasan ini hanya berlaku untuk folder turunan.
Upaya untuk menambahkan lebih dari 100 tingkat folder akan menampilkan respons kode status HTTP
teamDriveHierarchyTooDeep
.