Si ya compilaste y publicaste un complemento para extender Gmail o Calendario, puedes actualizarlo a un complemento de Google Workspace. En las instrucciones de esta página, se detalla cómo agregar la funcionalidad de Google Workspace a tus complementos existentes de Gmail o Calendario y, luego, publicar el complemento actualizado para que se pueda descubrir e instalar.
Puedes transferir la nueva funcionalidad a tu complemento original para conservar tu ficha, tus instalaciones y tus usuarios de Google Workspace Marketplace. La actualización también te permite aprovechar las nuevas funciones de complementos de Google Workspace, como las páginas principales.
Paso 1: Crea una copia del proyecto de Apps Script de tu complemento
El complemento actualizado usa el mismo proyecto de Google Cloud que el complemento publicado, pero es importante crear y usar una copia del proyecto subyacente de Apps Script para que tus usuarios existentes no se vean afectados mientras pruebas la versión actualizada. La actualización de una copia del proyecto de secuencia de comandos original también significa que siempre puedes acceder al código original y volver a implementarlo más adelante si es necesario.
- Abre tu proyecto de Apps Script existente del complemento de Gmail o del complemento de conferencias de Calendario.
- A la izquierda, haz clic en Descripción general .
- A la derecha, haz clic en Crear una copia .
- A la izquierda, haz clic en Configuración del proyecto > Cambiar proyecto.
- Haz clic en Número de proyecto de GCP.
- Ingresa el mismo número de proyecto asociado con tu proyecto de Apps Script de complemento existente y publicado.
- Haz clic en Establecer el proyecto.
Paso 2: Integra el complemento de Google Workspace
Debes diseñar e implementar las funciones de complementos de Google Workspace que desees agregar a tu complemento.
- Planifica qué contenido mostrar en las tarjetas de la página principal de tu complemento y si deben aparecer en Gmail, Calendario, Drive o cualquier combinación de los tres hosts. Si quieres tener una página principal en más de un host, decide si puede ser la misma página principal o si quieres tarjetas de página principal personalizadas para cada host.
- En el proyecto de Apps Script del complemento copiado, compila las tarjetas de la página principal con las funciones
homepageTrigger. Asegúrate de incluir las funciones o la lógica de compatibilidad necesarias para controlar las nuevas interfaces de la página principal. Considera agregar tarjetas contextuales activadas por la acción de un usuario, como abrir una conversación de mensajes de Gmail o un evento de Calendario.
Actualiza cualquier acceso a los objetos de evento en tu complemento (en las funciones de devolución de llamada del widget o en las funciones de activador contextual) para usar la estructura del objeto de evento actualizada. La nueva estructura aún contiene los mismos campos de objetos de eventos que usan los complementos de conferencias de Gmail y Calendario, pero esos campos originales dejarán de estar disponibles y, con el tiempo, se quitarán.
Paso 3: Actualiza el manifiesto del complemento
La forma en que se almacena la información de configuración en la estructura del manifiesto de los complementos de Google Workspace cambió considerablemente con respecto a la estructura que usan los complementos de Gmail y los complementos de conferencias de Calendario. A medida que actualizas el complemento, debes actualizar los campos del manifiesto del proyecto de Apps Script según las tablas que se indican a continuación. Debes actualizar todas las subpropiedades relevantes a la nueva propiedad addOns.
Asegúrate de actualizar también el campo oauthScopes de tu manifiesto según sea necesario para reflejar los permisos que requiere el complemento actualizado.
Para obtener más información sobre los manifiestos de complementos de Google Workspace, consulta Manifiestos.
Complementos de Gmail
| Campo de manifiesto original | Acción obligatoria |
|---|---|
gmail.composeTrigger |
Se movió a addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Mueve la lista a addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Se movió a addOns.common.logoUrl. |
gmail.name |
Se movió a addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Mueve la lista a addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Se movió a addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Se movió a addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Mueve la lista a addOns.common.universalActions[]. |
gmail.universalActions[].text |
Mueve cada campo gmail.universalActions[].text a un campo addOns.common.universalActions[].label correspondiente. |
gmail.useLocalFromApp |
Se movió a addOns.common.useLocaleFromApp. |
Complementos de conferencias de Calendario
| Campo de manifiesto original | Acción obligatoria |
|---|---|
calendar.createSettingsUrlFunction |
Se movió a addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Se movió a addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Se movió a addOns.common.logoUrl. |
calendar.name |
Se movió a addOns.common.name. |
Paso 4: Prueba el complemento actualizado
Para probar el complemento actualizado antes de publicarlo, consulta Cómo probar complementos de Google Workspace.
Paso 5: Solicita opiniones sobre tu complemento actualizado
Todos los complementos de Google Workspace, ya sean actualizados o creados desde cero, deben aprobarse para que se puedan publicar en Google Workspace Marketplace.
Sigue estos pasos para enviar tu complemento para su revisión:
Asegúrate de que tu complemento cumpla con todos los requisitos de publicación de complementos.
Crea una implementación con control de versiones de tu complemento de Google Workspace (en el nuevo proyecto de Apps Script) con la versión del código que deseas publicar. No intentes publicar con una implementación principal.
Si agregaste permisos nuevos mientras actualizabas el complemento, debes solicitar la verificación de OAuth. Por ejemplo, si tu complemento de Gmail usa nuevos permisos de Drive o Calendario en la versión del complemento de Google Workspace, debes enviar esos permisos nuevos para su verificación. La verificación suele tardar unos días en completarse, por lo que debes comenzar el proceso lo antes posible. Asegúrate de que el complemento esté verificado antes de continuar con el paso 6.
Paso 6: Haz que el complemento actualizado esté disponible
Abre el SDK de Google Workspace Marketplace.
A la izquierda, haz clic en Configuración. Este panel contiene un formulario en el que debes proporcionar información sobre tu complemento.
Actualiza la descripción breve, la descripción detallada y las capturas de pantalla de tu ficha para reflejar la nueva funcionalidad del complemento de Google Workspace.
En Extensiones, haz clic en el botón Actualizar a complemento de Google Workspace. En el cuadro de texto que aparece, ingresa el nuevo ID de implementación que creaste para tu complemento de Google Workspace en el paso anterior. Si el ID de implementación es válido, aparecerá una lista de hosts compatibles.
Si agregaste nuevos permisos a tu complemento de Google Workspace, asegúrate de agregarlos a la sección OAuth 2.0 scopes en la página Configuration. Los permisos que se enumeran en esa sección deben coincidir exactamente con los que se indican en el manifiesto de tu complemento.
Verifica que la información que ingresaste en el formulario sea correcta. Luego, haz clic en Guardar cambios.
Si tienes preguntas o encuentras un problema durante este proceso de actualización de complementos de Google Workspace, comunícate con nosotros.
Preguntas frecuentes
A continuación, se incluyen algunas preguntas frecuentes sobre las actualizaciones de complementos:
¿Puedo actualizar mi complemento de Editor?
La mayoría de los complementos de Editor se pueden transferir a los complementos de Google Workspace. Sin embargo, no se pueden actualizar a complementos de Google Workspace tan fácilmente como los complementos de Gmail y el Calendario.
Si deseas migrar tu complemento de Editor a un complemento de Google Workspace, debes reescribir la IU del complemento de HTML a una interfaz basada en tarjetas y actualizar el control de JavaScript al Servicio de tarjetas.
Es posible que algunos servicios de tu complemento de Editor existente no estén disponibles en el servicio de tarjetas. Por ejemplo, si tu complemento de Editor incluye un selector de archivos, no hay un equivalente disponible en el servicio de tarjetas para complementos de Google Workspace.
¿Puedo compilar un complemento de Google Workspace independiente y conservar el existente?
Puedes crear complementos adicionales de Google Workspace con diferentes nombres de marca, pero no permitimos complementos de conferencias de Gmail o Calendario independientes con el mismo nombre de marca que tu complemento de Google Workspace. Si tienes preguntas o quieres solicitar una excepción, comunícate con nosotros.
¿Mis usuarios deberán volver a autorizar el complemento después de que se actualice?
Siempre que tu complemento de Google Workspace use el mismo proyecto de Cloud Platform (GCP) subyacente con un ID de cliente de OAuth asociado, tus usuarios no necesitarán volver a autorizar los permisos que autorizaron anteriormente para tu complemento original. Sin embargo, si agregas nuevos permisos durante el proceso de actualización, tus usuarios deberán autorizarlos la primera vez que usen la versión de Google Workspace de tu complemento.
¿Puedo actualizar mi extensión de Chrome a un complemento de Google Workspace y transferir usuarios?
No. No puedes transferir los usuarios, las instalaciones ni las opiniones de la ficha de una extensión de Chrome. Debes crear un nuevo complemento de Google Workspace y dirigir a los usuarios de tu extensión de Chrome a Google Workspace Marketplace.
¿Puedo agrupar varios complementos con mi complemento de Google Workspace?
Consulta Cómo mostrar todas las integraciones de apps.