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 utilizzare queste informazioni per personalizzare l'interfaccia e il comportamento. Devi configurare il manifest del tuo componente aggiuntivo per consentirgli di accedere a queste informazioni.
Configurare il manifest del componente aggiuntivo
Puoi configurare il tuo componente aggiuntivo in modo che acceda alle informazioni sul fuso orario e sulle impostazioni internazionali dell'utente seguendo questa procedura:
Nel file manifest del componente aggiuntivo, imposta il campo addOns.common.useLocaleFromApp su true.
Se non è già presente, aggiungi il seguente ambito esplicito nell'elenco oauthScopes del manifest:
https://www.googleapis.com/auth/script.locale
Se hai aggiunto un ambito all'elenco oauthScope del componente aggiuntivo,
gli utenti devono autorizzarlo di nuovo la
prossima volta che lo aprono.
Visualizzare le informazioni sulla lingua e sul fuso orario
Gli oggetti evento contengono le informazioni sulla locale dell'utente se sono configurati correttamente. I seguenti campi
appaiono 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: l'offset del fuso orario dell'utente, in millisecondi, rispetto al tempo universale coordinato (UTC).
commonEventObject.timeZone.id: l'identificatore del fuso orario dell'utente.
Ad esempio, America/New_York.
commonEventObject.timeZone: l'ID e l'offset del fuso orario dell'utente.
Gli oggetti evento vengono passati alle funzioni di callback dell'azione quando l'utente interagisce con il tuo componente aggiuntivo e alle funzioni di attivazione della home page e contestuali. Ogni funzione di callback o trigger può leggere le informazioni sulla lingua e sul fuso orario dall'oggetto evento e utilizzarle in base alle necessità.
Ad esempio, una funzione di callback che passa a una nuova scheda potrebbe fare riferimento alla stringa locale per decidere quale testo aggiungere alla scheda.
[null,null,["Ultimo aggiornamento 2025-06-05 UTC."],[[["\u003cp\u003eGoogle Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization.\u003c/p\u003e\n"],["\u003cp\u003eAdd-on developers must set \u003ccode\u003eaddOns.common.useLocaleFromApp\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e and include the \u003ccode\u003ehttps://www.googleapis.com/auth/script.locale\u003c/code\u003e scope in the manifest file for locale and timezone access.\u003c/p\u003e\n"],["\u003cp\u003eEvent objects provide the user's locale and timezone information through fields like \u003ccode\u003euserLocale\u003c/code\u003e, \u003ccode\u003etimeZone.offset\u003c/code\u003e, and \u003ccode\u003etimeZone.id\u003c/code\u003e, which add-ons can utilize in their functions.\u003c/p\u003e\n"],["\u003cp\u003eAfter adding the necessary scope, users need to re-authorize the add-on for the changes to take effect.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services.\u003c/p\u003e\n"]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"],null,["# Get user locale and timezone\n\nGoogle Workspace add-ons can access the locale and timezone of its user and use\nthat information to customize its interface and behavior. You must configure\nyour add-on's [manifest](/workspace/add-ons/concepts/workspace-manifests)\nto permit your add-on to access\nthis information.\n\nConfigure the add-on manifest\n-----------------------------\n\nYou can configure your add-on to access user locale and\ntimezone information\nwith the following steps:\n\n1. In your add-on's [manifest](/workspace/add-ons/concepts/workspace-manifests) file, set the `addOns.common.useLocaleFromApp` field to `true`.\n2. If it isn't present already, add the following explicit scope in the manifest's `oauthScopes` list: `https://www.googleapis.com/auth/script.locale`\n\nIf you added a scope to the add-on's `oauthScope` list,\nusers must [re-authorize](/workspace/add-ons/how-tos/authorizing-addons) the\nadd-on\nthe next time it is opened.\n| **Note:** If your add-on previously used the [Calendar API](/workspace/calendar/api/v3/reference/settings), the Apps Script [Calendar service](/apps-script/reference/calendar), or other service to access the user's locale and timezone, consider whether that service is still needed by your add-on. If not, remove any scopes that service requires from your manifest. Always limit your scope list to only those services that your add-on needs.\n\nGet locale and timezone information\n-----------------------------------\n\n[Event objects](/workspace/add-ons/concepts/event-objects)\ncarry user locale information when properly configured. The following fields\nappear in the [`commonEventObject`](/workspace/add-ons/concepts/event-objects#common_event_object)\nsubstructure of the event object:\n\n- `commonEventObject.userLocale`---The user's language and country/region identifier. For example, `en-US`.\n- `commonEventObject.timeZone.offset`---The user's timezone offset, in milliseconds, from Coordinated Universal Time (UTC).\n- `commonEventObject.timeZone.id`---The user's timezone identifier. For example, `America/New_York`.\n- `commonEventObject.timeZone`---The user's timezone ID and offset.\n\nSee [Event objects](/workspace/add-ons/concepts/event-objects)\nfor more details.\n\n[Event objects](/workspace/add-ons/concepts/event-objects) are passed to\n[action callback functions](/workspace/add-ons/concepts/actions#callback_functions)\nas the user interacts with your add-on, and to homepage\nand contextual\ntrigger functions. Each callback or trigger function can read the\nlocale and timezone information from the event object and use it as necessary.\nFor example, a callback function that is\n[navigating to a new card](/workspace/add-ons/how-tos/navigation#navigation_methods)\ncould refer to the locale string when deciding what text to add to the card."]]
