Os usuários precisam instalar e autorizar um complemento antes de abrir e usar esse recurso. Como essas etapas são a primeira parte da experiência do usuário, é importante entendê-las antes de começar a criar seus próprios complementos.
Nesta seção da documentação, descrevemos como os usuários podem instalar, autorizar e começar a usar os complementos do Google Workspace.
Instalar complementos
Antes de usar um complemento, você precisa instalá-lo. Depois de instalado, o complemento fica disponível no aplicativo host do Google Workspace que ele estende.
É possível instalar complementos publicados no aplicativo host do Google Workspace ou no Google Workspace Marketplace. Os administradores do domínio também podem instalar complementos em nome dos usuários do Google Workspace Marketplace. Também é possível instalar complementos não publicados que você está desenvolvendo para testá-los. Antes de usar um complemento instalado pela primeira vez, você precisa autorizá-lo.
Para ver mais detalhes, consulte Publicar complementos.
Autorizar complementos
Depois de instalar um complemento, ele fica disponível no aplicativo host do Google Workspace. Na primeira vez que um usuário tenta usar o complemento, o aplicativo host apresenta um cartão ou caixa de diálogo de autorização. Esse card explica o que o complemento precisa fazer para o usuário, como acessar o conteúdo da planilha atual do Planilhas Google. O usuário pode conceder essas permissões e permitir que o complemento continue. Se o usuário negar a autorização do complemento, ele não poderá usá-lo.
Os complementos do Editor usam um modelo de autorização diferente dos complementos do Google Workspace. Como os complementos do Editor operam em arquivos do Google Drive, o modelo de autorização do editor define vários modos de autorização resultantes quando os complementos são usados com arquivos individuais. Ao desenvolver Complementos do Editor, é importante entender os diferentes modos e como um complemento funciona entre eles.
Para mais detalhes, consulte Autorização.
Iniciar complementos
Depois de instalar e autorizar um complemento, ele estará disponível para ser acessado e usado no aplicativo host que ele estende.
Os complementos do Google Workspace apresentam um ícone que representa o complemento na IU para computador ou dispositivo móvel do aplicativo host. Os usuários podem iniciar ou dispensar o complemento clicando nesse ícone.
Os complementos do editor geralmente apresentam pelo menos uma opção no menu Complementos do editor para que os usuários comecem a usá-los.
Para mais detalhes, consulte Iniciar complementos.