Panduan ini berisi tugas terkait pengelolaan drive bersama, seperti membuat drive bersama dan mengelola anggota serta izin, menggunakan Google Drive API.
Jika ingin menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menetapkan
fields parameter
sistem
dengan metode apa pun dari resource drives. Jika Anda tidak menentukan parameter fields, server akan menampilkan kumpulan kolom default yang khusus untuk metode tersebut. Misalnya, metode
list hanya menampilkan kolom kind, id,
dan name untuk setiap drive bersama. Untuk mengetahui informasi selengkapnya, lihat Menampilkan
kolom tertentu.
Untuk mempelajari batas folder drive bersama lebih lanjut, lihat Batas folder drive bersama limits.
Membuat drive bersama
Untuk membuat drive bersama, gunakan create
metode pada drives resource dengan
requestId parameter.
Parameter requestId mengidentifikasi upaya logis untuk pembuatan drive bersama yang idempoten. Jika permintaan mengalami error karena waktu tunggu habis atau menampilkan error backend yang tidak dapat ditentukan, permintaan yang sama dapat diulang dan tidak akan membuat duplikat. requestId dan isi permintaan harus tetap sama.
Contoh kode berikut menunjukkan cara membuat drive bersama:
Java
Python
Node.js
PHP
.NET
Panggilan ke metode create bersifat
idempoten.
Jika drive bersama berhasil dibuat pada permintaan sebelumnya atau karena percobaan ulang, metode ini akan menampilkan instance resource drives. Terkadang, seperti setelah waktu yang lama atau jika isi permintaan telah berubah, error 409 mungkin ditampilkan yang menunjukkan bahwa requestId harus dihapus.
Mendapatkan drive bersama
Untuk mendapatkan metadata drive bersama, gunakan metode
get pada resource drives dengan parameter jalur driveId. Jika tidak mengetahui ID drive, Anda dapat mencantumkan semua drive bersama menggunakan metode list.
Metode get menampilkan drive bersama sebagai instance resource drives.
Untuk mengeluarkan permintaan sebagai administrator domain, tetapkan parameter kueri useDomainAdminAccess ke true. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai
administrator domain.
Mencantumkan drive bersama
Untuk mencantumkan drive bersama pengguna, gunakan list
metode pada resource drives. Metode ini menampilkan daftar drive bersama.
Teruskan parameter kueri berikut untuk menyesuaikan penomoran halaman atau memfilter drive bersama:
pageSize: Jumlah maksimum drive bersama yang akan ditampilkan per halaman.pageToken: Token halaman, yang diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.q: String kueri untuk menelusuri drive bersama. Untuk mengetahui informasi selengkapnya, lihat Menelusuri drive bersama.useDomainAdminAccess: Tetapkan ketrueuntuk mengeluarkan permintaan sebagai administrator domain guna menampilkan semua drive bersama domain tempat pemohon adalah administrator. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
Mengupdate drive bersama
Untuk mengupdate metadata drive bersama, gunakan metode update pada resource
drives dengan parameter jalur driveId.
Metode ini menampilkan drive bersama sebagai instance resource drives.
Untuk mengeluarkan permintaan sebagai administrator domain, tetapkan parameter kueri useDomainAdminAccess ke true. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai
administrator domain.
Menyembunyikan dan menampilkan drive bersama
Untuk menyembunyikan drive bersama dari tampilan default, gunakan metode hide pada resource
drives dengan parameter driveId.
Saat drive bersama disembunyikan, Drive akan menandai resource drive bersama sebagai hidden=true. Drive bersama yang disembunyikan tidak akan muncul di UI Drive atau dalam daftar file yang ditampilkan.
Untuk memulihkan drive bersama ke tampilan default, gunakan metode unhide pada resource
drives dengan parameter driveId.
Kedua metode ini menampilkan drive bersama sebagai instance resource drives.
Menghapus drive bersama
Untuk menghapus drive bersama secara permanen, gunakan metode
delete pada resource drives dengan parameter driveId.
Sebelum menghapus drive bersama, semua konten di drive bersama harus dipindahkan ke sampah atau dihapus. Pengguna juga harus memiliki role=organizer di folder drive bersama. Untuk mengetahui informasi selengkapnya, lihat Memindahkan file dan folder ke sampah atau menghapusnya.
Teruskan parameter kueri berikut untuk memfilter drive bersama:
useDomainAdminAccess: Tetapkan ketrueuntuk mengeluarkan permintaan sebagai administrator domain guna menampilkan semua drive bersama domain tempat pemohon adalah administrator. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.allowItemDeletion: Tetapkan ketrueuntuk menghapus item dalam drive bersama. Hanya didukung jikauseDomainAdminAccessjuga ditetapkan ketrue.
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 non-anggota berkolaborasi pada item tertentu.
Untuk mengetahui informasi selengkapnya dan contoh kode, lihat Membagikan file, folder, dan drive.
Mengelola drive bersama sebagai 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
Drive and Docs administrator
hak istimewa.
Administrator dapat menelusuri drive
bersama atau memperbarui izin untuk drive
bersama yang dimiliki oleh organisasi mereka, terlepas dari keanggotaan
administrator di drive bersama tertentu.
Saat menggunakan akun layanan, Anda mungkin harus meniru administrator yang diautentikasi menggunakan peniruan akun layanan. Perhatikan bahwa akun layanan tidak termasuk dalam domain Google Workspace Anda, tidak seperti akun pengguna. Jika Anda membagikan aset Google Workspace, seperti dokumen atau acara, kepada seluruh domain Google Workspace Anda, aset tersebut tidak akan dibagikan dengan akun layanan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan akun layanan.
Memulihkan drive bersama yang tidak memiliki pengelola
Contoh kode berikut menunjukkan cara memulihkan drive bersama yang tidak lagi memiliki pengelola.
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 pembatasan download yang diterapkan pengelola drive bersama, centang kolom boolean capabilities.canChangeDownloadRestriction. Jika capabilities.canChangeDownloadRestriction ditetapkan ke true, pembatasan download dapat diterapkan ke drive bersama. Untuk mengetahui informasi selengkapnya, lihat
Memahami kemampuan file.
Resource drives berisi kumpulan
kolom boolean restrictions
yang digunakan untuk menunjukkan apakah tindakan dapat dilakukan di drive bersama.
Pembatasan berlaku untuk drive bersama atau item di dalam drive bersama.
Pembatasan dapat ditetapkan menggunakan metode drives.update.
Untuk menerapkan pembatasan download ke drive bersama, pengelola drive bersama dapat menetapkan
kolom restrictions.downloadRestriction dari resource drives
menggunakan objek
DownloadRestriction.
Menetapkan kolom boolean restrictedForReaders ke true menyatakan bahwa download dan salin dibatasi untuk pembaca. Menetapkan kolom boolean restrictedForWriters ke true menyatakan bahwa download dan salin dibatasi untuk penulis. Perhatikan bahwa jika kolom restrictedForWriters adalah true, download dan salin juga dibatasi untuk pembaca. Demikian pula, menetapkan restrictedForWriters ke true dan restrictedForReaders ke false sama dengan menetapkan restrictedForWriters dan restrictedForReaders ke true.
Kompatibilitas mundur
Dengan diperkenalkannya objek DownloadRestriction, fungsi kolom boolean
restrictions.copyRequiresWriterPermission
telah diperbarui.
Sekarang, menetapkan restrictions.copyRequiresWriterPermission ke true akan mengupdate
restrictedForReaders kolom boolean dari objek DownloadRestriction ke true untuk menyatakan bahwa
download dan salin dibatasi untuk pembaca.
Menetapkan kolom copyRequiresWriterPermission ke false akan mengupdate kolom restrictedForWriters dan restrictedForReaders ke false. Artinya, setelan pembatasan download atau salin dihapus untuk semua pengguna.
copyRequiresWriterPermissionDownloadRestriction Kolom ini tidak dimaksudkan untuk digunakan bersama karena kedua nilai kolom dapat bertentangan.
Kolom yang mengontrol fitur download, cetak, dan salin
Tabel berikut mencantumkan drives kolom resource
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 pembatasan copyRequiresWriterPermission 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. | v3 saja |
restrictions.copyRequiresWriterPermission |
Apakah opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama dinonaktifkan untuk pembaca dan pengomentar. Jika true, kolom dengan nama yang sama akan ditetapkan ke true untuk file apa pun di dalam drive bersama ini. |
v2 &v3 |
restrictions.downloadRestriction |
Pembatasan download yang diterapkan oleh pengelola drive bersama. | v3 saja |
Batas folder
Folder drive bersama memiliki beberapa batas penyimpanan. Untuk mengetahui informasi selengkapnya, lihat Batas drive bersama di Google Drive.
Batas item
Setiap drive bersama pengguna memiliki batas 500.000 item, termasuk file, folder, dan pintasan.
Setelah batas tercapai, drive bersama tidak dapat lagi menerima item. Untuk melanjutkan penerimaan file, pengguna harus menghapus item secara permanen dari drive bersama. Perhatikan bahwa item di sampah dihitung dalam batas, tetapi item yang dihapus secara permanen tidak. 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 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.