Los complementos pueden acceder a la configuración regional y a 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 este acceda a esa información.
Cómo configurar el manifiesto del complemento
Puedes configurar el complemento para acceder a la información de la configuración regional y la zona horaria del usuario mediante los siguientes pasos:
- En el archivo manifiesto de tu 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 en el manifiesto.
Si agregaste un permiso a la lista oauthScope
del complemento, los usuarios deberán volver a autorizar el complemento la próxima vez que se abra.
Cómo obtener información de configuración regional y zona horaria
Los objetos de evento contienen información de la configuración regional del usuario cuando se configuran de forma correcta. Los siguientes campos aparecen en la subestructura commonEventObject
del objeto de evento:
commonEventObject.userLocale
: Es el identificador de idioma y país o región del usuario. Por ejemplo,en-US
commonEventObject.timeZone.offset
: El desplazamiento de la zona horaria del usuario, en milisegundos, con respecto al tiempo universal coordinado (UTC).commonEventObject.timeZone.id
: Es el identificador de zona horaria del usuario. Por ejemplo,America/New_York
commonEventObject.timeZone
: Indica el ID de zona horaria y el desplazamiento del usuario.
Consulta Objetos de evento para obtener más detalles.
Los objetos de eventos se pasan a las funciones de devolución de llamada de acción a medida que el usuario interactúa con el complemento y a la página principal y a las funciones del activador contextual. Cada devolución de llamada o función de 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 navega a una tarjeta nueva podría hacer referencia a la string de configuración regional para decidir qué texto agregar a la tarjeta.