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 usar esa información para personalizar su interfaz y comportamiento. Debes configurar el manifiesto del complemento para permitir que el complemento acceda a esta información.

Configura 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 eventos llevan información de la configuración regional del usuario cuando se configura correctamente. Los siguientes campos aparecen en la subestructura commonEventObject del objeto de evento:

  • commonEventObject.userLocale: el identificador de idioma y país/región del usuario. como en-US.
  • commonEventObject.timeZone.offset: la compensación de zona horaria del usuario, en milisegundos, a partir de la hora universal coordinada (UTC).
  • commonEventObject.timeZone.id: el identificador de zona horaria del usuario. como America/New_York.
  • commonEventObject.timeZone: la compensación horaria y el ID de zona horaria del usuario.

Consulta Objetos de eventos para obtener más detalles.

Los objetos de evento se pasan a funciones de devolución de llamada de acción a medida que el usuario interactúa con tu complemento y a las funciones de activador contextual y de la página principal. 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 navega a una tarjeta nueva podría hacer referencia a la string de configuración regional cuando se decide qué texto agregar a la tarjeta.