Obtén 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 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 del complemento para permitir que acceda a esta información.
Cómo configurar 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:
En el archivo de manifiesto del complemento, configura el campo addOns.common.useLocaleFromApp como true.
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 el desfase 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.
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-12-22 (UTC)"],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],[]]
