Melhore a experiência geral dos usuários seguindo estes guias de design de complementos do Google Meet.
Práticas recomendadas de autorização
Recomendamos que você use as práticas recomendadas a seguir para todos os complementos do Google Meet que exigem autenticação ou autorização.
Usar o Login do Google
Muitos usuários de complementos do Google Workspace já terão feito login no Google antes de participar da reunião. Por isso, ter o Google One Tap disponível como opção pode economizar vários cliques dos usuários ao passar pelo fluxo de login. Para mais informações, consulte Gerenciar métodos de login para seu complemento.
Abra a página de login de terceiros em uma nova janela.
Além do login do Google, seu aplicativo pode oferecer outros mecanismos de login. Se for o caso, use uma janela de diálogo em vez de abrir uma página de login em uma nova guia. Assim, o usuário ainda pode ver e voltar para a chamada do Meet e fará menos cliques no geral.
Solicitar escopos corretamente para APIs do Google
Se o complemento do Meet chamar APIs do Google, forneça uma lista completa dos escopos do OAuth necessários para o complemento. Isso é feito na página de configuração do app do Google Workspace Marketplace. Depois de adicionar esses escopos, os usuários vão receber um aviso quando instalarem o complemento do Meet, informando a eles quais tipos de dados estão permitindo que seu app acesse.
Antes de publicar o complemento, você também precisa configurar a tela de permissão OAuth. Para isso, adicione exatamente os mesmos escopos de autorização da configuração do app do Google Workspace Marketplace. Para configurar a tela de permissão OAuth, também é necessário definir as informações de marca, a Política de Privacidade e os Termos de Serviço que são mostrados quando os escopos são solicitados. Para publicar publicamente, todas essas informações precisam ser enviadas para verificação.
Ao escrever código para chamar as APIs do Google Workspace, a maneira mais fácil de começar é seguir o início rápido do JavaScript. Essa abordagem segue as práticas recomendadas para usar o Google Sign-In e janelas de diálogo. Observe que inicializar o cliente de token em JavaScript exige solicitar separadamente os escopos que o aplicativo usa no tempo de execução. Para oferecer a melhor experiência do usuário, os escopos solicitados precisam corresponder aos da página de configuração do app no Google Workspace Marketplace. Essa redundância oferece um substituto para lidar com o caso em que um usuário revogou escopos.
Práticas recomendadas de manutenção
As práticas recomendadas a seguir são para escrever aplicativos da Web fáceis de manter, mas são especialmente importantes ao escrever complementos do Meet.
Use a versão mais recente do SDK de complementos do Google Meet
O SDK de complementos do Meet é atualizado regularmente. O SDK segue o controle de versões semânticas. Para encontrar a versão mais recente:
- Ao usar o gstatic: a versão mais recente do SDK está contida no URL do gstatic encontrado nas instruções de uso do SDK.
- Ao usar o npm: execute
npm update @googleworkspace/meet-add-onsno diretório que contém opackage.jsondo site que hospeda seu complemento do Meet.
Criar um projeto de teste do Google Cloud
Depois que o complemento do Google Meet for publicado no Google Workspace Marketplace, todas as novas implantações do complemento do Google Meet vão ficar disponíveis instantaneamente para os usuários do Meet. Os usuários vão ver essas atualizações assim que esvaziarem os caches ou quando eles expirarem. Por isso, recomendamos não enviar mudanças para o site de produção até que elas sejam testadas completamente.
Para evitar a implantação direta na produção, recomendamos criar um projeto separado do Google Cloud que seja publicado de forma particular para sua organização. Esse projeto do Cloud vai hospedar os ambientes de preparo e desenvolvimento do seu complemento do Meet. O acesso a esse projeto do Cloud deve ser limitado a uma equipe menor que trabalha diretamente no desenvolvimento do complemento.
Para criar esses ambientes alternativos para seu complemento, primeiro hospede ambientes alternativos do aplicativo da Web que contém o complemento em um domínio de sua propriedade. Em seguida, crie ambientes alternativos para seu complemento do Meet adicionando mais implantações ao projeto de teste do Google Cloud. Essas novas implantações precisam ter manifestos que apontem para os ambientes alternativos do seu aplicativo da Web. Em seguida, recomendamos que você instale cada ambiente de complemento da seguinte maneira:
- Teste: publique a versão de teste de maneira privada para que qualquer pessoa na sua organização possa ajudar com os testes.
- Desenvolvimento: clique em Instalar na coluna Ações para instalar a versão de desenvolvimento do complemento do Meet apenas na sua conta.
Criar testes
Antes de implantar o complemento do Meet em um ambiente de desenvolvimento, recomendamos escrever testes de unidade. Os testes de unidade precisam incluir:
- Simular o SDK de complementos do Meet e verificar se o complemento do Meet chama as funções do SDK conforme o esperado.
- Teste de unidade de toda a funcionalidade não relacionada ao SDK do seu complemento com a estrutura de teste da Web de sua preferência.
Práticas recomendadas de experiência do usuário
As práticas recomendadas a seguir ajudam a tornar um complemento do Meet mais intuitivo e refinado.
Gerenciar todos os estados iniciais no painel lateral
Recomendamos configurar o complemento com base nas
ações do usuário no painel lateral.
Isso é feito definindo o estado inicial da atividade em JavaScript. Todos os dados que entram no
ActivityStartingState
precisam ser definidos pelo iniciador do complemento (normalmente
o organizador da reunião) no painel lateral. A primeira visualização do
painel lateral é como um formulário que controla a configuração do
complemento.
Feche o painel lateral quando não estiver em uso
Depois de iniciar a atividade chamando o método
startActivity(), mantenha o painel
lateral aberto apenas se ele for uma parte essencial
da experiência do usuário para seu complemento do Google Meet. Você pode fechar
o painel lateral depois que o palco principal
for aberto chamando o método
unloadSidePanel().
Promova seu complemento do Meet compartilhando a tela
Os complementos do Meet oferecem uma experiência mais completa do que o compartilhamento de tela. No entanto, muitos usuários estão acostumados a usar o recurso de compartilhamento de tela do Meet. Se um usuário compartilhar uma guia mostrando o site que hospeda seu complemento do Meet, o Meet poderá ser configurado para mostrar um banner a todos os participantes da chamada, pedindo que instalem ou usem o complemento correspondente do Meet. Para mais informações, consulte promover seu complemento por compartilhamento de tela.
Diretrizes de design de logotipo
Siga estas diretrizes ao criar seu logotipo específico do Meet para que ele tenha a melhor aparência agora e no futuro:
Use o formato de arquivo PNG, dimensionado para 256 px x 256 px.
Use transparência.
Verifique se o logotipo do modo escuro fica bom usando as ferramentas para desenvolvedores de complementos do Meet.
Verifique se o logotipo (e outros recursos gráficos) ficam bons no modo de alto contraste usando um verificador de contraste, como o Verificador de contraste da Web Accessibility In Mind (WebAIM).
Obedeça aos requisitos de gráficos para integrações de apps específicos.
Não inclua padding na imagem. Em vez disso, estenda a imagem até as bordas do arquivo.