exigem autorização do usuário antes de operar. Isso vale para os complementos publicados instalados do Google Workspace Marketplace e os que você está desenvolvendo.
Autorizar complementos publicados
Depois que você instala um complemento publicado, o fluxo de autorização começa imediatamente:
- Será necessário Escolher uma conta instalar o complemento.
- Em seguida, você vê a lista de autorizações que o complemento exige para funcionar para que você saiba o que ele tenta fazer. Analise essa lista cuidadosamente e, se ainda quiser conceder a autorização, clique em Permitir. Isso ativa o uso do complemento.
- Agora, é possível executá-lo no aplicativo host que ele estende. Se o aplicativo já estava aberto em uma guia do navegador, talvez seja necessário atualizar a guia para que o complemento fique disponível.
Se o complemento instalado for atualizado posteriormente e exigir outras autorizações ainda não concedidas, você precisará fornecer essas permissões na próxima vez que usá-lo.
Autorizar complementos do Google Workspace não publicados
Os complementos não publicados não têm o mesmo fluxo de autorização que os publicados porque ainda não estão listados no Google Workspace Marketplace. Depois de instalar um complemento não publicado, você não precisa autorizar imediatamente. Em vez disso, o fluxo de autorização começa quando você tenta usar o complemento.
Quando um complemento é executado, ele determina se alguma autorização do usuário é necessária. Se a autorização for necessária, o complemento apresentará um cartão de autorização. A autorização sempre será necessária na primeira execução de um complemento e também poderá ser necessária se uma nova versão do complemento usar um serviço não autorizado anteriormente. O botão Autorizar acesso mostra uma caixa de diálogo para o usuário permitir ou negar autorização do complemento.
Autorizar serviços que não são do Google para um complemento do Google Workspace
Um complemento do Google Workspace pode se conectar a um serviço de terceiros que exige 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 complemento quando ele é instalado ou iniciado pela primeira vez
- Autorização do serviço que não é do Google quando ele é 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 OAuth, será necessário configurar a conexão para esse serviço durante a criação do complemento.
Quando a autorização de um serviço que não é do Google é necessária, o complemento do Google Workspace apresenta ao usuário um cartão de autorização para esse serviço. É possível personalizar esse prompt de autorização se quiser ou usar o cartão padrão.
Para mais detalhes, consulte o guia Como se conectar a serviços de terceiros.
Sistemas de videoconferência de terceiros
Os complementos do Google Workspace que ampliam o Google Agenda também podem adicionar outras soluções de videoconferência para 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 o login, o complemento precisa permitir que o usuário faça isso.
Se um usuário tentar criar uma videoconferência com seu complemento sem a necessidade
de fazer login, o método onCreateFunction
das soluções de videoconferência
vai retornar um objeto
ConferenceData
contendo 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 do evento que é vinculado ao 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 ver mais detalhes sobre como lidar com a autorização usando ConferenceError.
Como autorizar complementos do editor não publicados
É uma prática recomendada testar os complementos do editor durante o desenvolvimento. O fluxo de autorização é idêntico ao dos complementos do Editor publicados, exceto que o fluxo começa quando você tenta testar o complemento. Se você testar novamente o mesmo complemento, não vai precisar pedir autorização novamente.
Não autorizar complementos
Ao desenvolver complementos, pode ser útil cancelar a autorização para que você possa testar o fluxo de autorização novamente.
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 cancelar a autorização.
- Selecione REMOVER ACESSO.
Quando você executa o complemento novamente depois de não autorizar, o fluxo de autorização é apresentado novamente.