Meet-Add-on bereitstellen

Google Meet-Add-ons werden im Rahmen eines Google Cloud-Projekts erstellt und konfiguriert.

Google Cloud-Projekt erstellen

Informationen zum Generieren eines Google Cloud-Projekts finden Sie unter Google Cloud-Projekt erstellen.

Google Workspace Marketplace SDK und Google Workspace Add-ons API aktivieren

Das Google Workspace Marketplace SDK und die Google Workspace Add-ons API sind erforderlich, um Meet-Add-ons zu entwickeln. So werden sie aktiviert:

  1. Öffnen Sie die Google Cloud Console.
  2. Wenn oben bereits ein anderes Projekt geöffnet ist, wählen Sie den Projektnamen des Projekts Ihrer App aus, um das Projekt zu wechseln.
  3. Geben Sie oben in der Suchleiste Google Workspace Marketplace SDK ein und drücken Sie die Eingabetaste.
  4. Öffnen Sie die Seite Google Workspace Marketplace SDK und klicken Sie auf Aktivieren.

  5. Wiederholen Sie diese Schritte, um die Google Workspace Add-ons API zu finden und zu aktivieren.

Deployment erstellen

Wenn Sie ein Add-on in Google Meet verwenden möchten, benötigen Sie eine Bereitstellung und eine Manifestdatei für das Add-on.

  1. Öffnen Sie die Google Cloud Console.
  2. Wenn oben bereits ein anderes Projekt geöffnet ist, wählen Sie den Projektnamen des Projekts Ihrer App aus, um das Projekt zu wechseln.
  3. Klicken Sie auf APIs und Dienste.
  4. Wählen Sie Google Workspace Marketplace SDK aus, um die Detailseite aufzurufen.

Bereitstellung erstellen

Sie können die Bereitstellung direkt in der Google Cloud Console erstellen, indem Sie eine HTTP-Bereitstellung (empfohlen) oder Google Apps Script verwenden.

HTTP-Bereitstellung

  1. Klicken Sie auf den Tab HTTP-Bereitstellungen.
  2. Klicken Sie auf Neue Bereitstellung erstellen und geben Sie die Bereitstellungs-ID des Add-ons ein.

    Die Bereitstellungs-ID ist ein beliebiger String, mit dem der Add-on-Entwickler die Bereitstellung mit dem Add-on-Manifest identifizieren kann. Deployment-IDs sind erforderlich und können höchstens 100 Zeichen lang sein.

  3. Klicken Sie auf Weiter.

    Eine Seitenleiste wird geöffnet, in der Sie die Spezifikation des Add-on-Manifests im JSON-Format einreichen können. Diese Datei wird auch DEPLOYMENT.JSON genannt.

    Die Manifestdatei des Add-ons ist die zentrale Konfiguration für ein Google Meet-Add-on. Im folgenden Codebeispiel sind die verfügbaren Meet-Felder für das Web in der Manifestdatei des Add-ons zu sehen.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Ersetzen Sie Folgendes:

    • NAME: String. Der Name Ihres Google Meet-Add-ons.
    • LOGO_URL: String. Die URL des Logos für das Google Workspace-Add-on. Dieser wird für das Add-on in allen Google Workspace-Produkten verwendet.
    • SIDE_PANEL_URI: String. Die URL zum Einstiegspunkt Ihrer Add-on-App. Diese wird in einem iFrame in der Seitenleiste angezeigt. Der Ursprung dieser URL muss zu den im Feld ADD_ON_ORIGINS angegebenen Ursprüngen gehören.
    • ADD_ON_ORIGINS: Liste von Strings. Eine Liste der Ursprünge, unter denen Ihr Add-on gehostet wird. Zwei URLs haben denselben Ursprung, wenn sie dasselbe Schema, denselben Host und denselben Port haben. Untergeordnete Ursprünge und Platzhalter-Subdomains sind ebenfalls zulässig. Weitere Informationen finden Sie unter Add-on-Sicherheit.
    • DARK_MODE_LOGO_URL: String. Eine URL für das Logo des Add-ons, die für den dunklen Modus gilt. Wenn Sie ein Logo für den dunklen Modus angeben, wird Ihr Add-on in jedem Meet-Design optimal dargestellt. Richtlinien für das Logodesign finden Sie unter Best Practices.
    • MEET_WEB_LOGO_URL: Optional. String. Eine Meet-spezifische URL des Logos für das Add-on. Dieses Logo wird in Meet verwendet. Wenn nicht vorhanden, wird die logoUrl aus dem gemeinsamen Abschnitt verwendet. Richtlinien für das Logodesign finden Sie unter Best Practices.
    • SUPPORTS_SCREENSHARING: Optional. Boolescher Wert. Wenn dieser Wert auf „false“ gesetzt ist, müssen Nutzer das Add-on verwenden, um zu sehen, was in einer Add-on-Sitzung mit mehreren Nutzern passiert. Wenn diese Option auf „wahr“ gesetzt ist, kann der Initiator der Gruppenarbeit mit dem Add-on seine Ansicht des Add-ons teilen.
  4. Klicken Sie auf Senden.

    Weitere Informationen zu Bereitstellungen finden Sie unter Bereitstellungsressource erstellen.

  5. Wählen Sie auf dem Tab App-Konfiguration unter App-Integration die Option Google Workspace-Add-on aus. Wählen Sie Mit Cloud-Deployment-Ressource bereitstellen und dann die richtige HTTP-Bereitstellung aus.

