Google Workspace-Add-ons können auf die Sprache und Zeitzone des Nutzers zugreifen um die Schnittstelle und das Verhalten anzupassen. Sie müssen konfigurieren das Manifest Ihres Add-ons um Ihrem Add-on den Zugriff auf diese Informationen.
Add-on-Manifest konfigurieren
Sie können Ihr Add-on so konfigurieren, dass auf Nutzersprache und Zeitzoneninformationen mit den folgenden Schritten:
- Im Manifest des Add-ons
legen Sie den Parameter
addOns.common.useLocaleFromAppauftrue. - Falls noch nicht vorhanden, fügen Sie den folgenden expliziten Bereich in der
oauthScopesdes Manifests Liste:https://www.googleapis.com/auth/script.locale
Wenn Sie der Liste oauthScope des Add-ons einen Bereich hinzugefügt haben,
müssen Nutzer die
Add-on
wenn Sie es das nächste Mal öffnen.
Informationen zum Gebietsschema und zur Zeitzone abrufen
Ereignisobjekte
bei ordnungsgemäßer Konfiguration Informationen zur Sprache des Nutzers enthalten. Die folgenden Felder
erscheinen in der commonEventObject
Unterstruktur des Event-Objekts:
commonEventObject.userLocale: Sprache und Land/Region des Nutzers Kennung. Beispiel:en-US.commonEventObject.timeZone.offset: Zeitzonenverschiebung des Nutzers in Millisekunden, ausgehend von der koordinierten Weltzeit (UTC).commonEventObject.timeZone.id: Zeitzonenkennung des Nutzers Beispiel:America/New_York.commonEventObject.timeZone: Zeitzonen-ID und Offset des Nutzers
Siehe Ereignisobjekte .
Ereignisobjekte werden an Callback-Funktionen für Aktionen wenn die Nutzenden mit Ihrem Add-on interagieren, und zur Startseite und kontextbezogene Trigger-Funktionen. Jede Callback- oder Triggerfunktion kann die Gebietsschema- und Zeitzoneninformationen aus dem Ereignisobjekt und verwenden diese nach Bedarf. Eine Callback-Funktion, die zu einer neuen Karte navigieren sich auf den Gebietsschema-String beziehen, wenn entschieden wird, welcher Text der Karte hinzugefügt werden soll.