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 di utilizzarlo queste informazioni per personalizzare l'interfaccia e il comportamento. Devi configurare il file manifest del tuo componente aggiuntivo per consentire al tuo componente aggiuntivo di accedere queste informazioni.

Configurare il manifest dei componenti aggiuntivi

Puoi configurare il componente aggiuntivo per accedere alle impostazioni internazionali dell'utente e informazioni sul fuso orario con i seguenti passaggi:

1. Nel file manifest del componente aggiuntivo imposta il addOns.common.useLocaleFromApp su true.
2. Se non è già presente, aggiungi il seguente ambito esplicito nella oauthScopes del file manifest elenco: https://www.googleapis.com/auth/script.locale

Se hai aggiunto un ambito all'elenco oauthScope del componente aggiuntivo, gli utenti devono autorizzare di nuovo il componente aggiuntivo alla successiva apertura.

Ricevere informazioni sulle impostazioni internazionali e sul fuso orario

Oggetti evento includere informazioni sulle impostazioni internazionali dell'utente se configurate correttamente. I seguenti campi vengono visualizzati in commonEventObject sottostruttura dell'oggetto evento:

• commonEventObject.userLocale: la lingua e il paese/la regione dell'utente. identificativo dell'utente. Ad esempio, en-US.
• commonEventObject.timeZone.offset: la differenza del fuso orario dell'utente, in millisecondi, dal fuso orario UTC (Coordinated Universal Time).
• commonEventObject.timeZone.id: l'identificatore del fuso orario dell'utente. Ad esempio, America/New_York.
• commonEventObject.timeZone: l'ID fuso orario e l'offset dell'utente.

Consulta Oggetti evento per ulteriori dettagli.

Gli oggetti evento vengono passati funzioni di callback delle azioni quando l'utente interagisce con il tuo componente aggiuntivo e alla home page e contestuali di trigger. Ogni funzione di callback o di trigger può leggere le informazioni sulle impostazioni internazionali e sul fuso orario dell'oggetto evento e utilizzarle in base alle esigenze. Ad esempio, una funzione di callback la navigazione verso una nuova carta potrebbe fare riferimento alla stringa delle impostazioni internazionali per decidere quale testo aggiungere alla scheda.