Visão geral da API REST do Google Meet

A API REST do Google Meet permite criar e gerenciar reuniões do Google Meet e oferece pontos de entrada aos usuários diretamente do seu app.

Com a API REST do Meet, é possível fazer o seguinte:

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

Você também pode 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 específico ou em todos os espaços de reunião de um usuário específico. Para mais informações, consulte Inscrever-se em eventos usando a API Google Workspace Events e Inscrever-se em eventos do Google Meet.

Casos de uso

Os apps podem se integrar à API REST do Meet para realizar as seguintes tarefas:

  • Antes de uma conferência: personalize a experiência conforme necessário criando o espaço de reunião. Também é possível gerenciar os convidados e pré-configurar as definições.

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

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

Confira alguns exemplos de coisas que você pode fazer com a API REST do Meet:

  • Vendas e gerenciamento de contas

    • Recuperar informações de reuniões e participantes para fins de registro.
    • Busca artefatos de reuniões e os publica em contas.
    • Execute transcrições e gravações em modelos de IA para gerar análises de coaching e 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 para que os estudantes possam revisar os materiais depois que o curso terminar.

  • Operações de desenvolvedor

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

Você também pode incorporar outras APIs do Google Workspace, como a API Chat, no seu app para aumentar ainda mais a colaboração. Para mais informações, consulte Casos de uso do chat.

Termos comuns

Confira a seguir uma lista de termos comuns usados nesta API:

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

Uma string exclusiva de 10 caracteres digitáveis para um espaço de reunião usado no URI do espaço de reunião. Ele 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 de reunião e reutilizados para diferentes espaços no futuro. Em geral, os códigos de reunião expiram 365 dias após a última utilização. Para mais informações, consulte Saiba mais sobre códigos de reunião no Google Meet.

Nome da reunião

Um ID exclusivo gerado pelo servidor usado para identificar um espaço de reunião. 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 de reunião. Esse usuário também pode ser considerado o proprietário da reunião. Talvez eles não estejam presentes durante a chamada ou sejam o organizador da reunião. Só pode haver um organizador da reunião.

Espaço para reuniões

Um lugar virtual ou um objeto persistente (como uma sala de reuniões) onde uma conferência é realizada. Só é possível realizar uma videoconferência ativa em um espaço por vez. Um espaço para reuniões também ajuda os usuários a se encontrar e encontrar recursos compartilhados.

URI da reunião

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

Participante

Uma pessoa que participa de uma chamada ou usa o modo companion, assistindo como espectador, ou um dispositivo de sala conectado a uma chamada. Há um recurso 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 participante-dispositivo que entra em uma chamada. Há um recurso participantSessions para cada sessão. Se o participante entrar na mesma chamada várias vezes usando o mesmo par participante-dispositivo, cada entrada vai receber IDs de sessão exclusivos.