os complementos precisam de autorização do usuário para funcionarem. Isso é válido para os complementos publicados que você instalou no Google Workspace Marketplace e os complementos que você está desenvolvendo por conta própria.
Como autorizar complementos publicados
Depois que você instala um complemento publicado, o fluxo de autorização começa imediatamente:
- Você vai receber a solicitação Escolher uma conta para instalar o complemento.
- Você verá a lista de autorizações que o complemento exige para funcionar, para que você saiba o que ele tenta fazer. Revise essa lista com atenção e, se ainda quiser conceder autorização, clique em Permitir. Isso permite o uso do complemento.
- Agora é possível executá-lo pelo aplicativo host que ele estende. Se o aplicativo já estiver aberto em uma guia do navegador, talvez seja necessário atualizar a guia para que o complemento fique disponível.
Se o complemento que você instalou for atualizado posteriormente e exigir outras autorizações que ainda não foram concedidas, você precisará fornecer essas permissões na próxima vez que usar o complemento.
Autorizar complementos do Google Workspace não publicados
Os complementos não publicados ainda não têm o mesmo fluxo de autorização que os complementos publicados, porque ainda não estão listados no Google Workspace Marketplace. Depois de instalar um complemento não publicado, não é necessário autorizar imediatamente. Em vez disso, o fluxo de autorização começa quando você tenta usar o complemento pela primeira vez.
Quando um complemento é executado, ele determina se uma autorização do usuário é necessária. Se a autorização for necessária, o complemento vai apresentar um cartão de autorização. A autorização é sempre necessária na primeira execução de um complemento e também pode ser necessária se uma nova versão do complemento usar um serviço não autorizado anteriormente. O botão Autorizar acesso oferece uma janela de diálogo para o usuário permitir ou negar a autorização do complemento.
Autorizar serviços que não são do Google para um complemento do Google Workspace
É possível que um complemento do Google Workspace se conecte a um serviço de terceiros que exija autorização. Os complementos do Google Workspace que se conectam a esses serviços exigem duas ações separadas do usuário:
- Autorização do próprio complemento quando ele é instalado ou iniciado pela primeira vez.
- Autorização do serviço que não é do Google quando é acessado pela primeira vez.
Se um complemento do Google Workspace que você está desenvolvendo precisar acessar um serviço que não seja do Google usando o OAuth, configure a conexão para esse serviço ao criar o complemento.
Quando a autorização de um serviço que não é do Google é exigida, o complemento do Google Workspace apresenta ao usuário um cartão de solicitação de autorização para esse serviço. É possível personalizar essa solicitação de autorização, se você quiser, ou usar o cartão padrão.
Para mais detalhes, consulte o guia Como se conectar a serviços que não são do Google.
Sistemas de videoconferência de terceiros
Os complementos do Google Workspace que estendem o Google Agenda também podem incluir outras soluções de videoconferência que permitem que os usuários selecionem um sistema de videoconferência de terceiros ao editar eventos do Google Agenda. Se o complemento oferecer opções de videoconferência que exigem que o usuário faça login, ele precisará permitir que o usuário faça isso.
Se um usuário tentar criar uma videoconferência com o complemento sem um login
necessário, o método onCreateFunction
das soluções de videoconferência retornará um objeto
ConferenceData
que contém um
ConferenceError
com um
URL de autenticação.
Ao receber esse objeto, o Google Agenda cria um botão FAZER LOGIN na IU de edição de evento que direciona para o URL de autenticação fornecido pelo complemento. Os usuários podem usar esse botão para fazer login no sistema de terceiros antes de usar o complemento.
Consulte Como criar conferências de terceiros
para mais detalhes sobre como lidar com autorizações usando ConferenceError.
Como autorizar complementos não editados do editor
É uma prática recomendada testar os complementos do editor durante o desenvolvimento. O fluxo de autorização é idêntico ao complementos publicados do Editor, exceto que ele começa quando você tenta testar o complemento pela primeira vez. Se você testar novamente o mesmo complemento, não precisará solicitar a autorização novamente.
Não autorizando complementos
Ao desenvolver complementos, pode ser útil desautorizá-los para que você possa testar novamente o fluxo de autorização.
Para cancelar a autorização de um complemento, faça o seguinte:
- Abra o console de segurança da conta.
- Localize e clique no complemento que você quer desautorizar.
- Clique em REMOVER ACESSO.
Quando você executa o complemento novamente depois de desautorizá-lo, o fluxo de autorização é apresentado novamente.