Os complementos podem acessar a localidade e o fuso horário do usuário e usar essas informações para personalizar a interface e o comportamento dele. Você precisa configurar o manifesto do complemento para permitir que ele acesse essas informações.
Configurar o manifesto do complemento
Configure seu complemento para acessar 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
comotrue
. - Se ele ainda não estiver presente, adicione o escopo explícito abaixo à
lista
oauthScopes
do manifesto:https://www.googleapis.com/auth/script.locale
- Salve as alterações do manifesto.
Se você tiver adicionado um escopo à lista oauthScope
do complemento,
os usuários precisarão autorizar novamente o complemento
na próxima vez que ele for aberto.
Como 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 deslocamento do fuso horário do usuário, em milissegundos, em relação ao 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 deslocamento do 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 funções de acionamento contextuais. Cada função de callback ou de acionador 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 até um novo cartão pode se referir à string de localidade ao decidir qual texto adicionar ao cartão.