Wenn ein Nutzer auf "Neu" der Drive-UI und wählt eine App in der Drive-Benutzeroberfläche, Drive leitet den Nutzer zur neuen URL der App weiter Drive-Benutzeroberfläche konfigurieren Integration.
Ihre Anwendung erhält dann einen Standardsatz von Vorlagenvariablen innerhalb eines
state
-Parameter. Die Standardeinstellung state
für eine neue URL lautet:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Diese Ausgabe enthält die folgenden Werte:
create
: Die ausgeführte Aktion. Der Wert istcreate
, wenn ein Nutzer klickt auf „New“ (Neu) der Drive-Benutzeroberfläche. .- FOLDER_ID: die ID des übergeordneten Ordners.
- FOLDER_RESOURCE_KEY: Der Ressourcenschlüssel des übergeordneten Ordners.
- USER_ID: die Profil-ID, die das Nutzer.
Ihre App muss auf diese Anfrage reagieren. Gehen Sie dazu so vor:
- Das Feld
action
muss den Wertcreate
haben. - Verwenden Sie den Wert
userId
, um eine neue Sitzung für den Nutzer zu erstellen. Weitere Informationen Informationen zu angemeldeten Nutzern finden Sie unter Nutzer und neue Ereignisse. - Verwenden Sie die Methode
files.create
, um eine Dateiressource zu erstellen. WennfolderId
für die Anfrage festgelegt wurde, legen Sie den Parameterparents
auf den WertfolderId
. - Wenn
folderResourceKey
für die Anfrage festgelegt wurde, legen Sie den ParameterX-Goog-Drive-Resource-Keys
-Anfrageheader. Weitere Informationen zu Ressourcenschlüssel, siehe Über die Ressource auf per Link freigegebene Dateien zugreifen Schlüssel.
Der Parameter state
ist URL-codiert, deine App muss also das Escape-Zeichen
und parsen Sie diese im JSON-Format.
Nutzer und neue Ereignisse
Drive-Apps sollten alle „Erstellen“-Aktionen als potenzielle Ereignisse
Anmeldungen. Einige Nutzer haben möglicherweise mehrere Konten. Daher ist die User-ID in der state
.
stimmt möglicherweise nicht mit der aktuellen Sitzung überein. Wenn die User-ID im state
nicht mit der aktuellen Sitzung übereinstimmt, beenden Sie die aktuelle Sitzung für Ihre
App und melden Sie sich als der gewünschte Nutzer an.