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 Ihres Anwendungsprojekts 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 Ihre Bereitstellung direkt in der Google Cloud Console erstellen, indem Sie eine HTTP-Bereitstellung erstellen (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. Bereitstellungs-IDs sind erforderlich und dürfen maximal 100 Zeichen enthalten.

  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 Teil der im Feld ADD_ON_ORIGINS angegebenen Quellen sein.
    • ADD_ON_ORIGINS: Liste von Strings. Eine Liste der Ursprünge, in denen Ihr Add-on gehostet wird. Zwei URLs haben denselben Ursprung, wenn sie dasselbe Schema, denselben Host und denselben Port haben. Subursprü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. Mit einem Logo im dunklen Modus 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 zur Gestaltung von Logos finden Sie in den 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 die Richtlinie auf „true“ gesetzt ist, kann der Initiator der gemeinsamen Add-on-Sitzung seine Ansicht des Add-ons über den Bildschirm freigeben.
  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-Bereitstellungsressource 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 haben dieselbe Struktur, wie auf dem Tab "HTTP-Bereitstellung" beschrieben.

    Im Gegensatz zu anderen Google Workspace-Add-ons können Meet-Add-ons nicht vollständig in Apps Script erstellt werden. Sie müssen stattdessen eine vollständige Webanwendung erstellen, indem Sie eine Seitenleiste 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 Anleitung zum Installieren eines nicht veröffentlichten Add-ons in der Dokumentation zum Google Workspace-Add-on.

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, stellen Sie es anderen zur Verfügung, damit sie es finden, installieren und verwenden können.