Mengakses file Drive yang dibagikan melalui link menggunakan kunci referensi

Anda dapat berbagi file dan folder Google Drive dengan orang lain menggunakan Drive UI atau melalui API Google Drive. Ketika Anda 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 tautan. Pengguna yang belum pernah melihat file tersebut harus menyediakan kunci resource untuk mendapatkan akses. Pengguna yang baru-baru ini melihat 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 type=user atau type=group Referensi permissions. Permintaan dari pengguna yang hanya memiliki akses ke file yang dibagikan dengan link ini menggunakan type=domain atau Izin 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 diizinkan oleh masing-masing peran. Lihat Peran & izin akses.

Membaca kunci resource dari file

Drive API menampilkan kunci resource file di mode hanya baca Kolom resourceKey dari resource files.

Jika file adalah pintasan Drive, kunci resource untuk target pintasan ditampilkan di objek hanya-baca Kolom shortcutDetails.targetResourceKey.

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 state . Untuk informasi selengkapnya, lihat Mendownload dan mengekspor file.

Menetapkan kunci resource pada permintaan

Kunci resource untuk file apa pun 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

ID file dan pasangan kunci resource ditetapkan pada header menggunakan garis miring (/). {i>Header<i} dibuat dengan menggabungkan semua ID file dan sumber daya pasangan kunci menggunakan pemisah koma (,).

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

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