Integrasikan dengan tombol "Baru" UI Drive

Saat pengguna mengklik tombol "Baru" di UI Drive dan memilih aplikasi di UI Drive, Drive akan mengalihkan pengguna ke URL Baru aplikasi tersebut yang ditentukan dalam Konfigurasi integrasi UI Drive.

Aplikasi Anda kemudian 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 mengklik tombol "New" UI Drive.
• FOLDER_ID: ID folder induk.
• FOLDER_RESOURCE_KEY: Kunci resource dari folder induk.
• USER_ID: ID profil yang mengidentifikasi pengguna secara unik.

Aplikasi Anda harus menindaklanjuti permintaan ini dengan mengikuti langkah-langkah berikut:

1. Pastikan kolom action memiliki nilai create.
2. Gunakan nilai userId untuk membuat sesi baru bagi pengguna. Untuk mengetahui 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 mengetahui informasi selengkapnya tentang kunci resource, lihat Mengakses file yang dibagikan dengan link menggunakan kunci resource.

Parameter state dienkode ke 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 di parameter state mungkin tidak cocok dengan sesi saat ini. Jika User-ID dalam parameter state tidak cocok dengan sesi saat ini, akhiri sesi saat ini untuk aplikasi Anda dan login sebagai pengguna yang diminta.