Cómo acceder a la configuración regional y a la zona horaria del usuario

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:

  1. En el archivo manifiesto de tu complemento, establece el campo addOns.common.useLocaleFromApp en true.
  2. 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
  3. 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.