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:
- Legen Sie in der Bereitstellungsressource des Add-ons das Feld
addOns.common.useLocaleFromApp
auftrue
fest. - Fügen Sie den Autorisierungsbereich
https://www.googleapis.com/auth/script.locale
deroauthScopes
-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. - 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 stehten-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.