Visualizza le impostazioni internazionali e il fuso orario dell'utente

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:

1. Nel file manifest del componente aggiuntivo, imposta il campo addOns.common.useLocaleFromApp su true.
2. 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.

Nota: se il tuo componente aggiuntivo utilizzava in precedenza l'API Calendar, il servizio Calendar di Apps Script o un altro servizio per accedere alle impostazioni internazionali e al fuso orario dell'utente, valuta se il servizio è ancora necessario per il tuo componente aggiuntivo. In caso contrario, rimuovi dal manifest tutti gli ambiti richiesti dal servizio. Limita sempre l'elenco di ambito solo ai servizi di cui ha bisogno il tuo plug-in.

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.