Meet-Add-on bereitstellen

Google Meet-Add-ons werden als Teil eines Google Cloud-Projekts erstellt und konfiguriert.

Google Cloud-Projekt erstellen

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

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

Für die Entwicklung von Meet-Add-ons sind das Google Workspace Marketplace SDK und die Google Workspace Add-ons API erforderlich. 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 Meet verwenden möchten, benötigen Sie eine Bereitstellung und eine Add-on-Manifestdatei.

  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 & Dienste.
  4. Wählen Sie Google Workspace Marketplace SDK aus, um die Detailseite aufzurufen.

Deployment erstellen

Sie können Ihre 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 Neues Deployment erstellen und geben Sie die Deployment-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 dürfen 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. Sie wird auch als DEPLOYMENT.JSON bezeichnet.

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

    {
  "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 Name wird für das Add‑on in allen Google Workspace-Produkten verwendet.
    • SIDE_PANEL_URI: String. Die URL zum Einstiegspunkt Ihrer Add-on-App. Sie wird in einem iFrame in der Seitenleiste angezeigt. Der Ursprung dieser URL muss Teil der im Feld ADD_ON_ORIGINS angegebenen Ursprünge sein.
    • ADD_ON_ORIGINS: Liste von Strings. Eine Liste der Ursprünge, auf denen Ihr Add-on gehostet wird. Zwei URLs haben denselben Ursprung, wenn sie dasselbe Schema, denselben Host und denselben Port verwenden. Unterursprünge sind ebenso zulässig wie Platzhalter-Subdomains. Weitere Informationen finden Sie unter Add-on-Sicherheit.
    • DARK_MODE_LOGO_URL: String. Eine URL des Logos für das Add-on, die für den Dark Mode optimiert ist. Wenn Sie ein Logo für den dunklen Modus bereitstellen, wird Ihr Add-on in jedem Meet-Design optimal dargestellt. Weitere Informationen zu den Best Practices für das Logodesign
    • 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. Weitere Informationen zu den Richtlinien für das Logodesign
    • SUPPORTS_SCREENSHARING: Optional. Boolescher Wert. Wenn der Wert auf „false“ gesetzt ist, müssen Nutzer das Add-on verwenden, um zu sehen, was in einer Add-on-Sitzung für die Zusammenarbeit passiert. Wenn die Richtlinie auf „true“ gesetzt ist, kann der Initiator der Add‑on-Sitzung für die Zusammenarbeit seine Ansicht des Add‑ons freigeben.

  4. Klicken Sie auf Senden.

    Weitere Informationen zu Deployments finden Sie unter Deployment-Ressource 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 aus und wählen Sie 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-Bereitstellungs-ID bereitstellen aus und geben Sie die Bereitstellungs-ID Ihres Skripts 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 basiert ausschließlich auf der Manifestdatei „appsscript.json“, die auch als Apps Script-Projektmanifest bezeichnet wird. Achten Sie darauf, dass die Manifestdatei in Ihrem Apps Script-Projekt einen addOns- und einen meet-Abschnitt enthält. 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. Stattdessen müssen Sie eine vollständige Webanwendung erstellen, indem Sie ein Seitenleisten- und ein Hauptbühnen-Add-on erstellen. Die Seitenleisten-URL Ihrer Web-App muss dann im 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 das Google Workspace Marketplace SDK für Ihr Projekt in der Google Cloud Console 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 Google Workspace-Add‑on-Dokumentation, um ein nicht veröffentlichtes Add‑on zu installieren.

Sie sollten Ihr Add‑on jetzt in einer Videokonferenz verwenden können. Wenn Sie das Add‑on ausprobieren möchten, starten Sie eine Videokonferenz unter meet.google.com. Das installierte Add‑on wird jetzt im Bereich „Aktivitäten“ angezeigt.

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