Instala y autoriza complementos

Los usuarios deben instalar y autorizar un complemento antes de poder abrirlo y usarlo. Dado que estos pasos son la primera parte de la experiencia del usuario con el complemento, debes comprenderlos antes de comenzar a crear tus propios complementos.

En esta sección de documentación, se describe cómo los usuarios pueden instalar, autorizar y comenzar a usar complementos.

Instala complementos

Antes de poder usar un complemento, debes instalarlo. Una vez instalado, el complemento pasa a estar disponible en la aplicación host de Google Workspace que extiende.

Puedes instalar complementos publicados desde la aplicación host de Google Workspace o desde Google Workspace Marketplace. Los administradores de dominio también pueden instalar complementos en nombre de sus usuarios desde Google Workspace Marketplace. También puedes instalar complementos no publicados que estás desarrollando para poder probarlos. Antes de poder usar un complemento instalado por primera vez, debes autorizarlo.

Para obtener más detalles, consulta Cómo publicar complementos.

Autoriza complementos

Después de instalar un complemento, está disponible en la aplicación host de Google Workspace que extiende. La primera vez que un usuario intenta usar el complemento, la aplicación host le presenta una tarjeta de autorización o un diálogo. En esta tarjeta, se explica lo que el complemento necesita permiso para el usuario, como acceder al contenido de la hoja de cálculo de Google actual. Luego, el usuario puede otorgar esos permisos y permitir que el complemento continúe. Si el usuario rechaza la autorización del complemento, no podrá usar el complemento.

Los complementos de editor usan un modelo de autorización diferente de los complementos de Google Workspace. Debido a que los complementos de editor operan en archivos de Google Drive, el modelo de autorización del editor define varios modos de autorización que se generan cuando se usan los complementos con archivos individuales. Cuando desarrollas complementos de editor, es importante comprender los diferentes modos y cómo se mueve un complemento entre ellos.

Autorizar complementos publicados

Después de instalar un complemento publicado, el flujo de autorización comienza de inmediato:

1. Se le pedirá que seleccione una cuenta para instalar el complemento.
2. Luego, verás la lista de autorizaciones que el complemento requiere para funcionar, de modo que sepas lo que intenta hacer. Revisa esta lista cuidadosamente y, si aún deseas otorgar autorización, haz clic en Permitir. Esto habilita el complemento para su uso.
3. Ahora puedes ejecutarlo desde la aplicación host que extiende. Si la aplicación ya estaba abierta en una pestaña del navegador, es posible que debas actualizar la pestaña antes de que el complemento esté disponible.

Si el complemento que instalaste se actualiza más tarde y requiere autorizaciones adicionales que aún no otorgaste, se te solicitará que proporciones esos permisos la próxima vez que uses el complemento.

Autoriza complementos de Google Workspace no publicados

Los complementos no publicados no tienen el mismo flujo de autorización que los complementos publicados porque aún no aparecen en Google Workspace Marketplace. Después de instalar un complemento no publicado, no se te solicita de inmediato que lo autorices. En su lugar, el flujo de autorización se inicia cuando intentas usar el complemento por primera vez.

Cuando se ejecuta un complemento, este determina si se necesita alguna autorización del usuario. Si se necesita autorización, el complemento presenta una tarjeta de autorización. Siempre se requiere autorización la primera vez que se ejecuta un complemento y es posible que también se necesite si una versión nueva del complemento usa un servicio no autorizado con anterioridad. El botón Authorize Access proporciona una ventana de diálogo para que el usuario permita o rechace la autorización del complemento.

Nota: Si aún no se verificó el complemento, es posible que la aplicación host te presente diálogos adicionales en los que se te informe de esto y te solicite que confirmes que deseas continuar.

Autoriza servicios que no sean de Google para un complemento de Google Workspace

Un complemento de Google Workspace puede conectarse a un servicio de terceros que requiere autorización. Los complementos de Google Workspace que se conectan a esos servicios requieren dos acciones distintas del usuario:

• Autorización del complemento cuando se instala o se inicia por primera vez
• Autorización del servicio ajeno a Google cuando se accede a él por primera vez.

Si un complemento de Google Workspace que estás desarrollando necesita acceder a un servicio ajeno a Google mediante OAuth, debes configurar la conexión para ese servicio cuando compiles el complemento.

Para obtener más información, consulta Conecta tu complemento de Google Workspace a un servicio de terceros.

Sistemas de conferencias de terceros

Nota: En esta sección, se describe la autorización de soluciones de conferencias agregadas a Calendario de Google con un complemento de Google Workspace.

Si actualmente no mantienes un sistema de conferencias de terceros basado en la Web, no es necesario que tu complemento autorice soluciones de conferencia. Esta funcionalidad se diseñó específicamente para proveedores de conferencias.

Los complementos de Google Workspace que extienden Calendario de Google también pueden agregar soluciones de reunión adicionales que permiten a los usuarios seleccionar un sistema de reuniones de terceros cuando editan eventos de Calendario de Google. Si tu complemento proporciona opciones de reunión que requieren que el usuario acceda a ellos, este debe otorgarle la capacidad de hacerlo.

Si un usuario intenta crear una conferencia con tu complemento sin un acceso necesario, el método onCreateFunction de las soluciones de conferencia debe mostrar un objeto ConferenceData que contenga un ConferenceError con una URL de autenticación.

Cuando recibe este objeto, el Calendario de Google crea un botón ACCEDER en la IU de edición de eventos que se vincula a la URL de autenticación que proporciona el complemento. Luego, los usuarios pueden usar este botón para acceder al sistema de terceros antes de seguir usando el complemento.

Consulta Crea conferencias de terceros para obtener más detalles sobre cómo controlar la autorización con ConferenceError.

Autoriza complementos del editor no publicados

Se recomienda probar los complementos del editor a medida que los desarrollas. El flujo de autorización es idéntico al de los complementos de editor publicados, excepto que el flujo se inicia cuando intentas probar el complemento por primera vez. Si más tarde vuelves a probar el mismo complemento, no se te volverá a solicitar autorización.

Anular autorización de complementos

Cuando desarrollas complementos, puede ser útil desautorizarlos para que puedas volver a probar el flujo de autorización.

Para quitar la autorización de un complemento, sigue estos pasos:

1. Abre la consola de seguridad de tu cuenta.
2. Ubica el complemento que quieras quitar de la autorización y haz clic en él.
3. Haz clic en Quitar acceso.

Cuando vuelvas a ejecutar el complemento después de desautorizarlo, se volverá a presentar el flujo de autorización.

Temas relacionados

• Cómo abrir y usar los complementos instalados
• Conecta tu complemento de Google Workspace a un servicio de terceros