Integration der Drive-Benutzeroberfläche konfigurieren

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.

  API aktivieren

Integration der Drive-Benutzeroberfläche einrichten

1. Öffnen Sie in der Google API Console das Menü . > APIs und Dienste > Aktivierte APIs und -Dienste.

   Zu „Aktivierte APIs und Dienste

2. Unten in den APIs und Dienste-Dashboard auf Google Drive API. Die Die Konfigurationsseite für die Google Drive API 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. Die Anwendung wird Nutzern auf dem Tab „Apps verwalten“ in Drive angezeigt Einstellungen.
5. Optional: Geben Sie unter Kurzbeschreibung eine einzeilige Beschreibung ein. ein. Die kurze Beschreibung wird Nutzern auf dem Tab „Apps verwalten“ in Google Drive-Einstellungen.
6. Optional: Geben Sie eine vollständige Beschreibung in das Feld Lange Beschreibung ein.

7. 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.

   Hinweis: Dokumentsymbole wurden eingestellt. Ihr App-Symbol erscheint neben und Drittanbieterdateien. Es wird eine Reihe von Standardsymbolen verwendet. für andere Dateitypen.

8. 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 Parameters state, siehe Der state .
   Warnung: Die Option zum automatischen Anzeigen des OAuth 2.0-Zustimmungsbildschirms ist eingestellt. Klicken Sie dieses Kästchen nicht an. Die Anwendung muss alle Autorisierungen starten. -Anfragen.

9. 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.

10. 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.

    Hinweis :Wenn ein Nutzer mehrere Drive-Apps installiert, mit denen eine -Datei wird die zuletzt installierte App verwendet, bis der Nutzer eine andere auswählt App.

11. 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 Parameters state, siehe Der state .

12. 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.

    Hinweis: Lassen Sie das Feld „Dokumentname“ leer. Dieses Feld wird nicht mehr verwendet.

13. 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.

14. 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.

15. 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:

Abbildung 1. Das Installationsdialogfeld, wenn Bereiche für die Drive-UI verwendet werden.

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.

Hinweis: Wenn Sie Ihre Google Drive App veröffentlichen, Google Workspace Marketplace hinzugefügt haben, können Nutzer und Domainadministratoren suchen und installieren Sie die App direkt über die Google Workspace Marketplace

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.

Hinweis :Alle Apps, einschließlich Apps, die Dateien über Verknüpfungen und Drittanbieter öffnen sollte die files.get aufrufen, können Sie die Berechtigungen des Nutzers für ein Dokument überprüfen. Apps sollten eine Warnung senden Nutzer mit Lesezugriff, wenn sie eine Datei öffnen, die sie nicht bearbeiten oder speichern können, und er kann dann Zeit zum Bearbeiten aufwenden und dann beim Speichern eine Fehlermeldung erhalten.

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 .