Google Apps Script

  1. Klicken Sie auf den Tab App-Konfiguration.

  2. Wählen Sie unter App-Integration die Option Google Workspace-Add-on aus. Wählen Sie Mit Google Apps Script-Deployment-ID bereitstellen aus und geben Sie die Bereitstellungs-ID Ihres Scripts ein.

  3. Klicken Sie auf Speichern.

    Weitere Informationen zum Erstellen eines Apps Script-Projekts finden Sie in der Apps Script-Dokumentation. Das Meet-Add-on verwendet ausschließlich die Manifestdatei „appsscript.json“, auch Apps Script-Projektmanifest genannt. Die Manifestdatei in Ihrem Apps Script-Projekt muss die Abschnitte addOns und meet enthalten. Die Abschnitte addOns und meet folgen der Struktur, die auf dem Tab „HTTP-Bereitstellung“ beschrieben wurde.

    Im Gegensatz zu anderen Google Workspace-Add-ons können Meet-Add-ons nicht vollständig in Apps Script erstellt werden. Stattdessen müssen Sie eine vollständige Webanwendung erstellen, indem Sie einen Seitenbereich und einen Hauptbereich erstellen. Die URL der Seitenleiste Ihrer Webanwendung muss dann unter SIDE_PANEL_URI der Manifestdatei „appsscript.json“ angegeben werden.

Add-on in Meet installieren und testen

Wenn Sie Ihr Add-on in Meet testen möchten, müssen Sie es zuerst für den angemeldeten Nutzer installieren:

HTTP-Bereitstellung

  1. Rufen Sie in der Google Cloud Console das Google Workspace Marketplace SDK für Ihr Projekt auf.
  2. Klicken Sie auf den Tab HTTP-Bereitstellungen.
  3. Klicken Sie in der Spalte Aktionen auf Installieren.

Google Apps Script

  1. Folgen Sie der Dokumentation zu Google Workspace-Add-ons, um ein nicht veröffentlichtes Add-on zu installieren.

Sie sollten das Add-on jetzt in einer Videokonferenz verwenden können. Starten Sie dazu eine Videokonferenz unter meet.google.com. Das installierte Add-on ist jetzt im Bereich „Aktivitäten“ zu sehen.

Sie können Ihr Add-on nicht nur für den einzelnen angemeldeten Nutzer installieren, sondern auch veröffentlichen. Wenn Sie Ihr Google Workspace-Add-on veröffentlichen, können andere Nutzer es finden, installieren und verwenden.