Visualizza le impostazioni internazionali e il fuso orario dell'utente
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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:
Nel file manifest del componente aggiuntivo
imposta il
addOns.common.useLocaleFromApp
su true.
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.
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.