Saat pengguna mengklik tombol "Baru" UI Drive dan memilih aplikasi di UI Drive, Drive akan mengalihkan pengguna ke URL Baru aplikasi tersebut yang ditentukan di Mengonfigurasi integrasi UI Drive.
Kemudian, aplikasi Anda akan menerima kumpulan variabel template default dalam
parameter state
. Informasi state
default 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 tombol "Baru" UI Drive.- FOLDER_ID: ID folder induk.
- FOLDER_RESOURCE_KEY: Kunci resource folder induk.
- USER_ID: ID profil yang mengidentifikasi pengguna secara unik.
Aplikasi Anda harus menindaklanjuti permintaan ini dengan mengikuti langkah-langkah berikut:
- Verifikasi bahwa kolom
action
memiliki nilaicreate
. - Gunakan nilai
userId
untuk membuat sesi baru bagi pengguna. Untuk informasi selengkapnya tentang pengguna yang login, lihat Pengguna & peristiwa baru. - Gunakan metode
files.create
untuk membuat resource file. JikafolderId
ditetapkan pada permintaan, tetapkan kolomparents
ke nilaifolderId
. - Jika
folderResourceKey
ditetapkan pada permintaan, tetapkan header permintaanX-Goog-Drive-Resource-Keys
. Untuk informasi selengkapnya tentang kunci resource, lihat Mengakses file yang dibagikan link menggunakan kunci resource.
Parameter state
dienkode URL, sehingga aplikasi Anda harus menangani karakter
escape dan mengurainya sebagai JSON.
Pengguna & peristiwa baru
Aplikasi Drive harus memperlakukan semua peristiwa "buat" sebagai potensi
login. Beberapa pengguna mungkin memiliki beberapa akun, sehingga ID pengguna dalam parameter state
mungkin tidak cocok dengan sesi saat ini. Jika ID pengguna dalam parameter state
tidak cocok dengan sesi saat ini, akhiri sesi saat ini untuk
aplikasi Anda dan login sebagai pengguna yang diminta.