Anda dapat membagikan file dan folder Google Drive kepada orang lain menggunakan UI Drive atau melalui Google Drive API. Saat berbagi dari Drive, Anda dapat mengontrol apakah orang dapat mengedit, mengomentari, atau hanya membuka file.
Kunci resource membantu melindungi file Anda dari akses yang tidak diinginkan. Kunci resource adalah parameter tambahan yang diteruskan sehingga pengguna dapat mengakses file tertentu yang telah dibagikan menggunakan link. Pengguna yang belum pernah melihat file tersebut harus memberikan kunci resource untuk mendapatkan akses. Orang yang baru-baru ini melihat file, atau memiliki akses langsung, tidak memerlukan kunci resource untuk mengakses file tersebut.
File Drive yang dibagikan dengan link hanya dapat ditemukan oleh
pengguna yang dapat mengakses file sebagai hasil dari resource type=user
atau
type=group
permissions
. Permintaan dari pengguna
yang hanya memiliki akses ke file bersama dengan link ini menggunakan izin type=domain
atau
type=anyone
mungkin memerlukan kunci resource.
Untuk mengetahui informasi selengkapnya tentang izin, lihat Berbagi file, folder, dan drive. Untuk mengetahui daftar lengkap peran dan operasi yang diizinkan oleh masing-masing peran, lihat Peran & izin.
Membaca kunci resource dari file
Drive API menampilkan kunci resource file pada kolom resourceKey
hanya baca dari resource files
.
Jika file adalah pintasan Drive, kunci resource untuk target pintasan akan ditampilkan di kolom
shortcutDetails.targetResourceKey
hanya baca.
Kolom pada resource files
yang menampilkan URL,
seperti exportLinks
, webContentLink
, dan webViewLink
, juga menyertakan
resourceKey
. Klien yang terintegrasi dengan UI Drive juga dapat
menggunakan resourceKeys
dalam parameter
state
. Untuk mengetahui informasi selengkapnya, lihat Mendownload dan mengekspor file.
Menetapkan kunci resource pada permintaan
Kunci resource untuk setiap file yang dirujuk oleh permintaan ke Drive API ditetapkan pada header HTTP X-Goog-Drive-Resource-Keys
.
Permintaan ke Drive API dapat menentukan satu atau beberapa kunci resource dengan
header HTTP X-Goog-Drive-Resource-Keys
.
Sintaksis
Pasangan ID file dan kunci resource ditetapkan pada header menggunakan pemisah garis miring
(/
). Header dibuat dengan menggabungkan semua ID file dan pasangan kunci resource menggunakan pemisah koma (,
).
Misalnya, pertimbangkan permintaan untuk memindahkan file fileId1
dari folder fileId2
ke
folder fileId3
. Asumsikan kunci resource untuk ketiga file ini masing-masing adalah
resourceKey1
, resourceKey2
, dan resourceKey3
. Header
yang dibuat dari nilai-nilai ini menggunakan pemisah garis miring dan koma adalah:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
Topik terkait
- Berbagi file, folder, dan drive
- Mendownload dan mengekspor file
- Melindungi konten file
- Mengonfigurasi integrasi UI Drive