Integration der Drive-Benutzeroberfläche konfigurieren

Damit Ihre Anwendung in Google Drive angezeigt werden kann, wenn ein Nutzer eine Datei erstellt oder öffnet, müssen Sie zuerst eine Integration der Benutzeroberfläche (UI) von Drive einrichten. Eine Konfiguration ist auch erforderlich, um Ihre Anwendung im Google Workspace Marketplace aufzulisten.

Drive API aktivieren

Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.

Aktivieren Sie die Drive API, um mit der Einbindung in die Google Drive-UI zu beginnen. Dadurch erhalten Sie Zugriff auf die API- und UI-Integrationsfunktionen.

• Aktivieren Sie in der Google Cloud Console die Google Drive API.

  API aktivieren

Integration der Drive-Benutzeroberfläche einrichten

1. Gehen Sie in der Google API Console zu „Menü“ menu > APIs und Dienste > Aktivierte APIs und Dienste.

   Zur Seite „Aktivierte APIs und Dienste“

2. Klicken Sie unten im Dashboard „APIs und Dienste“ auf Google Drive API. Die Google Drive API-Konfigurationsseite wird angezeigt.
3. Wählen Sie den Tab Drive-UI-Integration aus.
4. Optional: Geben Sie in das Feld Name der Anwendung einen Namen ein. Der Name der Anwendung wird Nutzern in den Drive-Einstellungen auf dem Tab „Apps verwalten“ angezeigt.
5. Optional: Geben Sie im Feld Kurzbeschreibung eine kurze, einzeilige Beschreibung ein. Die Kurzbeschreibung wird Nutzern auf dem Tab „Apps verwalten“ in den Drive-Einstellungen angezeigt.
6. Optional: Geben Sie in das Feld Lange Beschreibung eine vollständige Beschreibung ein.

7. Laden Sie ein oder mehrere Anwendungssymbole hoch, die in der Liste verbundener Drive-Anwendungen eines Nutzers und im Kontextmenü von "Öffnen mit" angezeigt werden sollen. Symbole sollten im PNG-Format mit transparentem Hintergrund vorliegen. Es kann bis zu 24 Stunden dauern, bis die Symbole in Drive angezeigt werden.

8. Wenn Sie den Menüpunkt "Öffnen mit" von Drive-UI verwenden möchten, geben Sie die URL Ihrer Anwendung in das Feld URL öffnen ein. Diese URL wird vom Kontextmenü „Öffnen mit“ verwendet.

   • Diese URL muss einen voll qualifizierten Domainnamen enthalten. localhost funktioniert nicht.
   • Sie müssen die Inhaberschaft dieser URL bestätigen, bevor Sie Ihre Anwendung im Google Workspace Marketplace auflisten können.
   • Standardmäßig wird an diese URL der Suchparameter state angehängt, um Daten von der Drive-UI an die Anwendung zu übergeben. Weitere Informationen zum Inhalt des Parameters state finden Sie unter Parameter state.

9. (Optional) Geben Sie Standard-MIME-Typen und Dateierweiterungen in die Felder Standard-MIME-Typen und Standard-Dateierweiterungen ein. Standard-MIME-Typen und Dateierweiterungen stellen Dateien dar, für die Ihre App eindeutig erstellt wurde. Ihre App kann beispielsweise ein integriertes Format zum Überlagern und Bearbeiten von Bildern öffnen. Verwenden Sie nur Standardmedientypen und achten Sie darauf, dass sie keine Tippfehler und Rechtschreibfehler enthalten. Wenn Ihre Anwendung nur Kurzbefehle oder Drittanbieter-Verknüpfungsdateien öffnet, können Sie den MIME-Typ leer lassen.

10. (Optional) Geben Sie sekundäre MIME-Typen und Dateierweiterungen in die Felder Sekundäre MIME-Typen und Sekundäre Dateierweiterungen ein. Sekundäre MIME-Typen und Dateierweiterungen stehen für Dateien, die von deiner App geöffnet werden können, sind aber nicht spezifisch für deine App. Deine App könnte beispielsweise eine Bildbearbeitungs-App sein, die PNG- und JPG-Bilder öffnet. Verwenden Sie nur Standardmedientypen und achten Sie darauf, dass sie keine Tippfehler und Rechtschreibfehler enthalten. Wenn Ihre Anwendung nur Kurzbefehle oder Drittanbieter-Verknüpfungsdateien öffnet, können Sie den MIME-Typ leer lassen.

