Sprache und Zeitzone für einen Nutzer des Google Workspace-Add-ons abrufen

In diesem Leitfaden wird erläutert, wie ein Add-on die Sprache und Zeitzone eines Nutzers abrufen und dann anhand dieser Informationen seine Oberfläche und sein Verhalten anpassen kann. Eine Anleitung speziell für Google Apps Script finden Sie in der Entwicklerdokumentation zu Apps Script unter Sprache und Zeitzone des Nutzers abrufen.

Bereitstellungsressource des Add-ons konfigurieren

Damit ein Add-on die Sprache und Zeitzone eines Nutzers abrufen kann, müssen Sie die Bereitstellungsressource des Add-ons konfigurieren:

  1. Legen Sie in der Bereitstellungsressource des Add-ons das Feld addOns.common.useLocaleFromApp auf true fest.
  2. Fügen Sie den Autorisierungsbereich https://www.googleapis.com/auth/script.locale der oauthScopes-Liste der Bereitstellungsressource hinzu. Mit diesem Bereich erhält der Nutzer durch das Add-on die Berechtigung, sein Land, seine Sprache und seine Zeitzone aufzurufen.
  3. Speichern Sie die aktualisierte Bereitstellungsressource.

Nachdem Sie der Liste oauthScopes des Add-ons einen Bereich hinzugefügt haben, müssen Nutzer das Add-on bei der nächsten Verwendung noch einmal autorisieren.

Informationen zu Sprache und Zeitzone abrufen

Ereignisobjekte enthalten Informationen zum Gebietsschema des Nutzers, die Sie über die folgenden commonEventObject-Attribute abrufen können:

  • commonEventObject.userLocale: Sprache und Land oder Regionskennung des Nutzers Beispielsweise steht en-US für die in den USA gesprochene englische Sprache.
  • commonEventObject.timeZone.offset: Die Zeitzonendifferenz des Nutzers in Millisekunden von Coordinated Universal Time (UTC).
  • commonEventObject.timeZone.id: Die Zeitzonenkennung des Nutzers. Beispiel: America/New_York
  • commonEventObject.timeZone: Zeitzonen-ID und Zeitverschiebung des Nutzers.

Ereignisobjekte werden an action-Callback-, homepageTrigger- und contextualTrigger-Funktionen übergeben, wenn der Nutzer mit dem Add-on interagiert, z. B. durch Klicken auf eine Schaltfläche. Jede Callback- oder Triggerfunktion kann die Informationen zu Sprache und Zeitzone aus den Ereignisobjekten abrufen und bei Bedarf verwenden. Eine Callback-Funktion, die zu einer neuen Karte wechselt, könnte sich beispielsweise auf den Sprachstring beziehen, wenn sie entscheidet, welchen Text der Karte hinzugefügt werden soll.