Siga estes guias para o design de complementos do Google Meet e melhore a experiência geral dos usuários.
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. Portanto, ter 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.
Abrir 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. Nesse caso, use uma janela de diálogo em vez de abrir uma página de login em uma nova guia. Dessa forma, o usuário ainda poderá ver e retornar à chamada do Meet e fará menos cliques no geral.
Solicitar escopos corretamente para as APIs do Google
Se o complemento do Meet chamar as APIs do Google, então você precisa fornecer uma lista completa dos escopos do OAuth exigidos pelo 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 uma solicitação ao instalar o complemento do Meet, informando a que tipo de dados eles estão permitindo que o app acesse.
Antes de publicar o complemento, também é necessário configurar a tela de permissão OAuth. Isso exige a adição exatamente dos mesmos escopos de autorização da configuração do app do Google Workspace Marketplace. A configuração da tela de permissão OAuth também exige a definição das informações de marca, da Política de Privacidade e dos Termos de Serviço que são exibidos 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 Login do Google e as janelas de diálogo. A inicialização do cliente de token em JavaScript exige a solicitação separada dos escopos que o aplicativo realmente usa no ambiente de execução. Para oferecer a melhor experiência do usuário, esses escopos solicitados precisam corresponder aos da página de configuração do app do Google Workspace Marketplace. Essa redundância oferece um fallback para lidar com o caso em que um usuário revogou os escopos.
Práticas recomendadas de manutenção
As práticas recomendadas a seguir são para escrever aplicativos da Web que podem ser mantidos, mas são especialmente importantes ao escrever complementos do Meet.
Usar 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ântico. 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 em 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 o complemento do Meet.
Criar um projeto na nuvem de preparação 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 ficarão disponíveis instantaneamente para os usuários do Meet. Os usuários vão ver essas atualizações assim que esvaziarem os caches ou o cache expirar. Portanto, recomendamos não enviar mudanças para o site de produção até que elas sejam totalmente testadas.
Para evitar a implantação direta na produção, recomendamos criar um projeto separado do Google Cloud que seja publicado de forma privada para sua organização. Esse projeto na nuvem vai hospedar os ambientes de preparação e desenvolvimento do complemento do Meet. O acesso a esse projeto na nuvem precisa ser limitado a uma equipe menor que esteja trabalhando diretamente no desenvolvimento do complemento.
Para criar esses ambientes alternativos para o complemento, primeiro é necessário hospedar ambientes alternativos do aplicativo da Web que contém o complemento em um domínio de sua propriedade. Em seguida, é possível criar ambientes alternativos para o complemento do Meet adicionando outras implantações ao projeto de preparação do Google Cloud. Essas novas implantações precisam ter manifestos que apontem para os ambientes alternativos do aplicativo da Web. Em seguida, recomendamos instalar cada ambiente de complemento da seguinte maneira:
- Preparação: publique a versão de preparação de forma privada para que qualquer pessoa na sua organização possa ajudar nos testes.
- Desenvolvimento: clique em Instalar na coluna Ações para instalar a versão de desenvolvimento do complemento do Meet apenas na sua conta.
Escrever testes
Antes de implantar o complemento do Meet em um ambiente de desenvolvimento, recomendamos escrever testes de unidade. Os testes de unidade precisam incluir:
- Simulação do SDK de complementos do Meet e verificação de que o complemento do Meet chama as funções do SDK conforme o esperado.
- Teste de unidade de todas as funcionalidades não relacionadas ao SDK do complemento com a estrutura de teste da Web preferida.
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 todo o estado inicial no painel lateral
Recomendamos configurar o complemento com base nas
ações do usuário realizadas no painel lateral.
Isso é feito definindo o estado inicial da atividade
estado 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 pode ser considerada um formulário que controla a configuração do complemento.
Fechar o painel lateral quando não estiver em uso
Depois de iniciar a atividade chamando o
startActivity()
método, mantenha o painel
lateral aberto apenas se ele for uma parte essencial
da experiência do usuário para o complemento do Google Meet. É possível fechar
o painel lateral depois que o estágio principal
for aberto chamando o
unloadSidePanel()
método.
Promover o complemento do Meet pelo compartilhamento de 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 que mostra o site que hospeda o 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 do Meet correspondente. Para mais informações, consulte Promover seu complemento pelo 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, com tamanho de 256 x 256 pixels.
Use transparência.
Verifique se o logotipo do modo escuro tem uma boa aparência no modo escuro usando as ferramentas para desenvolvedores de complementos do Meet.
Verifique se o logotipo (e outros recursos gráficos) têm uma boa aparência no modo de alto contraste usando um verificador de contraste, como o Contrast Checker da Web Accessibility In Mind (WebAIM).
Siga os requisitos gráficos para integrações de apps específicos.
Não inclua padding na imagem. Estenda a imagem até os limites do arquivo.