Visualizza le impostazioni internazionali e il fuso orario dell'utente
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
I componenti aggiuntivi di Google Workspace possono accedere alle impostazioni internazionali e al fuso orario dell'utente e utilizzare queste informazioni per personalizzare l'interfaccia e il comportamento. Devi configurare il manifest del tuo componente aggiuntivo per consentirgli di accedere a queste informazioni.
Configurare il manifest del componente aggiuntivo
Puoi configurare il tuo componente aggiuntivo in modo che acceda alle informazioni sul fuso orario e sulle impostazioni internazionali dell'utente seguendo questa procedura:
Nel file manifest del componente aggiuntivo, imposta il campo addOns.common.useLocaleFromApp su true.
Se non è già presente, aggiungi il seguente ambito esplicito nell'elenco oauthScopes del manifest:
https://www.googleapis.com/auth/script.locale
Se hai aggiunto un ambito all'elenco oauthScope del componente aggiuntivo,
gli utenti devono autorizzarlo di nuovo la
prossima volta che lo aprono.
Ottenere informazioni su impostazioni internazionali e fuso orario
Gli oggetti evento contengono informazioni sulla locale dell'utente se sono configurati correttamente. I seguenti campi
appaiono nella sottostruttura commonEventObject
dell'oggetto evento:
commonEventObject.userLocale: l'identificatore della lingua e del paese/della regione dell'utente. Ad esempio, en-US.
commonEventObject.timeZone.offset: l'offset del fuso orario dell'utente, in millisecondi, rispetto al tempo universale coordinato (UTC).
commonEventObject.timeZone.id: l'identificatore del fuso orario dell'utente.
Ad esempio, America/New_York.
commonEventObject.timeZone: l'ID e l'offset del fuso orario dell'utente.
Gli oggetti evento vengono passati alle funzioni di callback dell'azione quando l'utente interagisce con il tuo componente aggiuntivo e alle funzioni di attivazione della home page e contestuali. Ogni funzione di callback o trigger può leggere le informazioni sulla lingua e sul fuso orario dall'oggetto evento e utilizzarle in base alle necessità.
Ad esempio, una funzione di callback che passa a una nuova scheda potrebbe fare riferimento alla stringa locale per decidere quale testo aggiungere alla scheda.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-12-22 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
