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 de projeto.
  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 estas 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 de 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 de projeto.
  3. Clique em APIs e serviços.
  4. Selecione Google Workspace Marketplace SDK para acessar a página de detalhes.

Criar a implantação

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

Implantação HTTP

  1. Clique na guia Deployments HTTP.
  2. Clique em Criar nova implantação e insira o ID da implantação do complemento.

    O ID de implantação é uma string arbitrária que ajuda o desenvolvedor do complemento 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 é aberto para você enviar a especificação do manifesto do complemento no formato JSON. Ele 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 abaixo 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 complemento. 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 o complemento está hospedado. Dois URLs têm a mesma origem quando compartilham o mesmo esquema, host e porta. Sub-origens também são permitidas, assim como subdomínios curinga. Para mais informações, consulte Segurança do complemento.
    • DARK_MODE_LOGO_URL: string. Um URL específico do modo escuro do logotipo do complemento. Fornecer um logotipo no modo escuro garante que seu complemento tenha a melhor aparência em qualquer tema do Meet. Para conferir as diretrizes de design de logotipos, consulte Práticas recomendadas.
    • MEET_WEB_LOGO_URL: opcional. String. Um URL específico do Meet do 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 logotipos, consulte as Práticas recomendadas.
    • SUPPORTS_SCREENSHARING: opcional. Booleano. Se definido como falso, os usuários precisam usar o complemento para ver o que está acontecendo em uma sessão de complemento colaborativo. Se definido como "true", o iniciador da sessão de complemento colaborativo pode compartilhar a tela dele.
  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 usando 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 do seu script.

  3. Clique em Salvar.

    Para saber 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 do seu projeto do Apps Script contém uma seção addOns e meet. As seções addOns e meet seguem a mesma estrutura descrita na guia de implantação HTTP.

    Ao contrário de outros Google Workspace Add-ons, os Meet Add-ons não podem ser criados inteiramente no Apps Script. Em vez disso, crie um app da Web completo criando um painel lateral e um estágio principal. Em seguida, o URL do painel lateral do seu app da Web precisa ser especificado no SIDE_PANEL_URI do arquivo de manifesto appsscript.json.

Instalar e testar o complemento no Meet

Para testar seu complemento no Meet, primeiro é necessário instalá-lo para o usuário conectado:

Implantação HTTP

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

Google Apps Script

  1. Siga a documentação de complementos 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 o encontrem, instalem e usem.