Integrasikan dengan tombol "Baru" UI Drive

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 adalah create 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:

  1. Verifikasi bahwa kolom action memiliki nilai create.
  2. Gunakan nilai userId untuk membuat sesi baru bagi pengguna. Untuk informasi selengkapnya tentang pengguna yang login, lihat Pengguna & peristiwa baru.
  3. Gunakan metode files.create untuk membuat resource file. Jika folderId ditetapkan pada permintaan, tetapkan kolom parents ke nilai folderId.
  4. Jika folderResourceKey ditetapkan pada permintaan, tetapkan header permintaan X-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.