Saat pengguna mengklik tombol "Baru" UI Drive tombol dan memilih aplikasi di UI Drive, Drive mengalihkan pengguna ke URL Baru aplikasi tersebut yang ditentukan dalam Mengonfigurasi UI Drive integrasi.
Aplikasi Anda kemudian menerima serangkaian variabel template default dalam
Parameter state
. state
default
informasi untuk URL Baru adalah:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Output ini mencakup nilai-nilai berikut:
create
: Tindakan yang sedang dilakukan. Nilainya adalahcreate
saat pengguna mengeklik "Baru" UI Drive tombol.- FOLDER_ID: ID folder induk.
- FOLDER_RESOURCE_KEY: Kunci resource folder induk.
- USER_ID: ID profil yang secara unik mengidentifikasi .
Aplikasi Anda harus menindaklanjuti permintaan ini dengan mengikuti langkah-langkah berikut:
- Pastikan kolom
action
memiliki nilaicreate
. - Gunakan nilai
userId
untuk membuat sesi baru bagi pengguna. Untuk selengkapnya informasi tentang pengguna yang login, lihat Pengguna & acara baru. - Gunakan metode
files.create
untuk membuat sumber daya file. JikafolderId
ditetapkan pada permintaan, setelparents
ke nilaifolderId
. - Jika
folderResourceKey
ditetapkan pada permintaan, setel Header permintaanX-Goog-Drive-Resource-Keys
. Untuk mengetahui informasi selengkapnya tentang kunci resource, lihat Mengakses file yang dibagikan dengan link menggunakan resource .
Parameter state
dienkode ke URL sehingga aplikasi Anda harus menangani escape
karakter dan mengurainya sebagai JSON.
Pengguna & acara baru
Aplikasi Drive harus memperlakukan semua "buat" peristiwa sebagai potensi
login. Beberapa pengguna mungkin memiliki beberapa akun, jadi ID pengguna di state
mungkin tidak cocok dengan sesi saat ini. Jika ID pengguna di state
tidak cocok dengan sesi saat ini, akhiri sesi saat ini untuk
aplikasi dan masuk sebagai pengguna yang diminta.