Implantar um complemento do Meet

Os complementos do Google Meet são criados e configurados como parte de um projeto do Google Cloud.

Criar um projeto do Google Cloud

Para gerar um projeto do Google Cloud, consulte Criar um projeto do Google Cloud.

Ativar o SDK do Google Workspace Marketplace e a API Google Workspace Add-ons

O SDK do Google Workspace Marketplace e a API Google Workspace Add-ons são necessários para desenvolver complementos do Meet. Para ativá-las:

  1. Abra o console do Google Cloud.
  2. Na parte de cima, se um projeto diferente já estiver aberto, selecione o nome do projeto do app para mudar.
  3. Na parte de cima, na barra de pesquisa, digite Google Workspace Marketplace SDK e pressione Enter.
  4. Abra a página Google Workspace Marketplace SDK e clique em Ativar.

  5. Repita essas etapas para encontrar e ativar o Google Workspace add-ons API.

Criar uma implantação

Para usar um complemento no Meet, você precisa de uma implantação e um arquivo de manifesto do complemento.

  1. Abra o console do Google Cloud.
  2. Na parte de cima, se um projeto diferente já estiver aberto, selecione o nome do projeto do app para mudar.
  3. Clique em APIs e serviços.
  4. Selecione Google Workspace Marketplace SDK para abrir a página de detalhes.

Criar a implantação

É possível criar sua implantação diretamente no console do Google Cloud criando uma implantação HTTP (recomendada) ou usando o Google Apps Script.

Implantação HTTP

  1. Clique na guia Implantações HTTP.
  2. Clique em Criar nova implantação e insira o ID de implantação do complemento.

    O ID de implantação é uma string arbitrária que ajuda o desenvolvedor de complementos a identificar a implantação que contém o manifesto do complemento. Os IDs de implantação são obrigatórios e podem ter no máximo 100 caracteres.

  3. Clique em Próxima.

    Um painel lateral será aberto para você enviar a especificação do manifesto do complemento no formato JSON. Isso também é chamado de DEPLOYMENT.JSON.

    O arquivo de manifesto do complemento é a configuração central de um complemento do Google Meet. O exemplo de código a seguir mostra os campos do Meet disponíveis para a Web no arquivo de manifesto do complemento.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Substitua:

    • NAME: string. O nome do seu complemento do Google Meet.
    • LOGO_URL: string. O URL do logotipo do complemento do Google Workspace. Isso é usado para o complemento em todos os produtos do Google Workspace.
    • SIDE_PANEL_URI: string. O URL do ponto de entrada do app complementar. Ele é exibido em um iframe no painel lateral. A origem desse URL precisa fazer parte das origens especificadas no campo ADD_ON_ORIGINS.
    • ADD_ON_ORIGINS: lista de strings. Uma lista de origens em que seu complemento está hospedado. Dois URLs têm a mesma origem quando compartilham o mesmo esquema, host e porta. Suborigens e subdomínios curinga também são permitidos. Para mais informações, consulte Segurança de complementos.
    • DARK_MODE_LOGO_URL: string. Um URL específico do modo noturno do logotipo do complemento. Fornecer um logotipo para o modo escuro garante que o complemento terá a melhor aparência em qualquer tema do Meet. Para diretrizes de design de logo, consulte Práticas recomendadas.
    • MEET_WEB_LOGO_URL: opcional. String. Um URL específico do Meet para o logotipo do complemento. Esse logotipo é usado em todo o Meet. Se não estiver presente, o logoUrl da seção comum será usado. Para conferir as diretrizes de design de logotipo, consulte Práticas recomendadas.
    • SUPPORTS_SCREENSHARING: opcional. Booleano. Se definido como "false", os usuários precisarão usar o complemento para ver o que está acontecendo em uma sessão colaborativa. Se definida como "true", o iniciador da sessão de complemento colaborativo poderá compartilhar a tela da visualização do complemento.
  4. Clique em Enviar.

    Para mais informações sobre implantações, consulte Criar um recurso de implantação.

  5. Na guia Configuração do app, em Integração do app, selecione Complemento do Google Workspace. Selecione Implantar com o recurso de implantação na nuvem e escolha a implantação HTTP correta.

Google Apps Script

  1. Clique na guia Configuração do app.

  2. Em Integração de apps, selecione Complemento do Google Workspace. Selecione Implantar usando o ID de implantação do Google Apps Script e insira o ID de implantação do seu script.

  3. Clique em Salvar.

    Para detalhes sobre como criar um projeto do Apps Script, consulte a documentação do Apps Script. O complemento do Meet depende apenas do arquivo de manifesto appsscript.json, também chamado de manifesto do projeto do Apps Script. Verifique se o arquivo de manifesto no seu projeto do Apps Script contém uma seção addOns e uma meet. As seções addOns e meet seguem a mesma estrutura descrita na guia de implantação HTTP.

    Ao contrário de outros complementos do Google Workspace, os complementos do Meet não podem ser criados totalmente no Apps Script. Em vez disso, crie um app da Web completo criando um painel lateral e um palco principal. O URL do painel lateral do seu web app precisa ser especificado em SIDE_PANEL_URI do arquivo de manifesto appsscript.json.

Instalar e testar o complemento no Meet

Para testar o complemento no Meet, primeiro instale-o para o usuário conectado:

Implantação HTTP

  1. Acesse o SDK do Google Workspace Marketplace para seu projeto no console do Google Cloud.
  2. Clique na guia Implantações HTTP.
  3. Clique em Instalar na coluna Ações.

Google Apps Script

  1. Siga a documentação do complemento do Google Workspace para instalar um complemento não publicado.

Agora você pode usar o complemento em uma reunião. Para testar, inicie uma reunião em meet.google.com. O complemento instalado agora está visível no painel Atividades.

Além de instalar o complemento para o usuário conectado, você também pode publicá-lo. Ao publicar seu complemento do Google Workspace, você o disponibiliza para que outras pessoas encontrem, instalem e usem.