Práticas recomendadas

Melhore a experiência geral dos usuários seguindo estes guias para o design de complementos do Google Meet.

Práticas recomendadas de autorização

Recomendamos que você use as práticas recomendadas abaixo 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á fizeram login no Google antes de participar da reunião. Portanto, ter o Google One Tap disponível como uma opção pode economizar vários cliques para os usuários durante o fluxo de login. Para mais informações, consulte Gerenciar métodos de login do 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 pode acessar e retornar à ligação do Meet e vai precisar de menos cliques no geral.

Solicitar escopos corretamente para as APIs do Google

Se o complemento do Meet chamar APIs do Google, é necessário fornecer uma lista completa de escopos do OAuth requeridos 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 que informa que tipo de dados eles estão permitindo que o app acesse.

Antes de publicar o complemento, configure a tela de consentimento do OAuth. Para isso, adicione exatamente os mesmos escopos de autorização da configuração do app do Google Workspace Marketplace. A configuração da tela de consentimento do OAuth também exige a definição das informações de marca, da política de privacidade e dos Termos de Serviço que aparecem 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, siga o Programa de treinamento inicial do JavaScript para começar. Essa abordagem segue as práticas recomendadas para usar o login do Google e as janelas de diálogo. Inicializar o cliente do token no JavaScript exige que você solicite separadamente os escopos que o aplicativo realmente usa no momento da execução. Para oferecer a melhor experiência do usuário, esses escopos solicitados precisam corresponder aos da página de configuração de apps do 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 manuteníveis, mas são particularmente importantes ao criar complementos do Meet.

Usar a versão mais recente do SDK dos 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 para usar o SDK.
  • Ao usar o npm: execute npm update @googleworkspace/meet-add-ons no diretório que contém o package.json do site que hospeda o complemento do Meet.

Criar um projeto 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 vão ficar disponíveis imediatamente para os usuários do Meet. Os usuários vão notar essas atualizações assim que esvaziarem o cache ou quando ele expirar. Portanto, recomendamos não enviar as alterações 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 do Google Cloud separado e publicado de forma privada para sua organização. Esse projeto do Cloud hospeda os ambientes de preparo e desenvolvimento do seu complemento do Meet. O acesso a esse projeto do Cloud precisa ser limitado a uma equipe menor que esteja trabalhando diretamente no desenvolvimento do seu complemento.

Para criar esses ambientes alternativos para o complemento, primeiro é necessário hospedar ambientes alternativos do aplicativo da Web que contem o complemento em um domínio que você possui. Em seguida, crie ambientes alternativos para o complemento do Meet adicionando mais implantações ao projeto de pré-produção do Google Cloud. Essas novas implantações precisam ter manifestos que apontam 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 nos testes.
  • Desenvolvimento: clique em Install na coluna Actions para instalar a versão de desenvolvimento do complemento do Meet apenas na sua conta.

Programar 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 todas as funcionalidades não relacionadas ao SDK do seu complemento com o framework de teste da Web preferido.

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 no painel lateral. Isso é feito definindo o estado de início da atividade no JavaScript. Todos os dados que vão para o ActivityStartingState precisam ser definidos pelo iniciador do complemento (normalmente o organizador da reunião) no painel lateral. Você pode considerar a primeira visualização do painel lateral como 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 método startActivity(), 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 quando o estágio principal estiver aberto chamando o método unloadSidePanel().

Promover seu complemento do Meet com o 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 seu complemento do Meet, o Meet poderá ser configurado para mostrar um banner a todos os participantes da chamada, solicitando que eles instalem ou usem o complemento correspondente. Para mais informações, consulte Como promover seu complemento com o compartilhamento de tela.

Diretrizes de design de logotipos

Siga estas diretrizes ao projetar seu logotipo específico do Meet para deixá-lo com a melhor aparência agora e no futuro:

Use o formato de arquivo PNG, com tamanho de 256 x 256 px.

Use transparência.

Verifique se o logotipo no modo escuro fica bom usando as ferramentas para desenvolvedores de complementos do Meet.

Obedeça aos requisitos gráficos para integrações específicas de apps.

Não inclua padding na imagem. Em vez disso, estenda a imagem até os limites do arquivo.