Actualiza los complementos heredados de Gmail y Calendario

Nota: No es posible actualizar directamente los complementos del editor a los complementos de Google Workspace en este momento. Para obtener más información, consulta ¿Puedo actualizar mi complemento del editor?

Si ya creaste y publicaste un complemento para ampliar Gmail o Calendario, puedes puedes actualizarla a un complemento de Google Workspace. En las instrucciones de esta página, se detalla para agregar funciones de Google Workspace a tus complementos existentes de Gmail o Calendario, y y, luego, publicar el complemento actualizado para que lo descubran y lo instalen.

Puedes transferir la funcionalidad nueva a la versión para conservar tu ficha de Google Workspace Marketplace, las instalaciones y los usuarios. La actualización también te permite aprovechar las nuevas funciones del complemento de Google Workspace como páginas principales.

Nota: Si no actualizas los complementos de Gmail y de reuniones de Calendario, ten en cuenta lo siguiente: se actualizarán automáticamente a los complementos de Google Workspace con una página principal genérica. No es necesario que realices ningún cambio en la ficha ni en el código del desarrollador, y el complemento se implementará disponible solo en su versión original aplicación host. En Google Workspace Marketplace, complementos se enumeran en las secciones “funciona con Gmail” o “funciona con Calendario”. con las fichas, las instalaciones y los usuarios retenidos.

Paso 1: Haz una copia del proyecto de Apps Script del complemento

El complemento actualizado usa el mismo proyecto de Google Cloud que el que publicaste pero es importante crear y usar una copia de la base de datos Crea una secuencia de comandos para que tus usuarios existentes no se vean afectados durante la prueba la versión actualizada. También actualizar una copia del proyecto de secuencia de comandos original lo que significa que siempre puedes acceder al código original y volver a implementarlo más adelante si necesario.

1. Abre tu complemento de Gmail o de reuniones de Calendario existente en Apps Script en un proyecto final.
2. A la izquierda, haz clic en Descripción general.
3. A la derecha, haz clic en Crear una copia .
4. A la izquierda, haz clic en Configuración del proyecto > Cambiar proyecto
5. Haz clic en Número de proyecto de GCP.
6. Ingresa el mismo valor número de proyecto asociada con tu proyecto existente y publicado de complemento de Apps Script.
7. Haz clic en Establecer el proyecto.

Advertencia: No actualices directamente un proyecto de Apps Script de un complemento público. Necesitas hacer una copia para mantener la versión actualizada separada de la versión pública mientras se construye y prueba.

Paso 2: Integra el complemento de Google Workspace

Debes diseñar e implementar las funciones de los complementos de Google Workspace que quieras agregar. tu complemento.

1. Planifica qué contenido mostrar en tu complemento de la página principal y si debe aparecer en Gmail, Calendario, Drive o cualquier combinación de los tres. los hosts. Si quieres una página principal en más de un host, decide si es puede ser la misma página principal o si quieres tarjetas personalizadas de la página principal para cada host.
2. En el proyecto de complemento de Apps Script copiado, crea tu página principal tarjetas con homepageTrigger funciones. Asegúrate de incluir las funciones o lógica de respaldo necesarias para para controlar las nuevas interfaces de tu página de inicio.

3. Considera agregar tarjetas contextuales activadas por la acción de un usuario, como abrir una conversación de mensajes de Gmail o Evento de calendario:

   Precaución: Los complementos actualizados reciben un valor de ID diferente para los mensajes de Gmail. de la que reciben los complementos de Gmail. Este cambio solo afecta a los complementos actualizados que usa messageId como clave en cualquier almacenamiento permanente. Si es necesario, puedes obtener los valores de ID anteriores con la API de Gmail Las APIs de Gmail Método messages().get() acepta valores de ID nuevos y antiguos, pero solo muestra los valores de ID anteriores.

