Mengakses file Drive yang dibagikan melalui link menggunakan kunci referensi

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 lain 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.

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 yang dibagikan melalui link ini menggunakan izin type=domain atau type=anyone mungkin memerlukan kunci resource.

Untuk mengetahui informasi selengkapnya tentang izin, lihat Membagikan file, folder, dan drive. Untuk mengetahui daftar lengkap peran dan operasi yang diizinkan oleh setiap peran, lihat Peran & izin.

Baca kunci resource dari file

Drive API menampilkan kunci resource file di 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 di 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.

Tetapkan kunci resource pada permintaan

Kunci resource untuk file apa pun yang dirujuk oleh permintaan ke Drive API ditetapkan di 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 di header menggunakan pemisah garis miring (/). Header dibuat dengan menggabungkan semua pasangan kunci resource dan ID file menggunakan pemisah koma (,).

Misalnya, pertimbangkan permintaan untuk memindahkan file fileId1 dari folder fileId2 ke folder fileId3. Asumsikan kunci resource untuk ketiga file ini adalah resourceKey1, resourceKey2, dan resourceKey3. Header yang dibuat dari nilai ini menggunakan garis miring dan pemisah koma adalah:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3