Best Practices

Die Nutzerfreundlichkeit verbessern User Experience haben, indem Sie diesen Leitfäden für Design des Google Meet-Add-ons.

Best Practices für die Autorisierung

Wir empfehlen Ihnen, die folgenden Best Practices Google Meet-Add-ons, für die eine Authentifizierung oder Autorisierung erforderlich ist.

Google Log-in verwenden

Viele Nutzerinnen und Nutzer von Google Workspace-Add-ons haben sich schon einmal bei Google angemeldet. wenn Sie an der Videokonferenz teilnehmen. Wenn Sie also Google Log-in verwenden, die als Option verfügbar ist, können sich den Nutzern einige Klicks ersparen, wenn sie zur Anmeldung.

Anmeldeseite eines Drittanbieters in einem neuen Fenster öffnen

Zusätzlich zu Google Log-in bietet Ihre Anwendung möglicherweise weitere Anmeldeoptionen Mechanismen. Verwenden Sie in diesem Fall ein Dialogfenster, anstatt die Anmeldeseite in einem neuer Tab. So kann der Nutzer die Seite weiterhin sehen und zur Meet-Anruf erhalten und es werden insgesamt weniger Klicks erhalten.

Bereiche für Google APIs korrekt anfordern

Wenn das Meet-Add-on Google APIs aufruft, gilt Folgendes: müssen Sie eine vollständige Liste der Umfang die für das Add-on erforderlich sind. Dies erfolgt auf der Konfigurationsseite für Google Workspace Marketplace-Apps. Nach dem Hinzufügen -Umfängen, wird Ihren Nutzern bei der Installation Ihrer Meet-Add-on, das Nutzern mitteilt, welche Art von Daten sie verwenden damit deine App darauf zugreifen kann.

Bevor Sie das Add-on veröffentlichen, müssen Sie auch die OAuth-Einwilligung . Dazu müssen Sie genau dieselben Autorisierungsbereiche wie in Ihrem Konfiguration der Google Workspace Marketplace-App. OAuth konfigurieren müssen auch die Markeninformationen, die Datenschutzerklärung, und Nutzungsbedingungen, die angezeigt werden, wenn Bereiche angefordert werden. Zum Veröffentlichen öffentlich zugänglich sind, müssen alle diese Informationen für .

Wenn Sie Code zum Aufrufen der Google Workspace APIs schreiben, folgen Sie dem JavaScript-Code Kurzanleitung ist die einfachste Möglichkeit, loszulegen. Bei diesem Ansatz werden die Best Practices für über Google Log-in und Dialogfelder. Beachten Sie, dass das Initialisieren des Tokens Kunde in JavaScript müssen die Bereiche separat angefordert werden, zur Laufzeit tatsächlich verwendet wird. Für eine optimale Nutzererfahrung werden sollten mit denen in der Konfiguration der Google Workspace Marketplace-App übereinstimmen Seite. Diese Redundanz bietet einen Ersatz für den Fall, dass ein Nutzer das Recht auf Vergessenwerden Bereiche.

Best Practices für die Wartung

Die folgenden Best Practices gelten für gut lesbare Texte Webanwendungen zu erstellen. Sie sind jedoch besonders wichtig, wenn Sie Meet-Add-ons.

Die neueste Version des Google Meet Add-ons SDK verwenden

Das Meet Add-ons SDK wird regelmäßig aktualisiert. Das SDK hält die semantische Versionsverwaltung verwendet. So finden Sie die neueste Version:

  • Bei Verwendung von gstatic: Die neueste SDK-Version ist in gstatic enthalten. URL aus der Anleitung zur Verwendung des SDK.
  • Bei Verwendung von npm: Führen Sie npm update @googleworkspace/meet-add-ons innerhalb von dem Verzeichnis, das package.json enthält für die Website, auf der das Meet-Add-on gehostet wird.

Google Cloud-Staging-Projekt erstellen

