Schaltfläche „Neu“ der Drive-Benutzeroberfläche einbinden
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wenn ein Nutzer in der Drive-Benutzeroberfläche auf die Schaltfläche Neu klickt und eine App auswählt, leitet Drive ihn zur URL „Neu“ dieser App weiter, die unter Drive-Benutzeroberflächenintegration konfigurieren definiert ist.
Ihre App erhält dann einen Standardsatz von Vorlagenvariablen innerhalb eines state-Parameters. Die Standardinformationen für eine neue URL sind:state
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Diese Ausgabe enthält die folgenden Werte:
create: Die Aktion, die ausgeführt wird. Der Wert ist create, wenn ein Nutzer auf die Schaltfläche Neu in der Drive-Benutzeroberfläche klickt.- FOLDER_ID: Die ID des übergeordneten Ordners.
- FOLDER_RESOURCE_KEY: Der Ressourcenschlüssel des übergeordneten Ordners.
- USER_ID: Die Profil-ID, die den Nutzer eindeutig identifiziert.
Ihre App muss auf diese Anfrage reagieren. Gehen Sie dazu so vor:
- Prüfen Sie, ob das Feld
action den Wert create hat.
- Verwenden Sie den Wert
userId, um eine neue Sitzung für den Nutzer zu erstellen. Weitere Informationen zu angemeldeten Nutzern finden Sie unter Nutzer und neue Ereignisse.
- Verwenden Sie die Methode
files.create, um eine Dateiressource zu erstellen. Wenn folderId in der Anfrage festgelegt wurde, setzen Sie das Feld parents auf den Wert von folderId.
- Wenn
folderResourceKey für die Anfrage festgelegt wurde, legen Sie den Anfrage-Header X-Goog-Drive-Resource-Keys fest. Weitere Informationen zu Ressourcenschlüsseln finden Sie unter Über Links freigegebene Dateien mit Ressourcenschlüsseln aufrufen.
Der Parameter state ist URL-codiert. Ihre App muss also die Escapezeichen verarbeiten und ihn als JSON parsen.
Nutzer und neue Ereignisse
Drive-Apps sollten alle „create“-Ereignisse als potenzielle Anmeldungen behandeln. Einige Nutzer haben möglicherweise mehrere Konten. Daher stimmt die Nutzer-ID im Parameter state möglicherweise nicht mit der aktuellen Sitzung überein. Wenn die Nutzer-ID im Parameter state nicht mit der aktuellen Sitzung übereinstimmt, beenden Sie die aktuelle Sitzung für Ihre App und melden Sie sich als der angeforderte Nutzer an.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-04 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
