Os Complementos do Google Workspace podem acessar a localidade e o fuso horário do usuário e usar
essas informações para personalizar a interface e o comportamento. É necessário configurar
o manifesto do complemento
para permitir que ele acesse
essas informações.
Configurar o manifesto do complemento
É possível configurar o complemento para acessar as informações de localidade e fuso horário do usuário
seguindo estas etapas:
No arquivo de manifesto
do complemento, defina o campo
addOns.common.useLocaleFromApp
como true.
Se ele ainda não estiver presente, adicione o seguinte escopo explícito na
lista oauthScopes
do manifesto:
https://www.googleapis.com/auth/script.locale
Se você adicionou um escopo à lista oauthScope do complemento,
os usuários vão precisar reautorizar o
complemento
na próxima vez que ele for aberto.
Receber informações de localidade e fuso horário
Os objetos de evento
transportam informações de localidade do usuário quando configurados corretamente. Os campos a seguir
aparecem na subestrutura commonEventObject
do objeto de evento:
commonEventObject.userLocale: o idioma e o identificador de país/região do usuário. Por exemplo, en-US.
commonEventObject.timeZone.offset: o fuso horário do usuário, em
milissegundos, a partir do Tempo Universal Coordenado (UTC).
commonEventObject.timeZone.id: o identificador de fuso horário do usuário.
Por exemplo, America/New_York.
commonEventObject.timeZone: o ID e o fuso horário do usuário.
Os objetos de evento são transmitidos para as
funções de callback de ação
à medida que o usuário interage com o complemento, e para a página inicial
e as funções de acionamento
contextuais. Cada função de callback ou gatilho pode ler as
informações de localidade e fuso horário do objeto de evento e usá-las conforme necessário.
Por exemplo, uma função de callback que
navega para um novo card
pode se referir à string de localidade ao decidir qual texto adicionar ao card.
[null,null,["Última atualização 2024-12-22 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-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."]]],["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"]]
