Visão geral da API REST do Google Meet

Com a API REST do Google Meet, você pode criar e gerenciar reuniões no Google Meet e oferecer pontos de entrada aos usuários diretamente no seu app.

Com a API REST do Meet, você pode fazer o seguinte:

  • Crie um espaço de reunião para conectar usuários por vídeo.
  • Encontre um espaço para reuniões ou uma videoconferência pelo nome do recurso.
  • Receba uma lista de participantes e sessões de participantes.
  • Receba artefatos da reunião (gravações, transcrições e entradas de transcrição).

Também é possível se inscrever em eventos do Meet usando a API Google Workspace Events. Para receber notificações sobre mudanças, inscreva-se em um espaço de reunião especificado ou em todos os espaços de reunião de um usuário especificado. Para mais informações, consulte Assinar eventos usando a API Google Workspace Events e Assinar eventos do Google Meet.

Casos de uso

Os apps podem ser integrados à API REST do Meet para executar as seguintes tarefas:

  • Antes de uma conferência: crie um espaço para personalizar a experiência de videoconferência conforme necessário. Também é possível gerenciar convidados e pré-definir as configurações.

  • Durante uma videoconferência: recupere informações da videoconferência para mudar a experiência do app com base nos metadados retornados.

  • Após uma videoconferência: busque artefatos da videoconferência, como a gravação e a transcrição.

Confira alguns exemplos de uso da API REST do Meet:

  • Vendas e gerenciamento de contas

    • Recupere informações da reunião e dos participantes para fins de registro.
    • Busque e publique os artefatos da reunião nas contas.
    • Execute transcrições e gravações com modelos de IA para gerar treinamento e análise de eficácia de vendas.

  • Aprendizado e desenvolvimento

    • Crie e pré-configure reuniões para treinamento.
    • Atribua funções de coorganizador a instrutores e líderes de sessão.
    • Recupere gravações que permitam aos estudantes revisar os materiais após o término do curso.

  • Operações do desenvolvedor

    • Crie reuniões para conectar instantaneamente colegas de equipe.
    • Permitir que outras partes interessadas participem de reuniões em andamento compartilhando informações de reuniões e participantes em tempo real.
    • Execute dados de transcrição por modelos de IA para gerar as próximas etapas corretas.
Crie e participe de reuniões dinâmicas com colegas de trabalho em um espaço do Chat.
Figura 1. Crie e participe de reuniões dinâmicas com colegas de trabalho em um espaço do Chat.

Também é possível incorporar outras APIs do Google Workspace, como a API Chat, ao seu app para melhorar ainda mais a colaboração. Para mais informações, consulte Casos de uso do Chat.

Termos comuns

Veja a seguir uma lista de termos comuns usados nessa API:

Artefato
Um arquivo gerado pelo Meet em resposta a uma conferência, como gravações e transcripts. Normalmente, um artefato está pronto para ser buscado logo após o término de uma videoconferência.
Evento da agenda
Um evento no Google Agenda com vários convidados, geralmente criado pelo organizador da reunião, que contém as informações de participação. O Meet pode ser a solução de videoconferência para o evento.
Ligar
Uma sessão usando o Meet ou para notificar outras pessoas de que uma chamada está iniciando ou em andamento e permitir que elas entrem imediatamente.
Conferência
Uma videoconferência é uma instância de uma chamada em um espaço de reunião. Os usuários geralmente consideram esse cenário uma única reunião.
Co-host
Uma pessoa em uma chamada que recebeu privilégios de gerenciamento de hosts de um host, com exceção da capacidade de remover o host original.
Host
A pessoa que criou uma chamada (o organizador da reunião) ou a pessoa que a controla. O organizador pode organizar a reunião, mas não estar presente no momento em que ela ocorrer. Um host também pode delegar privilégios de host a um coorganizador.
Código da reunião

Uma string exclusiva e tipada de 10 caracteres de um espaço para reuniões usado no URI de reunião de um espaço desse tipo. Não diferencia maiúsculas de minúsculas. Por exemplo, abc-mnop-xyz. O tamanho máximo é de 128 caracteres.

Os códigos de reunião não devem ser armazenados por muito tempo, porque podem ser dissociados de um espaço para reuniões e podem ser reutilizados em diferentes espaços no futuro. Geralmente, os códigos de reunião expiram 365 dias após o último uso. Para mais informações, consulte Saiba mais sobre os códigos de reuniões no Google Meet.

Nome da reunião

Um código exclusivo gerado pelo servidor usado para identificar um espaço para reuniões. Ele diferencia maiúsculas de minúsculas. Por exemplo, jQCFfuBOdN5z. O ID da reunião é retornado no campo name de um recurso spaces.

Organizador da reunião

O usuário que criou o espaço para reuniões. Esse usuário também pode ser considerado o proprietário da reunião. Talvez ele não esteja presente durante a chamada ou seja o organizador da reunião. Só pode haver um organizador de reunião.

Espaço para reuniões

Um lugar virtual ou um objeto persistente (como uma sala de conferências) em que uma conferência é realizada. Apenas uma conferência ativa pode ser realizada em um espaço por vez. Um espaço para reuniões também ajuda os usuários a se encontrarem e encontrarem recursos compartilhados.

URI da reunião

Um URL clicável que inicia ou conecta um usuário a uma chamada. Cada chamada tem um URL exclusivo que consiste em https://meet.google.com/ seguido do código da reunião. Por exemplo, https://meet.google.com/abc-mnop-xyz.

Participante

Uma pessoa entrou em uma chamada ou que usa o modo companion, assistindo como espectador ou um dispositivo de sala conectado a uma chamada. Há um recurso conferenceRecords.participants para cada pessoa. Quando um participante entra na conferência, um ID exclusivo é atribuído.

Sessão do participante

Um ID de sessão exclusivo criado para cada par de participante e dispositivo que participa de uma chamada. Há um recurso conferenceRecords.participants.participantSessions para cada sessão. Se o participante entrar na mesma chamada várias vezes usando o mesmo par de participante e dispositivo, serão atribuídos IDs de sessão exclusivos a cada um.

Informações de autorização e autenticação específicas da API

Escopos de autorização são as permissões que você solicita que os usuários autorizem para que seu app acesse o conteúdo da reunião. Quando alguém instala seu app, o usuário é solicitado a validar esses escopos. Geralmente, escolha o escopo mais estreito possível e evite solicitar escopos que não são necessários para o app. Os usuários concedem mais acesso a escopos limitados e claramente descritos.

A API REST do Meet é compatível com os seguintes escopos do OAuth 2.0:

Código do escopo Descrição Uso
https://www.googleapis.com/auth/meetings.space.readonly Permitir que os apps leiam metadados sobre qualquer espaço para reunião a que o usuário tenha acesso. Sensível
https://www.googleapis.com/auth/meetings.space.created Permite que os apps criem, modifiquem e leiam metadados sobre os espaços para reuniões criados pelo seu app. Sensível
https://www.googleapis.com/auth/drive.readonly Permitir que os apps façam o download de arquivos de gravação e transcrição da API Google Drive. Restrito

Para mais informações sobre escopos específicos do OAuth 2.0, consulte Escopos do OAuth 2.0 para APIs do Google.