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 dos usuários e usar essas informações para personalizar sua interface e comportamento. Você precisa configurar o manifesto do seu complemento para permitir que o complemento acesse essas informações.

Configurar o manifesto do complemento

Você pode configurar seu complemento para acessar a localidade do usuário e informações de fuso horário siga estas etapas:

1. No manifesto do seu complemento. , defina o addOns.common.useLocaleFromApp como true.
2. Se ele ainda não estiver presente, adicione o seguinte escopo explícito no campo oauthScopes do manifesto lista: https://www.googleapis.com/auth/script.locale

Se você tiver adicionado um escopo à lista oauthScope do complemento, os usuários precisarão reautorizar o complemento na próxima vez que for aberto.

Receber informações de localidade e fuso horário

Objetos de evento transportar informações de localidade do usuário quando configuradas corretamente. Os campos a seguir aparecem no commonEventObject subestrutura do objeto de evento:

• commonEventObject.userLocale: o idioma e o país/região do usuário identificador. Por exemplo, en-US.
• commonEventObject.timeZone.offset: a diferença do 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: ID e deslocamento do fuso horário do usuário.

Consulte Objetos de evento para mais detalhes.

Os objetos de evento são passados para funções de callback de ação conforme o usuário interage com o complemento, e à página inicial e contextual de gatilho. Cada callback ou função gatilho pode ler o informações de localidade e fuso horário do objeto de evento e use-as conforme necessário. Por exemplo, uma função de retorno de chamada como acessar um novo card pode consultar a string de localidade ao decidir qual texto adicionar ao card.