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.useLocaleFromAppcomotrue. - Se ele ainda não estiver presente, adicione o seguinte escopo explícito na
lista
oauthScopesdo 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.
Consulte Objetos de evento para mais detalhes.
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.