Dokumen 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 menyetel
parameter sistem
fields dengan metode apa pun dari resource drives. Jika Anda
tidak menentukan parameter fields, server akan menampilkan kumpulan kolom default
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 lebih lanjut batas folder drive bersama, lihat Batas folder drive bersama.
Prasyarat
Sebelum Anda dapat membuat dan mengelola drive bersama, pastikan Anda memenuhi persyaratan berikut:
- Akun Google Workspace: Drive bersama tersedia dengan edisi Google Workspace yang didukung (seperti Business Standard, Business Plus, Enterprise, dan Education). Akun Google pribadi (
@gmail.com) tidak dapat membuat drive bersama. - Izin pembuatan: Administrator domain dapat mengonfigurasi apakah pengguna di organisasi mereka dapat membuat drive bersama. Pengguna yang diautentikasi harus tergabung dalam unit organisasi yang diizinkan untuk membuat drive bersama.
- Cakupan OAuth 2.0: Aplikasi Anda harus diberi otorisasi dengan cakupan
https://www.googleapis.com/auth/drive. - Peran: Saat pengguna membuat drive bersama, mereka otomatis
diberi peran
organizerdi drive bersama tersebut. Mengelola setelan drive, mengganti nama drive, menambahkan atau menghapus anggota, dan menghapus drive bersama semuanya memerlukan peranorganizer. Untuk mengetahui informasi selengkapnya tentang peran, lihat Peran untuk drive bersama. - Akses administrator domain: Administrator domain dapat mengelola drive bersama mana pun dalam organisasi mereka, terlepas dari keanggotaan dengan meneruskan
useDomainAdminAccess=true. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
Membuat drive bersama
Untuk membuat drive bersama, gunakan metode create
pada resource drives dengan
parameter requestId.
Parameter requestId mengidentifikasi upaya logis untuk pembuatan drive bersama yang bersifat idempoten. Jika permintaan kehabisan waktu 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 jangka waktu yang lama atau jika isi permintaan telah berubah, error 409
mungkin ditampilkan yang menunjukkan bahwa requestId harus dibatalkan.
Mendapatkan akses ke drive bersama
Untuk mendapatkan metadata untuk 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 mengirim 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 metode list
pada resource drives. Metode ini menampilkan
daftar drive bersama.
Teruskan parameter kueri berikut untuk menyesuaikan penomoran halaman, atau untuk 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: Setel ketrueuntuk mengirim permintaan sebagai administrator domain guna menampilkan semua drive bersama dari domain tempat pemohon menjadi administrator. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
Memperbarui drive bersama
Untuk memperbarui metadata drive bersama, gunakan metode
update pada resource
drives dengan parameter
jalur driveId.
Metode ini menampilkan drive bersama sebagai instance resource drives.
Untuk mengirim permintaan sebagai administrator domain, tetapkan parameter kueri useDomainAdminAccess
ke true. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.
Menyembunyikan dan memperlihatkan drive bersama
Untuk menyembunyikan drive bersama dari tampilan default, gunakan metode
hide pada resource
drives dengan parameter driveId.
Saat drive bersama disembunyikan, Drive menandai resource
drive bersama sebagai hidden=true. Drive bersama yang tersembunyi tidak akan muncul di UI Drive atau dalam daftar file yang dikembalikan.
Untuk memulihkan tampilan default drive bersama, 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:
useDomainAdminAccess: Tetapkan ketrueuntuk mengeluarkan permintaan sebagai administrator domain. Untuk mengetahui informasi selengkapnya, lihat Mengelola drive bersama sebagai administrator domain.allowItemDeletion: Setel ketrueuntuk menghapus item dalam drive bersama. Hanya didukung jikauseDomainAdminAccessjuga disetel 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 pengguna yang bukan anggota berkolaborasi pada item tertentu.
Untuk mengetahui informasi selengkapnya dan kode contoh, 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 hak istimewa administrator.
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 identitas administrator yang diautentikasi menggunakan peniruan identitas 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 kepada akun layanan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan akun layanan.
Memulihkan drive bersama yang tidak memiliki penyelenggara
Contoh kode berikut menunjukkan cara memulihkan drive bersama yang tidak lagi memiliki penyelenggara.
Java
Python
Node.js
PHP
.NET
Mencegah pengguna mendownload, mencetak, atau menyalin file
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 suatu 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 bagi pembaca.
Menyetel 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.canChangeCopyRequiresWriterPermissionRestriction |
Apakah pengguna saat ini dapat mengubah pembatasan copyRequiresWriterPermission pada 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
Drive bersama memiliki batas kedalaman item dan folder. Selain itu, penggunaan penyimpanan dikelola berdasarkan penyimpanan gabungan organisasi, bukan kuota penyimpanan pribadi Drive Saya pengguna individual. Untuk mengetahui informasi selengkapnya, lihat Batas drive bersama di Google Drive.
Batas item
Satu drive bersama dapat berisi maksimum 500.000 item, seperti file, folder, dan pintasan.
Saat batas tercapai, drive bersama tidak dapat lagi menerima item. Untuk melanjutkan menerima 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 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.
Topik terkait
- Ringkasan drive bersama
- Menerapkan dukungan drive bersama
- Batas penggunaan
- Batas file dan folder dalam file
- Peran dan izin