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.useLocaleFromAppsutrue. - Se non è già presente, aggiungi il seguente ambito esplicito nell'elenco
oauthScopesdel 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.
Per ulteriori dettagli, consulta Oggetti evento.
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.