Instala y autoriza complementos

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

Esta sección de documentación describe cómo los usuarios pueden instalar, autorizar e comenzar a usar complementos.

Instala complementos

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

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

Para obtener más detalles, consulta Publicar complementos

Autoriza complementos

Después de instalar un complemento, estará disponible en la Google Workspace aplicación host se extiende. La primera vez que un usuario intenta usar el complemento que la aplicación host le presenta un una tarjeta de autorización o un cuadro de diálogo. En esta tarjeta, se explica qué el complemento necesita permiso para realizar la acción por el usuario, por ejemplo: al acceder al contenido de la hoja de cálculo de Google actual. Luego, el usuario puede otorgar esas permisos y permitir que el complemento continúe. Si el botón el usuario rechaza el complemento autorización, no puede usar un complemento.

Los complementos de Editor usan un modelo de autorización distinto del Complementos de Google Workspace. Como los Complementos para editores operan en archivos de Google Drive, el El modelo de autorización de editores define varios modos de autorización que se generan cuando los complementos se usan con archivos individuales. Al desarrollar complementos de Editores, 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 operar, para que sepas lo que intenta hacer. Opinar sobre esto cuidadosamente y, si aún quieres otorgar autorización, Haz clic en Permitir. Esto habilita el complemento para su uso.
3. Ahora puedes ejecutarlo desde aplicación host se extiende. Si la aplicación ya estaba abierta en una pestaña del navegador, puedes tendrás que actualizar la pestaña antes de que el complemento esté disponible.

Si el complemento que instalaste se actualiza más tarde y requiere actualizaciones autorizaciones que aún no has otorgado, se te indicará que las proporciones los 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 todavía no aparecen en Google Workspace Marketplace. Después del instalar un complemento no publicado no se te pide de inmediato que autorices. En cambio, el flujo de autorización comienza cuando se intenta 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. También puede si una versión nueva del complemento usa un servicio que no autorizados. El botón Autorizar acceso proporciona una ventana de diálogo para la usuario para permitir o rechazar la autorización del complemento.

Nota: Si el complemento aún no se ha verificados, la aplicación host puede presentarte diálogos adicionales para informarte sobre esto y pedirte que confirmes que quieres continuar.

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

Un complemento de Google Workspace se puede conectar a un servicio de terceros que requiere autorización. Complementos de Google Workspace que se conectan a esos servicios requieren dos acciones separadas del usuario:

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

Si estás desarrollando un complemento de Google Workspace para acceder a un servicio ajeno a Google con OAuth, debes configura 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 las soluciones de conferencia que se agregaron al Calendario de Google con un complemento de Google Workspace

Si actualmente no mantienes una reunión de terceros basada en la Web tu complemento no necesita autorizar ninguna solución para conferencias. Esta se diseñó específicamente para proveedores de conferencias.

Complementos de Google Workspace que extienden Calendario de Google también pueden agregar soluciones para conferencias que les permiten a los usuarios seleccionar un sistema de conferencias de terceros cuando editan Eventos del Calendario de Google Si tu complemento proporciona opciones de reunión que que el usuario debe acceder a sus cuentas, tu complemento debe darle al usuario la posibilidad para hacerlo.

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

Cuando recibe este objeto, el Calendario de Google crea el botón ACCEDER. la IU de edición de eventos que 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 Cómo crear conferencias de terceros. para obtener más información sobre cómo controlar la autorización con ConferenceError.

Autoriza complementos del editor no publicados

Probar los complementos del editor es una práctica recomendada. a medida que los desarrollas. El flujo de autorización es idéntico al para los complementos de editor publicados, excepto que el flujo comienza cuando intentas probar el complemento por primera vez. Si más tarde vuelve a probar 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 probarlos. 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 luego de desautorizarlo, el flujo de autorización se vuelve a presentar.

Temas relacionados

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