Criar um complemento do Meet

Os complementos do 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 outro projeto já estiver aberto, selecione o nome do projeto do app para trocar 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 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 de um arquivo de manifesto de complemento.

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

  5. Opção A: usar uma implantação de ambiente de execução alternativa

    1. Clique na guia Ambientes de execução alternativos.

    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 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. 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.

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

      Substitua:

      • NAME: string. O nome do seu complemento do Google Meet.
      • LOGO_URL: string. O URL do logotipo do complemento do Meet.
      • SIDE_PANEL_URI: string. O URL do iframe do painel lateral. A origin desse URL precisa fazer parte das origens especificadas no campo ADD_ON_ORIGINS.
      • SUPPORTS_SCREENSHARING: opcional. Booleano. Se definido como falso, os usuários precisarão usar o complemento para ver o que está acontecendo em uma sessão de complemento colaborativa. Se definido como verdadeiro, o iniciador da sessão colaborativa de complemento poderá compartilhar a tela dele.
      • MEET_WEB_LOGO_URL: opcional. String. Um URL específico do Meet do logotipo do complemento.
      • ADD_ON_ORIGINS: lista de strings. Uma lista de origens que seu complemento está usando. Dois URLs têm a mesma origem quando compartilham o mesmo esquema, host e porta. Suborigens também são permitidas. Para mais informações, consulte Segurança de complementos.

    4. Clique em Enviar.

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

    5. Opcional: para fins de teste, o usuário conectado pode instalar o complemento clicando em Instalar na coluna Ações.

    6. Na guia Configuração do app, em Integração de apps, selecione Complemento do Google Workspace. Selecione Implantar usando o recurso de implantação da nuvem e escolha a implantação alternativa correta do ambiente de execução.

    Opção B: usar uma implantação do Google Apps Script.

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

    2. Em Integração do app, 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. Não é necessário escrever códigos do Apps Script. O complemento do Meet depende apenas do "appsscript.json", também chamado de arquivo de manifesto. 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 "Opção A".

Publicar o complemento

Se você quiser que outros usuários possam instalar seu complemento ou testar o fluxo de entrada do compartilhamento de tela, o complemento precisará ser publicado. Um complemento pode ser publicado de forma privada (o complemento só pode ser acessado no seu domínio) ou publicamente. Mesmo quando o complemento é publicado, você controla se os usuários poderão encontrá-lo usando o Google Workspace Marketplace ou um link direto.

Para mais informações, consulte estas instruções sobre como publicar um complemento.

Abrir o complemento no Meet

Crie uma reunião em meet.google.com. O complemento instalado agora aparece no painel "Complementos".