Acessar a localidade e o fuso horário do usuário

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:

1. No arquivo de manifesto do complemento, defina o campo addOns.common.useLocaleFromApp como true.
2. 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.

Observação: se o complemento já usou a API Calendar, o serviço de calendário do Apps Script ou outro serviço para acessar a localidade e o fuso horário do usuário, considere se esse serviço ainda é necessário para o complemento. Caso contrário, remova todos os escopos que o serviço exige do manifesto. Sempre limite a lista de escopo apenas aos serviços necessários para o complemento.

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.