Mengintegrasikan 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 di Mengonfigurasi integrasi UI Drive.

Aplikasi Anda kemudian akan menerima kumpulan variabel template default dalam parameter state. Informasi default state 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 "Baru" 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 bertindak atas 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 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 informasi selengkapnya tentang kunci resource, lihat Mengakses file yang dibagikan melalui link menggunakan kunci resource.

Parameter state dienkode ke URL, sehingga aplikasi Anda harus menangani karakter escape dan mengurainya sebagai JSON.

Pengguna & acara 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.