Obtén la configuración regional y la zona horaria del usuario

Los complementos de Google Workspace pueden acceder a la configuración regional y la zona horaria del usuario y usar esa información para personalizar su interfaz y comportamiento. Debes configurar el manifiesto de tu complemento para permitir que tu complemento acceda esta información.

Cómo configurar el manifiesto del complemento

Puedes configurar tu complemento para que acceda a la configuración regional del usuario información de la zona horaria sigue estos pasos:

1. En el manifiesto de tu complemento de Terraform, configura la addOns.common.useLocaleFromApp en true.
2. Si aún no está presente, agrega el siguiente alcance explícito en el oauthScopes del manifiesto lista: https://www.googleapis.com/auth/script.locale

Si agregaste un permiso a la lista oauthScope del complemento, los usuarios deben volver a autorizar a complemento la próxima vez que se abra.

Nota: Si el complemento ya usaba el la API de Calendar El servicio de Calendario de Apps Script o cualquier otro servicio para acceder a la configuración regional y la zona horaria del usuario, considera si todavía necesite tu complemento. De lo contrario, quítala cualquier alcance que el servicio requiera de tu . Siempre limita tu lista de permisos solo a aquellos servicios que tu o complementos.

Obtén información sobre la configuración regional y la zona horaria

Objetos de evento contienen información sobre la configuración regional del usuario cuando se configuran correctamente. Los siguientes campos aparecerán en la commonEventObject subestructura del objeto de evento:

• commonEventObject.userLocale: El idioma y el país o región del usuario identificador. Por ejemplo, en-US
• commonEventObject.timeZone.offset: el desplazamiento de zona horaria del usuario, en milisegundos, desde la hora universal coordinada (UTC)
• commonEventObject.timeZone.id: Es el identificador de zona horaria del usuario. Por ejemplo, America/New_York
• commonEventObject.timeZone: Indica el ID y la compensación de la zona horaria del usuario.

Consulta Objetos de evento. para obtener más información.

Los objetos de evento se pasan a funciones de devolución de llamada de acción a medida que el usuario interactúa con tu complemento y a la página principal y el contexto, funciones de activación. Cada función de activación o devolución de llamada puede leer el información regional y de zona horaria del objeto de evento, y usarla según sea necesario. Por ejemplo, una función de devolución de llamada que se navegar a una nueva tarjeta hacer referencia a la cadena de configuración regional al decidir qué texto agregar a la tarjeta.