Implementa un complemento de Meet

Los complementos de Google Meet se crean y configuran como parte de un proyecto de Google Cloud.

Crea un proyecto de Google Cloud

Para generar un proyecto de Google Cloud, consulta Crea un proyecto de Google Cloud.

Habilita el SDK de Google Workspace Marketplace y la API de complementos de Google Workspace

El SDK de Google Workspace Marketplace y la API de complementos de Google Workspace son obligatorios para desarrollar complementos de Meet. Haz lo siguiente para habilitarlos:

  1. Abre la consola de Google Cloud.
  2. En la parte superior, si ya está abierto un proyecto diferente, selecciona el nombre del proyecto de tu app para cambiar de proyecto.
  3. En la parte superior, en la barra de búsqueda, escribe Google Workspace Marketplace SDK y presiona Intro.
  4. Abre la página Google Workspace Marketplace SDK y haz clic en Habilitar.

  5. Repite estos pasos para encontrar y habilitar el Google Workspace Add-ons API.

Crear una implementación

Para usar un complemento en Meet, necesitas una implementación y un archivo de manifiesto del complemento.

  1. Abre la consola de Google Cloud.
  2. En la parte superior, si ya está abierto un proyecto diferente, selecciona el nombre del proyecto de tu app para cambiar de proyecto.
  3. Haz clic en APIs y servicios.
  4. Selecciona Google Workspace Marketplace SDK para ver la página de detalles.

Crea tu implementación

Puedes crear tu implementación directamente en la consola de Google Cloud. Para ello, crea una implementación HTTP (recomendado) o usa Apps Script de Google.

Implementación de HTTP

  1. Haz clic en la pestaña HTTP deployments.
  2. Haz clic en Crear implementación nueva y, luego, ingresa el ID de implementación del complemento.

    El ID de implementación es una cadena arbitraria que ayuda al desarrollador del complemento a identificar la implementación que contiene el manifiesto del complemento. Los IDs de implementación son obligatorios y pueden tener un máximo de 100 caracteres.

  3. Haz clic en Siguiente.

    Se abrirá un panel lateral para que envíes la especificación del manifiesto del complemento en formato JSON. Esto también se llama DEPLOYMENT.JSON.

    El archivo de manifiesto del complemento es la configuración central de un complemento de Google Meet. En la siguiente muestra de código, se muestran los campos de Meet disponibles para la Web en el archivo de manifiesto del complemento.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Reemplaza lo siguiente:

    • NAME: Cadena. Es el nombre de tu complemento de Google Meet.
    • LOGO_URL: Es una cadena. Es la URL del logotipo del complemento de Google Workspace. Se usa para el complemento en todos los productos de Google Workspace.
    • SIDE_PANEL_URI: Es una cadena. Es la URL del punto de entrada de la app de tu complemento. Se muestra en un iframe dentro del panel lateral. El origen de esta URL debe ser parte de los orígenes especificados en el campo ADD_ON_ORIGINS.
    • ADD_ON_ORIGINS: Es una lista de cadenas. Es una lista de los orígenes donde se aloja tu complemento. Dos URLs tienen el mismo origen cuando comparten el mismo esquema, host y puerto. También se permiten los suborígenes, al igual que los subdominios de comodines. Para obtener más información, consulta Seguridad de los complementos.
    • DARK_MODE_LOGO_URL: Es una cadena. Es una URL específica del modo oscuro del logotipo del complemento. Proporcionar un logotipo de modo oscuro garantiza que tu complemento se vea mejor en cualquier tema de Meet. Si deseas conocer los lineamientos para el diseño de logotipos, consulta Prácticas recomendadas.
    • MEET_WEB_LOGO_URL: Opcional String. Una URL específica de Meet del logotipo para el complemento. Este logotipo se usa en Meet. Si no está presente, se usa el logoUrl de la sección común. Si deseas conocer los lineamientos de diseño de logotipos, consulta Prácticas recomendadas.
    • SUPPORTS_SCREENSHARING: Opcional Booleano. Si se establece como "false", los usuarios deben usar el complemento para ver lo que sucede en una sesión colaborativa del complemento. Si se configura como verdadera, el iniciador de la sesión del complemento colaborativo puede compartir su vista en pantalla del complemento.
  4. Haz clic en Enviar.

    Para obtener más información sobre las implementaciones, consulta Cómo crear un recurso de implementación.

  5. En la pestaña Configuración de la app, en Integración de apps, selecciona Complemento de Google Workspace. Selecciona Implementar con el recurso de implementación en la nube y, luego, elige la implementación HTTP correcta.

Google Apps Script

  1. Haz clic en la pestaña Configuración de la app.

  2. En Integración de apps, selecciona Complemento de Google Workspace. Selecciona Implementar con el ID de implementación de Google Apps Script y, luego, ingresa el ID de implementación de tu secuencia de comandos.

  3. Haz clic en Guardar.

    Para obtener detalles sobre cómo crear un proyecto de Apps Script, consulta la documentación de Apps Script. El complemento de Meet se basa únicamente en el archivo de manifiesto appsscript.json, también llamado manifiesto del proyecto de Apps Script. Asegúrate de que el archivo de manifiesto de tu proyecto de Apps Script contenga una sección addOns y una meet. Las secciones addOns y meet siguen la misma estructura que se describe en la pestaña de implementación de HTTP.

    A diferencia de otros complementos de Google Workspace, los complementos de Meet no se pueden compilar por completo en Apps Script. En su lugar, debes compilar una app web completa creando un panel lateral y un escenario principal. La URL del panel lateral de tu app web se debe especificar en el SIDE_PANEL_URI del archivo de manifiesto appsscript.json.

Instala y prueba el complemento en Meet

Si quieres probar tu complemento en Meet, primero debes instalarlo para el usuario que accedió:

Implementación de HTTP

  1. Navega al SDK de Google Workspace Marketplace para tu proyecto en la consola de Google Cloud.
  2. Haz clic en la pestaña HTTP deployments.
  3. Haz clic en Instalar en la columna Acciones.

Google Apps Script

  1. Sigue la documentación de complementos de Google Workspace para instalar un complemento no publicado.

Ahora deberías poder usar el complemento en una reunión. Para probarlo, inicia una reunión en meet.google.com. El complemento instalado ahora se puede ver en el panel Actividades.

Además de instalar tu complemento para el usuario individual que accedió, también puedes publicarlo. Cuando publicas tu complemento de Google Workspace, lo pones a disposición de los demás para que lo encuentren, lo instalen y lo usen.