11. Wenn Sie die Schaltfläche Neu der Drive-UI verwenden möchten und Nutzer die Möglichkeit haben sollen, eine Datei mit Ihrer Anwendung zu erstellen, setzen Sie ein Häkchen bei Dateien erstellen. Die Felder Neue URL und Dokumentname werden optional angezeigt.

    • Diese URL muss einen voll qualifizierten Domainnamen enthalten. localhost funktioniert nicht.
    • Sie müssen die Inhaberschaft dieser URL bestätigen, bevor Sie Ihre Anwendung im Google Workspace Marketplace auflisten können.
    • Standardmäßig wird an diese URL der Suchparameter state angehängt, um Daten von der Drive-UI an die Anwendung zu übergeben. Weitere Informationen zum Inhalt des Parameters state finden Sie unter Parameter state.

12. Geben Sie in das Feld Neue URL eine URL ein. Diese URL wird von der Schaltfläche „Neu“ verwendet, um den Nutzer zu Ihrer Anwendung weiterzuleiten.

13. (Optional) Wenn Ihre Anwendung von Google Workspace unterstützte Dateien öffnen soll, klicken Sie das Kästchen Importieren an.

14. Optional: Klicken Sie das Kästchen Unterstützung für geteilte Ablagen an, wenn Ihre Anwendung Dateien in geteilten Ablagen verwalten muss. Weitere Informationen zur Unterstützung geteilter Ablagen in Ihrer Anwendung finden Sie unter Geteilte Ablagen implementieren.

15. Klicken Sie auf Senden.

drive.install-Bereich anfordern

Damit Anwendungen im Menü „Öffnen mit“ oder „Neu“ als Option angezeigt werden, müssen Sie den Bereich https://www.googleapis.com/auth/drive.install für die Einbindung in die Drive-UI anfordern. Wenn Sie diesen Bereich anfordern, wird Nutzern ein Dialogfeld ähnlich dem folgenden angezeigt:

Weitere Informationen zu Bereichen, die Sie für Google Drive-Anwendungen anfordern können, und wie Sie diese anfordern, finden Sie unter API-spezifische Autorisierungs- und Authentifizierungsinformationen.

Der Parameter state

Standardmäßig wird ein state-Parameter sowohl an die offene URL als auch an die neue URL angehängt, um Daten von der Drive-UI an die Anwendung zu übergeben. Dieser Parameter enthält einen JSON-codierten String mit Vorlagenvariablen und Daten zur Anfrage an die Anwendung. Die enthaltenen Variablen hängen vom Typ der verwendeten URL ab (offene URL oder neue URL):

Vorlagenvariable	Beschreibung	URL-Anwendung
{ids}	Eine durch Kommas getrennte Liste der geöffneten Datei-IDs.	URL öffnen
{exportIds}	Eine durch Kommas getrennte Liste der zu exportierenden Datei-IDs (wird nur beim Öffnen von integrierten Google-Dokumenten verwendet).	URL öffnen
{resourceKeys}	Ein JSON-Wörterbuch der Datei-IDs, die den jeweiligen Ressourcenschlüsseln zugeordnet sind.	URL öffnen
{folderId}	Die ID des übergeordneten Ordners.	Neue URL
{folderResourceKey}	Der Ressourcenschlüssel des übergeordneten Ordners.	Neue URL
{userId}	Die Profil-ID, die den Nutzer identifiziert.	URL öffnen und Neue URL
{action}	Die Aktion, die ausgeführt wird. Der Wert ist open bei Verwendung einer offenen URL oder create bei Verwendung einer neuen URL.	URL öffnen und Neue URL

Der Parameter state ist URL-codiert, daher muss Ihre Anwendung die Escape-Zeichen verarbeiten und als JSON parsen. Apps können den Wert create im Parameter state erkennen, um eine Anfrage zum Erstellen einer Datei zu prüfen.

Beispiel für Informationen zum Status in JSON für eine neue URL

Die state-Informationen für eine neue URL lauten:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Beispiel für Informationen zum Status in JSON für eine geöffnete URL

Die state-Informationen für eine geöffnete URL sind:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

Die IDs und Ressourcenschlüssel werden zum Abrufen von Dateimetadaten und zum Herunterladen von Dateiinhalten verwendet. Sobald Ihre Anwendung die Datei-ID und ein Zugriffstoken hat, kann sie Berechtigungen prüfen, die Dateimetadaten abrufen und den Dateiinhalt herunterladen, wie in der Methode files.get beschrieben.

Weitere Informationen

Eine installierte Anwendung muss in der Lage sein, Aktionen zu erstellen, zu verwalten und zu öffnen, die über die Drive-Benutzeroberfläche gestartet wurden. Weitere Informationen finden Sie unter Einbindung der Drive-UI über die Schaltfläche „Neu“ oder Integration der Drive-UI über das Kontextmenü „Öffnen mit“.