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 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.
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
dapat 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 Anda
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, diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.q
: String kueri untuk menelusuri shared drive. Untuk mengetahui informasi selengkapnya, lihat Menelusuri drive bersama.useDomainAdminAccess
: Setel ketrue
untuk 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
.
Jika drive bersama disembunyikan, Drive akan 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 untuk memfilter drive bersama:
useDomainAdminAccess
: Setel ketrue
untuk 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.allowItemDeletion
: Setel ketrue
untuk menghapus item dalam drive bersama. Hanya didukung jikauseDomainAdminAccess
juga 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
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.
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
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 drive bersama pengguna dibatasi menampung 500.000 item, termasuk 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 dalam 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
.