Os complementos podem acessar a localidade e o fuso horário do usuário, além de usar essas informações para personalizar a interface e o comportamento. Você precisa configurar o manifesto do complemento para permitir que ele acesse essas informações.
Configurar o manifesto do complemento
Você pode configurar seu complemento para acessar informações de local e fuso horário do usuário com estas etapas:
- No arquivo manifest do complemento, defina o campo
addOns.common.useLocaleFromAppcomotrue. - Se ainda não estiver presente, adicione o seguinte escopo explícito à
lista
oauthScopesdo manifesto:https://www.googleapis.com/auth/script.locale - Salve as mudanças no 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 conseguir informações de local e fuso horário
Os objetos de evento
carregam as informações de localidade do usuário quando configuradas corretamente. Os campos a seguir
aparecem na subestrutura commonEventObject
do objeto de evento:
commonEventObject.userLocale: o idioma do usuário e o identificador do país/região. Por exemplo,en-US.commonEventObject.timeZone.offset: a diferença de fuso horário do usuário, em milissegundos, 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 deslocamento e o ID de fuso horário do usuário.
Consulte Objetos de evento para mais detalhes.
Os objetos de evento são transmitidos para funções de callback de ação conforme o usuário interage com o complemento e as funções de acionador inicial e de contexto. 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 está navegando para um novo cartão pode se referir à string de localidade ao decidir qual texto adicionar ao cartão.