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:
- Nel file manifest del componente aggiuntivo, imposta il campo
addOns.common.useLocaleFromApp
sutrue
. - Se non è già presente, aggiungi il seguente ambito esplicito nell'elenco
oauthScopes
del file manifest:https://www.googleapis.com/auth/script.locale
- 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.