4. Actualizar los accesos a los objetos de evento en tu complemento (en las funciones de devolución de llamada del widget o en el activador contextual para usar la versión actualizada estructura de objetos de eventos. La nueva estructura aún contiene los mismos campos de objeto de evento que utiliza complementos de conferencias de Gmail y Calendario, pero esos campos originales obsoleto y, con el tiempo, se quitará.

Paso 3: Actualiza el manifiesto de tu complemento

La forma en que se almacena la información de configuración en el estructura de manifiesto de Los complementos de Google Workspace cambiaron considerablemente con respecto a la estructura de los complementos de Gmail. y los complementos de conferencias de Calendario. Cuando actualices tu complemento, deberás actualizar los campos del manifiesto del proyecto de Apps Script de tu complemento. en las siguientes tablas. Debes actualizar todas las subpropiedades relevantes a la nueva addOns.

Asegúrate de actualizar también el directorio oauthScopes como necesario para reflejar los permisos que requiere tu complemento actualizado.

Para obtener más información sobre los manifiestos de complementos 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 a un addOns.common.universalActions[].label correspondiente .
gmail.useLocalFromApp	Mover a addOns.common.useLocaleFromApp.

Complementos de reuniones 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: Prueba tu complemento actualizado

Para probar el complemento actualizado antes de publicarlo, haz lo siguiente: consulta Prueba los complementos de Google Workspace.

Paso 5: Solicita revisiones de tu complemento actualizado

Todos los complementos de Google Workspace, ya sea que se trate de un complemento actualizado o uno creado desde cero, se deben aprobar antes de que puedan aparecer en Google Workspace Marketplace.

Sigue estos pasos para enviar el complemento a revisión:

1. Asegúrate de que tu complemento cumpla con todos requisitos para la publicación de complementos.

2. Crea una implementación con control de versiones del complemento de Google Workspace (en el nuevo proyecto de Apps Script) con la versión de el código que quieres publicar. No intentes publicar con un encabezado. de Google Workspace.

3. Si agregaste nuevos alcances mientras actualizabas tu complemento, debes Solicitar verificación de OAuth. Por ejemplo, si tu complemento de Gmail usa permisos nuevos 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, así que empieza el proceso de la siguiente manera: lo antes posible. Asegúrate de que tu complemento esté verificado antes de continuar al Paso 6.

Paso 6: Haz que el complemento actualizado esté disponible

1. Abre el SDK de Google Workspace Marketplace.

2. A la izquierda, haz clic en Configuración. Este panel contiene un formulario en el que puedes proporcionar información sobre el complemento.

3. Actualiza la descripción breve, la descripción detallada y las capturas de pantalla de tu para reflejar las nuevas funciones del complemento de Google Workspace.

4. En Extensiones, haz clic en el botón Actualizar a Botón del complemento de Google Workspace. En el cuadro de texto que aparece, ingresa el nuevo ID de implementación que creaste. tu complemento de Google Workspace en el paso anterior. Si tu ID de implementación es válido, se una lista de hosts compatibles.

   Precaución: Actualizar tu complemento a uno de Google Workspace de esta manera es una sola vez proceso que no se puede deshacer.

5. Si agregaste permisos nuevos al complemento de Google Workspace, asegúrate de agregarlos al Sección Permisos de OAuth 2.0 en la página Configuración. Los permisos enumerados de la sección deben coincidir exactamente con los alcances indicados en la configuración .

6. Verifica que la información que ingresaste en el formulario sea correcta. Luego, Haz clic en Guardar cambios.

Si tienes preguntas o experimentas un problema durante esta actualización del complemento de Google Workspace comuníquese con nosotros.

Preguntas frecuentes

Las siguientes son preguntas frecuentes relacionadas con las actualizaciones de complementos:

¿Puedo actualizar mi complemento del editor?

La mayoría de los complementos de editor se pueden mover a los complementos de Google Workspace. Sin embargo, no pueden a los complementos de Google Workspace con la misma facilidad que los complementos para Gmail y de Google.

Si quieres migrar tu complemento de editor a un complemento de Google Workspace, debes hacer lo siguiente: reescribir la IU del complemento de HTML a un formato basado en tarjetas interfaz y actualiza tu código JavaScript gestionarlos en el Servicio de tarjetas.

Es posible que algunos servicios de tu complemento del editor existente no estén disponibles en Servicio de Tarjetas de Pago. Por ejemplo, si tu complemento del editor incluye un selector de archivos, encontrarás no es un equivalente disponible del Servicio de tarjetas para los complementos de Google Workspace.

¿Puedo crear un complemento de Google Workspace independiente y conservar el que ya tengo?

Puedes crear complementos adicionales de Google Workspace con diferentes nombres de marcas, pero no permitimos complementos separados para conferencias de Gmail o Calendario según la mismo nombre de marca que tu complemento de Google Workspace. Si tienes preguntas o quieres solicitar si hay una excepción, comunícate con nosotros.

¿Mis usuarios deberán volver a autorizar el complemento después de que se actualice?

Siempre y cuando el complemento de Google Workspace use el mismo Proyecto de Cloud Platform (GCP), con un ID de cliente de OAuth asociado, los usuarios no tendrán que los permisos que se autorizaron anteriormente para tu complemento original. Sin embargo, si agregar permisos nuevos durante el proceso de actualización, los usuarios deben autorizarlos nuevos permisos la primera vez que usan Google Workspace versión 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 la ficha de una extensión de Chrome las revisiones por pares. Debes crear un nuevo complemento de Google Workspace y dirigir a los usuarios de Chrome de Google Workspace Marketplace.

¿Puedo agrupar varios complementos con mi complemento de Google Workspace?

Consulta Cómo enumerar todas las integraciones de apps.