Si ya creaste 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 y luego instalar.
Puedes transferir la nueva funcionalidad a tu complemento original para conservar tu ficha de Google Workspace Marketplace, las instalaciones y los usuarios. La actualización también te permite aprovechar las nuevas funciones de complemento de Google Workspace, como las páginas principales.
Paso 1: Haga una copia del proyecto de Apps Script de su 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 los usuarios existentes no se vean afectados mientras pruebas la versión actualizada. Actualizar una copia del proyecto de secuencia de comandos original también significa que siempre puedes acceder al código original y puedes volver a implementarlo más tarde si es necesario.
- Abre el complemento de Gmail o el proyecto de Apps Script del complemento de Gmail existente.
- 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 existente publicado en complementos de Apps Script.
- Haz clic en Establecer proyecto.
Paso 2: Integra las funciones del complemento de Google Workspace
Debes diseñar e implementar las funciones del complemento de Google Workspace que desees agregar al complemento.
- Planifica el contenido que se 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 deseas una página principal en más de un host, decide si puede ser la misma página principal o si deseas tarjetas personalizadas en la página principal para cada host.
- En el proyecto que copiaste del complemento de Apps Script, compila las tarjetas de la página principal con las funciones
homepageTrigger. Asegúrate de incluir todas las funciones o lógica de respaldo 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 el acceso a los objetos de eventos en tu complemento (en las funciones de devolución de llamada de widgets o en las funciones de activación contextual) para usar la estructura de objetos de eventos actualizada. La estructura nueva aún contiene los mismos campos de objeto de evento que usan los complementos de conferencia de Gmail y Calendario, pero esos campos originales dejaron de estar disponibles y, con el tiempo, se quitarán.
Paso 3: Actualiza el manifiesto de tu 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 de la estructura que usan los complementos de Gmail y Calendario para conferencias. A medida que actualizas el complemento, debes actualizar los campos del manifiesto del proyecto de Apps Script del complemento de acuerdo con las tablas que aparecen 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 del complemento de Google Workspace, consulta Manifiestos.
Complementos de Gmail
| Campo del manifiesto original | Acción obligatoria |
|---|---|
gmail.composeTrigger |
Mover a addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Mueve la lista a addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Mover a addOns.common.logoUrl. |
gmail.name |
Mover a addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Mueve la lista a addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Mover a addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Mover a addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Mueve la lista a addOns.common.universalActions[]. |
gmail.universalActions[].text |
Mueve cada campo gmail.universalActions[].text al campo addOns.common.universalActions[].label correspondiente. |
gmail.useLocalFromApp |
Mover a addOns.common.useLocaleFromApp. |
Complementos de la conferencia de Calendario
| Campo del manifiesto original | Acción obligatoria |
|---|---|
calendar.createSettingsUrlFunction |
Mover a addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Mover a addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Mover a addOns.common.logoUrl. |
calendar.name |
Mover a addOns.common.name. |
Paso 4: Pruebe el complemento actualizado
Para probar el complemento actualizado antes de la publicación, consulta Prueba los complementos de Google Workspace.
Paso 5: Solicita revisiones del complemento actualizado
Todos los complementos de Google Workspace, ya sea un complemento actualizado o uno compilado desde cero, deben aprobarse para que puedan aparecer en Google Workspace Marketplace.
Sigue estos pasos para enviar tu complemento a revisión:
Asegúrate de que el complemento cumpla con todos los requisitos de publicación del complemento.
Crea una implementación con versión del complemento de Google Workspace (en el nuevo proyecto de Apps Script) mediante la versión del código que deseas publicar. No intentes publicar con una implementación principal.
Si agregaste permisos nuevos mientras actualizabas tu complemento, debes solicitar la verificación de OAuth. Por ejemplo, si tu complemento de Gmail usa alcances nuevos de Drive o Calendario en la versión del complemento de Google Workspace, debes enviar esos permisos nuevos para la verificación. La verificación suele demorar unos días en completarse, así que comienza el proceso lo antes posible. Asegúrate de que el complemento esté verificado antes de continuar con el paso 6.
Paso 6: Haz que tu 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 proporcionas 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 ID de implementación nuevo que creaste para tu complemento de Google Workspace en el paso anterior. Si tu ID de implementación es válido, aparecerá una lista de hosts compatibles.
Si agregaste alcances nuevos al complemento de Google Workspace, asegúrate de agregarlos a la sección Alcances de OAuth 2.0 en la página Configuración. Los alcances que se indican en esa sección deben coincidir exactamente con los alcances enumerados en el manifiesto de tu complemento.
Verifique que la información que ingresó en el formulario sea correcta. Luego, haz clic en Guardar cambios.
Si tienes preguntas o encuentras un problema durante este proceso de actualización del complemento de Google Workspace, comunícate con nosotros.
Preguntas frecuentes
Las siguientes son preguntas frecuentes sobre las actualizaciones de complementos:
¿Puedo actualizar mi complemento de editor?
La mayoría de los complementos de Editores se pueden trasladar a los complementos de Google Workspace. Sin embargo, no se pueden actualizar a los complementos de Google Workspace con la misma facilidad que los complementos de Gmail y 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 la tarjeta. Por ejemplo, si tu complemento de Editor incluye un selector de archivos, no habrá un equivalente disponible en el Servicio de tarjetas de los complementos de Google Workspace.
¿Puedo crear un complemento independiente de Google Workspace y conservar mi complemento existente?
Puedes crear complementos de Google Workspace adicionales con diferentes nombres de marca, pero no permitimos complementos de reunión de Gmail o Calendario que tengan el mismo nombre de marca que el complemento de Google Workspace. Si tienes alguna pregunta o deseas solicitar una excepción, comunícate con nosotros.
¿Mis usuarios deberán volver a autorizar el complemento después de actualizarlo?
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 tendrán que volver a autorizar los permisos que autorizaron antes para el complemento original. Sin embargo, si agregas permisos nuevos durante el proceso de actualización, los usuarios deben autorizar esos alcances nuevos la primera vez que usen la versión de Google Workspace del complemento.
¿Puedo actualizar mi extensión de Chrome a un complemento de Google Workspace y transferir usuarios?
No. No puedes transferir a los usuarios, las instalaciones ni las fichas de fichas 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 enumerar las integraciones de apps.