Google Drive-Oberflächen erstellen

Mit Google Workspace-Add-ons können Sie wenn der Nutzer Google Drive verwendet. So können Sie dem Nutzer zusätzliche relevante Informationen abrufen, Aufgaben automatisieren und auf Google Drive übertragen.

Auf die Add-on-UI zugreifen

Sie können ein Google Workspace-Add-on in Google Drive, wenn das zugehörige Symbol . A Das Google Workspace-Add-on kann eine Startseitenoberfläche, eine Oberfläche zur Elementauswahl oder beides definieren:

  • Wenn ein Nutzer in Google Drive auf das Add-on-Symbol klickt, wird das Add-on ausgeführt, das entsprechende drive.homepageTrigger (falls vorhanden). Diese Funktion erstellt eine Startseitenkarte und gibt sie zurück. zur Anzeige in Google Drive. Falls nein drive.homepageTrigger definiert ist, wird stattdessen eine generische Karte für die Startseite angezeigt.
  • Wenn der Nutzer ein oder mehrere Elemente in Google Drive auswählt und dann auf das Add-on klickt: oder Elemente auswählen, während das Add-on geöffnet ist, führt das Add-on die entsprechenden drive.onItemsSelectedTrigger Kontextfunktion (falls vorhanden). Mit dieser Funktion wird das Google Drive-Konto des Add-ons erstellt. Kontextbezogene "Elemente ausgewählt" Schnittstelle und zur Ansicht an Google Drive zurückgegeben.

Benutzeroberfläche des Add-ons für Google Drive erstellen

Sie können Schnittstellen zur Erweiterung von Google Drive erstellen, indem Sie diese allgemeinen Schritte:

  1. Entscheiden Sie, ob das Add-on ein Drive-spezifisches Startseite. Entscheiden Sie außerdem, ob Sie eine kontextbezogene Oberfläche für den Fall bereitstellen möchten, dass der Nutzer Drive-Elemente auswählt.
  2. Fügen Sie die entsprechenden addOns.common und addOns.drive-Felder, um das Add-on-Skriptprojekt Manifest, einschließlich alle erforderlichen Drive-Bereiche
  3. Wenn Sie eine Google Drive-spezifische Startseite zur Verfügung stellen: Implementieren der drive.homepageTrigger um diese Schnittstelle zu erstellen. Sie können auch die common.homepageTrigger für mehrere Google Workspace-Hosts.
  4. Wenn Sie eine Oberfläche zur kontextbezogenen Auswahl von Elementen in Google Drive bereitstellen, müssen Sie drive.onItemsSelectedTrigger implementieren Kontext-Triggerfunktion zum Erstellen dieser Schnittstelle. Weitere Informationen .
  5. Implementieren Sie die zugehörigen Callback-Funktionen, die zum Antworten auf die Callback-Funktion des Nutzers erforderlich sind. Interaktionen auf der Benutzeroberfläche, z. B. Klicks auf Schaltflächen

Google Drive-Startseiten

Google Drive unterstützt die Anzeige des Google Workspace-Add-ons Startseiten. Damit die Startseite Ihres Add-ons in Google Drive angezeigt wird, ist ein addOns.drive-Feld im Manifest des Add-ons.

Alternativ können Sie drive.homepageTrigger auf das Add-on-Manifest, um eine Drive-spezifische Startseite bereitzustellen.

In beiden Fällen müssen Sie den Namen einer Startseiten-Triggerfunktion in Ihrem das Skriptprojekt des Add-ons. Diese Funktion wird automatisch aufgerufen, um den Drive-Startseite bei Bedarf Sie müssen diese Funktion implementieren, um eine einzelne Card oder ein Array von Card Objekte, aus denen die Startseite besteht. An die Triggerfunktion für die Startseite wird ein Ereignisobjekt als Parameter, der einige allgemeine Informationen enthält, wie z. B. die Plattform. Sie können die Ereignisobjektdaten verwenden, um die Konstruktion des Ereignisses Startseite.

Kontextbezogene Oberfläche von Drive für ausgewählte Elemente

Google Drive ermittelt mithilfe eines kontextbezogenen Triggers, welche Oberfläche (falls vorhanden), die angezeigt werden, wenn der Nutzer ein oder mehrere Google Drive-Elemente auswählt. Wenn der Parameter ausgelöst wird, führt er die kontextabhängige Triggerfunktion aus, die vom drive.onItemsSelectedTrigger.runFunction im Manifest des Add-ons.

So erstellen Sie eine Oberfläche zur kontextbezogenen Elementauswahl in Drive: Folgendes:

  1. Achten Sie darauf, dass das Manifest des Add-ons Folgendes enthält: https://www.googleapis.com/auth/drive.addons.metadata.readonly Umfang

  2. Achten Sie darauf, dass das Manifest Folgendes enthält: drive.onItemsSelectedTrigger .

  3. Implementieren Sie die im drive.onItemsSelectedTrigger ein. Diese Funktion akzeptiert ein Ereignisobjekt als Argument und es muss entweder eine Card-Objekt oder ein Array von Card-Objekten

  4. Wie bei jeder Karte musst du alle Callback-Funktionen implementieren, die verwendet werden, um Widget-Interaktivität für die Benutzeroberfläche. Wenn Sie beispielsweise eine Schaltfläche in der Benutzeroberfläche sollte ein angehängtes Aktion und eine implementierte Callback-Funktion, die ausgeführt wird, wenn auf die Schaltfläche geklickt wird.

Ereignisobjekte

Ein Ereignisobjekt wird erstellt und übergeben. an die drive.homepageTrigger oder drive.onItemsSelectedTrigger auslösen, wenn diese Funktionen aufgerufen werden. Die Triggerfunktion kann Die Informationen in diesem Ereignisobjekt, um zu bestimmen, wie Add-on-Karten erstellt werden oder das Verhalten des Add-ons anderweitig steuern.

Die vollständige Struktur der Ereignisobjekte wird unter Ereignisobjekte: Wenn Drive die agierende Host-App des Add-ons ist, werden kontextbezogene Ereignisobjekte einschließlich der Drive-Ereignisobjekt das Drive-spezifische Clientinformationen enthält.

Kontextbezogene Drive-Ereignisobjekte für Auslöser für die Elementauswahl enthalten Informationen die der Nutzer beim Auslösen des Triggers ausgewählt hat. Wenn ein Nutzer mehrere Elemente in Drive auswählt, wird eines der Elemente als eines der folgenden Elemente angesehen: primäres Interesse wird dieses Element als aktives Cursor-Element bezeichnet.

Das folgende Beispiel zeigt eine Drive-Ereignisobjekt das an eine drive.onItemsSelectedTrigger :

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }