Los complementos pueden acceder a la configuración regional y a la zona horaria del usuario, así como a usar esa información para personalizar su interfaz y comportamiento. Debes configurar el manifiesto de tu complemento para permitir que el complemento acceda a esta información.
Cómo configurar el manifiesto del complemento
Puedes configurar tu complemento para acceder a la información de la configuración regional y la zona horaria del usuario con los siguientes pasos:
- En el archivo de manifiesto del complemento, establece el campo
addOns.common.useLocaleFromApp
entrue
. - Si aún no está presente, agrega el siguiente alcance explícito en la lista
oauthScopes
del manifiesto:https://www.googleapis.com/auth/script.locale
- Guarda los cambios del manifiesto.
Si agregaste un alcance a la lista oauthScope
del complemento, los usuarios deberán volver a autorizar el complemento la próxima vez que se abra.
Obtén información sobre la configuración regional y la zona horaria
Los objetos de evento llevan información regional del usuario cuando está configurada correctamente. Los siguientes campos aparecen en la subestructura commonEventObject
del objeto de evento:
commonEventObject.userLocale
: El idioma del usuario y el identificador de país o región. Por ejemplo,en-US
commonEventObject.timeZone.offset
: el desplazamiento de zona horaria del usuario, en milisegundos, a partir de la hora universal coordinada (UTC).commonEventObject.timeZone.id
: Es el identificador de zona horaria del usuario. Por ejemplo,America/New_York
commonEventObject.timeZone
: El ID y zona horaria del usuario.
Consulta Objetos de evento para obtener más detalles.
Los objetos de eventos se pasan a funciones de devolución de llamada de acciones a medida que el usuario interactúa con el complemento y con las funciones de activador de la página principal y contextuales. Cada función de devolución de llamada o activador puede leer la información de la configuración regional y la zona horaria del objeto de evento, y usarla según sea necesario. Por ejemplo, una función de devolución de llamada que está navegando a una nueva tarjeta podría referirse a la string de configuración regional cuando decide qué texto agregar a la tarjeta.