Schaltfläche „Neu“ der Drive-Benutzeroberfläche einbinden

Wenn ein Nutzer in der Drive-Benutzeroberfläche auf die Schaltfläche „Neu“ klickt und eine App auswählt, leitet Drive ihn zur neuen URL dieser App weiter, die unter Drive-Benutzeroberflächenintegration konfigurierendefiniert ist.

Ihre App erhält dann eine Standardgruppe von Vorlagenvariablen in einem state Parameter. Die Standardinformationen für state für eine neue URL sind:

{
  "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 ist create, wenn ein Nutzer in der Drive-Benutzeroberfläche auf die Schaltfläche „Neu“ 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:

1. Prüfen Sie, ob das Feld action den Wert create hat.
2. Verwenden Sie den Wert userId, um eine neue Sitzung für den Nutzer zu erstellen. Weitere Informationen zu angemelden Nutzern finden Sie unter Nutzer und neue Ereignisse.
3. Verwenden Sie die files.create Methode, um eine Dateiressource zu erstellen. Wenn folderId in der Anfrage festgelegt wurde, setzen Sie das Feld parents auf den Wert folderId.
4. Wenn folderResourceKey in der Anfrage festgelegt wurde, legen Sie den Anforderungsheader X-Goog-Drive-Resource-Keys fest. Weitere Informationen zu Ressourcenschlüsseln finden Sie unter Auf über Links freigegebene Dateien mit Ressourcenschlüsseln zugreifen.

Der Parameter state ist URL-codiert. Ihre App muss daher 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.