Sobald Ihr Google Meet-Add-on im Google Workspace Marketplace alle neuen Bereitstellungen des Google Meet-Add-ons werden sofort ausgeführt. für Meet-Nutzer verfügbar. Nutzer sehen diese Updates, sobald werden die Caches geleert oder der Cache läuft ab. Daher raten wir davon ab, Übertragen von Änderungen an Ihre Produktions-Website, bis diese gründlich getestet wurden.

Um eine direkte Bereitstellung für die Produktion zu vermeiden, sollten Sie eine separate Privat veröffentlichtes Google Cloud-Projekt für Ihr Unternehmen. Dieses Cloud-Projekt hostet sowohl das Staging als auch Entwicklungsumgebungen für das Meet-Add-on. Zugriff für dieses Cloud-Projekt sollte auf ein kleineres Team beschränkt sein, direkt an der Entwicklung Ihres Add-ons arbeiten.

So erstellen Sie diese alternativen Umgebungen für Ihr Add-on: müssen Sie zunächst alternative Umgebungen der Webanwendung hosten, die das Add-on auf einer Domain enthält, die Ihnen gehört. Gehen Sie dann so vor: können Sie alternative Umgebungen für Ihre durch Hinzufügen des zusätzlichen Bereitstellungen Google Cloud-Staging-Projekt hinzu. Diese neuen Bereitstellungen sollten Manifeste, die auf die alternativen Umgebungen Ihrer Webanwendung verweisen. Anschließend empfehlen wir, jedes Add-on zu installieren, wie folgt:

  • Staging: Staging-Version privat veröffentlichen damit alle in Ihrer Organisation Sie beim Testen unterstützen können.
  • Entwicklung: Klicken Sie in der Spalte Aktionen auf Installieren, um die Entwicklerversion des Meet-Add-ons für Ihr Konto verfügbar.

Tests schreiben

Vor der Bereitstellung des Meet-Add-ons in der Entwicklungsphase empfehlen wir, Einheitentests zu schreiben. Ihre Einheitentests sollten Folgendes enthalten:

  • das Meet Add-ons SDK ausarbeiten und dann prüfen, ob die Das Meet-Add-on ruft die SDK-Funktionen wie erwartet auf.
  • Testen Sie alle nicht SDK-bezogenen Funktionen Ihres mit Ihrem bevorzugten Framework für Webtests.

Best Practices für die Nutzererfahrung

Die folgenden Best Practices helfen Ihnen dabei, ein Meet-Add-on zu erstellen. noch intuitiver und ausgefeilter.

Startstatus in der Seitenleiste verwalten

Wir empfehlen Ihnen dringend, Ihr Add-on basierend auf Nutzeraktionen in der Seitenleiste. Hierzu wird die Zusammenarbeit Bundesland in JavaScript Alle Daten, die in die CollaborationStartingState sollte vom Initiator des Add-ons festgelegt werden (in der Regel Organisator der Videokonferenz) in der Seitenleiste. Stellen Sie sich die erste Ansicht des Seitenleiste als Formular verwenden, über das die Einrichtung Ihres Add-on.

Seitenleiste schließen, wenn sie nicht verwendet wird

Nachdem Sie die Aktivität durch Aufrufen startCollaboration, sollten Sie nur die Seitenleiste wenn sie ein wesentlicher Bestandteil der User Experience Google Meet-Add-on. Sie können die Seitenleiste schließen, sobald Sie den Hauptbildschirm Phase durch Aufrufen von unloadSidePanel

Meet-Add-on über die Bildschirmfreigabe bewerben

Meet-Add-ons bieten mehr Funktionen als die Bildschirmfreigabe. Viele Nutzer sind jedoch daran gewöhnt, die Bildschirmfreigabe in Meet zu verwenden. . Wenn ein Nutzer einen Tab mit der Website teilt, auf der Ihr Meet-Add-on, Meet kann konfiguriert werden für Allen Anrufteilnehmern ein Banner mit einer Aufforderung zur Installation oder Verwendung der das entsprechende Meet-Add-on. Weitere Informationen finden Sie unter Werbung für Ihr Add-on auf dem Bildschirm Teilen von Inhalten.