Damit Ihre App in Google Drive angezeigt wird, wenn ein Nutzer eine Datei erstellt oder öffnet, müssen Sie muss zuerst eine Integration der Drive-Benutzeroberfläche (UI) einrichten. Die Konfiguration ist auch erforderlich, um Ihre App im Google Workspace Marketplace
Drive API aktivieren
Bevor Sie Google APIs verwenden können, müssen Sie sie in einer Google Cloud aktivieren Projekt arbeiten. Sie können eine oder mehrere APIs in einer einzelnen Google Cloud aktivieren Projekt arbeiten.
Für die Integration in die Google Drive-Benutzeroberfläche müssen Sie den Drive API Dadurch erhalten Sie Zugriff auf die API- und UI-Integration Funktionen.
Aktivieren Sie in der Google Cloud Console die Google Drive API.
Integration der Drive-Benutzeroberfläche einrichten
- Öffnen Sie in der Google API Console das Menü > APIs und Dienste > Aktivierte APIs und -Dienste. .
- Unten in den APIs und Dienste-Dashboard auf Google Drive API. Die Die Konfigurationsseite für die Google Drive API wird angezeigt.
- Wählen Sie den Tab Drive-UI-Integration aus.
- Optional: Geben Sie in das Feld Name der Anwendung einen Namen ein. Die Anwendung wird Nutzern auf dem Tab „Apps verwalten“ in Drive angezeigt Einstellungen.
- Optional: Geben Sie unter Kurzbeschreibung eine einzeilige Beschreibung ein. ein. Die kurze Beschreibung wird Nutzern auf dem Tab „Apps verwalten“ in Google Drive-Einstellungen.
- Optional: Geben Sie eine vollständige Beschreibung in das Feld Lange Beschreibung ein.
Laden Sie ein oder mehrere Anwendungssymbole hoch, die in der Liste der Nutzer angezeigt werden sollen. verbundenen Drive-Apps und im Bereich "Öffnen mit" Kontextmenü. Symbole sollten im PNG-Format mit transparentem Hintergrund vorliegen. Symbole können bis zu 24 Stunden in Google Drive angezeigt werden.
So verwenden Sie die Drive-Benutzeroberfläche "Öffnen mit" Menü Artikel die URL zu Ihrer App in das Feld URL öffnen. Diese URL wird vom "Öffnen mit"- Kontextmenü.
- Diese URL muss einen voll qualifizierten Domainnamen enthalten.
localhost
nicht arbeiten. - Diese URL sollte für die beabsichtigten Nutzer Ihrer Anwendung zugänglich sein. Wenn Sie mehrere Anwendungsversionen haben, z. B. eine für öffentliche Release und einen für den eingeschränkten Release für ausgewählte Nutzer, jede Version muss eine eindeutige URL verwendet werden. Anschließend können Sie eine andere App Konfigurationen für die einzelnen Versionen
- Du musst Inhaberschaft dieser URL bestätigen bevor Sie Ihre Anwendung im Google Workspace Marketplace auflisten können.
- Standardmäßig wird ein
state
-Suchparameter an diese URL angehängt, um Daten aus der Drive-Benutzeroberfläche in Ihre App übertragen. Informationen zur den Inhalt des Parametersstate
, siehe Derstate
.
- Diese URL muss einen voll qualifizierten Domainnamen enthalten.
Optional: Geben Sie Standard-MIME-Typen und -Dateiendungen in das Feld Felder für Standard-MIME-Typen und Standard-Dateierweiterungen: Standard-MIME Typen und Dateiendungen stehen für Dateien, für die Ihre App speziell erstellt wurde öffnen. Ihre App könnte beispielsweise ein integriertes Format öffnen, zum Bearbeiten von Bildern. Nur Standard-Medien einschließen Typen und achten Sie darauf, dass sie keine Tipp- und Rechtschreibfehler enthalten. Wenn Ihre App nur geöffnet wird, oder Drittanbieter-Verknüpfungsdateien müssen, können Sie das Feld für den MIME-Typ leer lassen.
Optional: Geben Sie sekundäre MIME-Typen und Dateierweiterungen in das Feld Sekundäre MIME-Typen und Sekundäre Dateierweiterungen: Sekundäre MIME-Typen Dateiendungen stehen für Dateien, die Ihre App öffnen kann, sind aber nicht spezifisch zu Ihrer App hinzufügen. Beispiel: Ihre App ist eine Bildbearbeitungs-App, die sich öffnet PNG- und JPG-Bilder. Nur Standard-Medien einschließen Typen und achten Sie darauf, dass sie keine Tipp- und Rechtschreibfehler enthalten. Wenn Ihre App nur geöffnet wird, oder Drittanbieter-Verknüpfungsdateien müssen, können Sie das Feld für den MIME-Typ leer lassen.
So verwenden Sie die Schaltfläche „Neu“ der Drive-UI Schaltfläche und bitten Sie die Nutzer, eine Datei mit aktivieren Sie das Kästchen Dateien erstellen. Die Neue URL und optional Die Felder Dokumentname werden angezeigt.
- Diese URL muss einen voll qualifizierten Domainnamen enthalten.
localhost
nicht arbeiten. - Sie müssen die Inhaberschaft bestätigen URL bevor Sie Ihre Anwendung im Google Workspace Marketplace auflisten können.
- Standardmäßig wird ein
state
-Suchparameter an diese URL angehängt, um Daten aus der Drive-Benutzeroberfläche in Ihre App übertragen. Informationen zur den Inhalt des Parametersstate
, siehe Derstate
.
- Diese URL muss einen voll qualifizierten Domainnamen enthalten.
Geben Sie in das Feld Neue URL eine URL ein. Diese URL wird von der Spalte „New“ (Neu) Schaltfläche um den Nutzer zu Ihrer App weiterzuleiten.
Optional: Wenn Sie möchten, dass von Google Workspace unterstützte Dateien in Ihrer App geöffnet werden, gehen Sie so vor: Klicken Sie das Kästchen Importieren an.
Optional: Wenn Ihre App Dateien in geteilten Ablagen verwalten muss, klicken Sie auf das Kästchen Unterstützung für geteilte Ablagen. Weitere Informationen zum Support Geteilte Ablagen in Ihrer App implementieren“ Support.
Klicken Sie auf Senden.
Bereich drive.install
anfordern
So lassen Sie zu, dass Apps als Option im Menü "Öffnen mit" angezeigt werden oder die Schaltfläche „Neu“ Menü,
https://www.googleapis.com/auth/drive.install
-Bereich für die Integration anfordern
mit der Benutzeroberfläche von Drive. Wenn Nutzer diesen Bereich anfordern, erhalten sie eine
wie in diesem Beispiel aussehen:
![Installationsdialogfeld der Google Drive-Benutzeroberfläche.](https://developers-dot-devsite-v2-prod.appspot.com/static/drive/images/install-scope.png?authuser=19&hl=de)
Weitere Informationen zu Bereichen, die Sie für Drive-Apps anfordern können, und wie Sie diese anfordern, finden Sie unter API-spezifische Autorisierung und Authentifizierung Informationen.
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-Benutzeroberfläche an Ihre App zu übergeben. Dieser Parameter
enthält einen JSON-codierten String mit Vorlagenvariablen und Daten über die
an Ihre App senden. 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 von Datei-IDs, die geöffnet wird. | URL öffnen |
{exportIds} |
Eine durch Kommas getrennte Liste von Datei-IDs, die exportiert werden (nur beim Öffnen integrierter Google-Dokumente). | URL öffnen |
{resourceKeys} |
Ein JSON-Wörterbuch mit Datei-IDs, die ihrer jeweiligen Ressource zugeordnet sind Schlüssel. | 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 ausgeführte Aktion. Der Wert ist
open bei Verwendung einer offenen URL oder create
wenn Sie eine neue URL verwenden.
|
URL öffnen und neue URL |
Der Parameter state
ist URL-codiert, deine App muss also das Escape-Zeichen
und parsen Sie diese im JSON-Format. Apps können den create
-Wert im
state
-Parameter, um eine Anfrage zum Erstellen einer Datei zu verifizieren.
Beispielstatusinformationen 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"
}
Beispielstatusinformationen in JSON für eine offene URL
Die state
-Informationen für eine geöffnete URL lauten:
{
"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 der Datei verwendet
Inhalte. Sobald Ihre App über die Datei-ID und ein Zugriffstoken verfügt, kann sie
Berechtigungen erteilen, die Metadaten der Datei abrufen und den Dateiinhalt wie beschrieben herunterladen.
in der Methode files.get
.
Weitere Informationen
Eine installierte App muss in der Lage sein, Aktionen zu erstellen, zu verwalten und zu öffnen, die über der Benutzeroberfläche von Drive. Weitere Informationen finden Sie unter Integration von „Neu“ der Drive-Benutzeroberfläche Schaltfläche oder In Drive-Benutzeroberfläche „Öffnen mit“ einbinden Kontext .