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 de complementos, debes comprenderlos antes de comenzar a crear tus propios complementos.
En esta sección de la documentación, se describe cómo los usuarios pueden instalar, autorizar y comenzar a usar los complementos de Google Workspace.
Instala complementos
Antes de poder usar un complemento, debes instalarlo. Una vez instalado, el complemento 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, este estará disponible en la aplicación host de Google Workspace que extiende. La primera vez que un usuario intenta usar el complemento de la aplicación host, se le presenta una tarjeta de autorización o un diálogo. En esta tarjeta, se explica lo que el complemento necesita permiso para hacer por 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á usarlo.
Los complementos de Editor usan un modelo de autorización que difiere de los complementos de Google Workspace. Debido a que los complementos de Editor funcionan en archivos de Google Drive, el modelo de autorización del editor define varios modos de autorización que se producen cuando los complementos se usan con archivos individuales. Cuando desarrolles complementos del editor, es importante comprender los diferentes modos y cómo se mueve un complemento entre ellos.
Para obtener más detalles, consulta Autorización.
Iniciar complementos
Una vez que hayas instalado y autorizado un complemento, estará disponible para acceder a él y usarlo en la aplicación host donde se extienda.
Los complementos de Google Workspace presentan un ícono que representa el complemento en la IU para computadoras o dispositivos móviles de la aplicación host. Los usuarios pueden iniciar o descartar el complemento si hacen clic en este ícono.
Por lo general, los complementos de Editor presentan al menos una opción de menú en el menú Complementos del editor que permite a los usuarios comenzar a usar el complemento.
Para obtener más detalles, consulta Cómo iniciar complementos.