Acceso a la configuración regional y la zona horaria del usuario

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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:

  1. En el archivo de manifiesto del 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 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.