Recuperare le impostazioni internazionali e il fuso orario di un utente del componente aggiuntivo di Google Workspace

Questa guida spiega in che modo un componente aggiuntivo può recuperare l'area geografica e il fuso orario di un utente e utilizzare queste informazioni per personalizzarne l'interfaccia e il comportamento. Per una guida specifica per Google Apps Script, consulta l'articolo su come recuperare le impostazioni internazionali e il fuso orario dell'utente nella documentazione per gli sviluppatori di Apps Script.

Configura la risorsa di deployment del componente aggiuntivo

Per consentire a un componente aggiuntivo di recuperare le impostazioni internazionali e il fuso orario di un utente, configura la risorsa di deployment del componente aggiuntivo:

1. Nella risorsa di deployment del componente aggiuntivo, imposta il campo addOns.common.useLocaleFromApp su true.
2. Aggiungi l'ambito di autorizzazione https://www.googleapis.com/auth/script.locale all'elenco oauthScopes della risorsa di deployment. Questo ambito concede al componente aggiuntivo l'autorizzazione dell'utente a visualizzare il paese, la lingua e il fuso orario.
3. Salva la risorsa di deployment aggiornata.

Dopo aver aggiunto un ambito all'elenco oauthScopes del componente aggiuntivo, gli utenti devono autorizzare di nuovo il componente aggiuntivo al successivo utilizzo.

Recuperare informazioni sulle impostazioni internazionali e sul fuso orario

Gli oggetti evento includono informazioni sulle impostazioni internazionali dell'utente, che puoi ottenere dalle seguenti proprietà commonEventObject:

• commonEventObject.userLocale: l'identificatore della lingua e del paese o della regione dell'utente. Ad esempio, en-US rappresenta la lingua inglese parlata negli Stati Uniti.
• commonEventObject.timeZone.offset: differenza del fuso orario dell'utente, in millisecondi, rispetto al fuso orario UTC (Coordinated Universal Time).
• commonEventObject.timeZone.id: identificatore del fuso orario dell'utente. Ad esempio, America/New_York.
• commonEventObject.timeZone: ID fuso orario e offset dell'utente.

Gli oggetti evento vengono passati alle funzioni di callback di action, homepageTrigger e contextualTrigger mentre l'utente interagisce con il componente aggiuntivo, ad esempio facendo clic su un pulsante. Ogni funzione di callback o di attivazione può recuperare le informazioni relative a località e fuso orario dagli oggetti evento e utilizzarle in base alle esigenze. Ad esempio, una funzione di callback che apre una nuova scheda potrebbe fare riferimento alla stringa delle impostazioni internazionali quando decidi quale testo aggiungere alla scheda.