Accesso alle impostazioni internazionali e al fuso orario dell'utente

I componenti aggiuntivi possono accedere alle impostazioni internazionali e al fuso orario dell'utente e utilizzare queste informazioni per personalizzarne l'interfaccia e il comportamento. Per consentire al componente aggiuntivo di accedere a queste informazioni, devi configurare il manifest del componente aggiuntivo.

Configurare il manifest del componente aggiuntivo

Per configurare il componente aggiuntivo in modo che acceda alle informazioni sulle impostazioni internazionali e sul fuso orario dell'utente:

  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 file manifest: https://www.googleapis.com/auth/script.locale
  3. Salva le modifiche del file manifest.

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

Ottenere informazioni sulle impostazioni internazionali e sul fuso orario

Gli oggetti evento, se configurati correttamente, contengono le informazioni sulle impostazioni internazionali dell'utente. I seguenti campi vengono visualizzati 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: la differenza di 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.

Per ulteriori dettagli, consulta Oggetti evento.

Gli oggetti evento vengono passati alle funzioni di callback delle azioni mentre l'utente interagisce con il componente aggiuntivo e alle funzioni della home page e dell'attivatore contestuale. Ogni funzione trigger o callback può leggere le informazioni su impostazioni internazionali e sul fuso orario dall'oggetto evento e utilizzarle in base alle esigenze. Ad esempio, una funzione di callback che naviga su una nuova scheda potrebbe fare riferimento alla stringa delle impostazioni internazionali per decidere quale testo aggiungere alla scheda.