Obtén la configuración regional y la zona horaria del usuario

Los complementos de Google Workspace pueden acceder a la configuración regional y la zona horaria de su usuario y usar esa información para personalizar su interfaz y comportamiento. Debes configurar el manifiesto de tu complemento para permitir que acceda a esta información.

Configura el manifiesto del complemento

Puedes configurar tu complemento para que acceda a la configuración regional del usuario y a la información de zona horaria con los siguientes pasos:

  1. En el archivo de manifiesto del complemento, configura el campo addOns.common.useLocaleFromApp como true.
  2. Si aún no está presente, agrega el siguiente permiso explícito en la lista oauthScopes del manifiesto: https://www.googleapis.com/auth/script.locale

Si agregaste un permiso a la lista oauthScope del complemento, los usuarios deben 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 configuración regional del usuario cuando se configuran correctamente. Los siguientes campos aparecen en la subestructura commonEventObject del objeto del evento:

  • commonEventObject.userLocale: Es el identificador de idioma y país o región del usuario. Por ejemplo, en-US
  • commonEventObject.timeZone.offset: Es la desviación de la zona horaria del usuario, en milisegundos, desde 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 la compensación de la zona horaria del usuario.

Consulta Objetos de evento para obtener más detalles.

Los objetos de evento se pasan a las funciones de devolución de llamada de acción a medida que el usuario interactúa con tu complemento, y a las funciones de activación de la página principal y contextuales. Cada devolución de llamada o función de activador puede leer la información de configuración regional y zona horaria del objeto del 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 cuando decida qué texto agregar a la tarjeta.