los complementos requieren autorización del usuario para poder funcionar. Esto se aplica tanto a los complementos publicados que instalaste desde Google Workspace Marketplace como a los complementos que estás desarrollando.
Autoriza complementos publicados
Después de instalar un complemento publicado, el flujo de autorización comienza inmediatamente:
- Se te solicitará que Elegir una cuenta instale el complemento.
- Luego, se te presentará la lista de autorizaciones que requiere el complemento para funcionar, para que sepas qué intenta hacer. Revísala con atención y, si aún deseas otorgar autorización, haz clic en Permitir. De esta manera, se habilita el complemento para su uso.
- 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 actualizarla antes de que el complemento esté disponible.
Si el complemento que instalaste se actualiza más adelante 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 figuran en Google Workspace Marketplace. Después de instalar un complemento no publicado, no se te pedirá que lo autorices de inmediato. En cambio, el flujo de autorización se inicia cuando intentas usar el complemento por primera vez.
Cuando se ejecuta un complemento, determina si se necesita 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 requiera si una versión nueva del complemento usa un servicio no autorizado con anterioridad. El botón Autorizar acceso proporciona una ventana de diálogo en la que el usuario puede permitir o rechazar la autorización del complemento.
Autoriza servicios ajenos a Google para agregar un complemento de Google Workspace
Es posible que un complemento de Google Workspace se conecte a un servicio de terceros que requiere autorización. Los complementos de Google Workspace que se conectan a esos servicios requieren dos acciones independientes del usuario:
- Autorización del complemento en sí cuando este se instala o se inicia por primera vez
- Autorización de un 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.
Cuando se requiere la autorización de un servicio ajeno a Google, el complemento de Google Workspace presenta al usuario una tarjeta de solicitud de autorización para ese servicio. Si lo deseas, puedes personalizar este mensaje de autorización o usar la tarjeta predeterminada.
Para obtener más detalles, consulta la guía Conéctate a servicios que no son de Google.
Sistemas de conferencia de terceros
Los complementos de Google Workspace que extienden el Calendario de Google también pueden agregar soluciones de conferencias adicionales que permiten a los usuarios seleccionar un sistema de reuniones de terceros cuando editan eventos del Calendario de Google. Si el complemento proporciona opciones de reunión que requieren que el usuario acceda a ellas, el complemento debe darle la posibilidad de hacerlo.
Si un usuario intenta crear una conferencia con tu complemento sin un acceso necesario, el método onCreateFunction de las soluciones de conferencias debe mostrar un objeto ConferenceData que contenga un ConferenceError con una URL de autenticación.
Cuando se 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 usar más el complemento.
Consulta Crea conferencias de terceros para obtener más detalles sobre cómo controlar la autorización con ConferenceError.
Cómo autorizar 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, con la excepción de que el flujo se inicia cuando intentas probar el complemento por primera vez. Si más adelante vuelves a probar el mismo complemento, no se te volverá a solicitar autorización.
Desautorizar complementos
Cuando se desarrollan complementos, puede ser útil no autorizarlos para que puedas volver a probar el flujo de autorización.
Para anular la autorización de un complemento, sigue estos pasos:
- Abre la consola de seguridad de tu cuenta.
- Busca el complemento del que deseas anular la autorización y haz clic en él.
- Haz clic en QUITAR ACCESO.
Cuando vuelves a ejecutar el complemento después de desautorizarlo, se vuelve a presentar el flujo de autorización.