Integrasikan dengan tombol "Baru" UI Drive
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
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 "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:
- Pastikan kolom
action memiliki nilai create.
- 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. Jika folderId ditetapkan pada permintaan, tetapkan kolom
parents ke nilai folderId.
- 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 melalui link menggunakan kunci
resource.
Parameter state dienkode URL, sehingga aplikasi Anda harus menangani karakter escape
dan menguraikannya sebagai JSON.
Pengguna & peristiwa baru
Aplikasi Drive harus memperlakukan semua peristiwa "create" 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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-04 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-04 UTC."],[],[],null,["# Integrate with Drive UI's "New" button\n\nWhen a user clicks [Drive UI's \"New\"\nbutton](/workspace/drive/api/guides/about-apps#new) and selects an app in the\nDrive UI, Drive redirects the user to that app's New URL\ndefined in [Configure a Drive UI\nintegration](/workspace/drive/api/guides/enable-sdk).\n\nYour app then receives a default set of template variables within a\n[`state`](/workspace/drive/api/guides/enable-sdk#construct) parameter. The default `state`\ninformation for a New URL is: \n\n {\n \"action\":\"create\",\n \"folderId\":\"\u003cvar translate=\"no\"\u003eFOLDER_ID\u003c/var\u003e\",\n \"folderResourceKey\":\"\u003cvar translate=\"no\"\u003eFOLDER_RESOURCE_KEY\u003c/var\u003e\",\n \"userId\":\"\u003cvar translate=\"no\"\u003eUSER_ID\u003c/var\u003e\"\n }\n\nThis output includes the following values:\n\n- `create`: The action being performed. The value is `create` when a user clicks [Drive UI's \"New\"\n button](/workspace/drive/api/guides/about-apps#new).\n- \u003cvar translate=\"no\"\u003eFOLDER_ID\u003c/var\u003e: The ID of the parent folder.\n- \u003cvar translate=\"no\"\u003eFOLDER_RESOURCE_KEY\u003c/var\u003e: The resource key of the parent folder.\n- \u003cvar translate=\"no\"\u003eUSER_ID\u003c/var\u003e: The profile ID that uniquely identifies the user.\n\nYour app must act on this request by following these steps:\n\n1. Verify that the `action` field has a value of `create`.\n2. Use the `userId` value to create a new session for the user. For more information on signed-in users, see [Users \\& new events](#potential-logins).\n3. Use the [`files.create`](/workspace/drive/api/v3/reference/files/create) method to create a file resource. If `folderId` was set on the request, set the `parents` field to the `folderId` value.\n4. If `folderResourceKey` was set on the request, set the `X-Goog-Drive-Resource-Keys` request header. For more information on resource keys, see [Access link-shared files using resource\n keys](/workspace/drive/api/guides/resource-keys).\n\nThe `state` parameter is URL-encoded, so your app must handle the escape\ncharacters and parse it as JSON.\n\nUsers \\& new events\n-------------------\n\nDrive apps should treat all \"create\" events as potential\nsign-ins. Some users might have multiple accounts, so the user ID in the `state`\nparameter might not match the current session. If the user ID in the `state`\nparameter doesn't match the current session, end the current session for your\napp and sign in as the requested user."]]
