En esta guía, se explica cómo un complemento puede obtener la configuración regional y la zona horaria de un usuario y, luego, usar esa información para personalizar su interfaz y comportamiento. Si quieres obtener una guía específica de Google Apps Script, consulta Cómo obtener la configuración regional y la zona horaria del usuario en la documentación para desarrolladores de Apps Script.
Configura el recurso de implementación del complemento
Para permitir que un complemento obtenga la configuración regional y la zona horaria de un usuario, configura el recurso de implementación del complemento:
- En el recurso de implementación del complemento, establece el campo
addOns.common.useLocaleFromApp
entrue
. - Agrega el permiso de autorización
https://www.googleapis.com/auth/script.locale
a la listaoauthScopes
del recurso de implementación. Este alcance le otorga al complemento permiso del usuario para ver su país, idioma y zona horaria. - Guarda el recurso de implementación actualizado.
Después de agregar un alcance a la lista oauthScopes
del complemento, los usuarios deberán volver a autorizarlo la próxima vez que lo usen.
Cómo obtener información sobre la configuración regional y la zona horaria
Los objetos de evento incluyen información de configuración regional del usuario, que puedes obtener de las siguientes propiedades de commonEventObject
:
commonEventObject.userLocale
: Es el identificador de idioma y país o región del usuario. Por ejemplo,en-US
representa el idioma inglés que se habla en los Estados Unidos.commonEventObject.timeZone.offset
: El desplazamiento de la zona horaria del usuario, en milisegundos, desde la hora universal coordinada (UTC)commonEventObject.timeZone.id
: 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.
Los objetos de evento se pasan a funciones de devolución de llamada action
, funciones de homepageTrigger
y funciones de contextualTrigger
a medida que el usuario interactúa con el complemento, por ejemplo, si hace clic en un botón. Cada función de devolución de llamada o activador puede obtener la
información de la configuración regional y la zona horaria de los
objetos 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 cadena de configuración regional para decidir qué texto agregar a la tarjeta.