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 para os usuários diretamente no app.

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

  • Crie um espaço de reunião para conectar os usuários por vídeo.
  • Encontre um espaço de reunião ou uma conferência pelo nome do recurso.
  • Receba uma lista de participantes e sessões deles.
  • Acessar os 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, você pode se inscrever em um espaço de reunião específico ou em todos os espaços de reunião pertencentes a 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 ser integrados à API REST do Meet para realizar as seguintes tarefas:

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

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

  • Depois de uma conferência: extraia artefatos da conferência, como a gravação e a transcrição.

Alguns exemplos de uso da API REST do Meet incluem:

  • Vendas e gerenciamento de contas

    • Extrair informações da reunião e dos participantes para fins de registro.
    • Buscar artefatos de reuniões e publicá-los nas contas.
    • Execute transcrições e gravações em modelos de IA para gerar análises de treinamento e eficácia de vendas.

  • Aprendizado e desenvolvimento

    • Crie e pré-configure reuniões para treinamento.
    • Atribuir funções de coorganizador a instrutores e líderes de sessão.
    • Extraia gravações para que os estudantes possam revisar os materiais depois que o curso terminar.

  • Operações para desenvolvedores

    • Crie reuniões para conectar os membros da equipe instantaneamente.
    • Compartilhe informações sobre a reunião e os participantes em tempo real para que outras partes interessadas possam participar de reuniões em andamento.
    • 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, ao seu app para melhorar ainda mais a colaboração. Para mais informações, consulte Casos de uso de 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 gravações e transcrições. 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.
Telefone
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 videoconferência é uma instância de uma ligação 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 organizadores 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 organizar a reunião, mas não estar presente quando ela acontece. O organizador também pode delegar privilégios a um coorganizador.
Código da reunião

Uma string de 10 caracteres exclusiva e acionável para um espaço de reunião usado no URI da reunião de um 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 um longo período, porque podem ser desvinculados de um espaço de reunião e reutilizados para outros espaços no futuro. Em geral, 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ã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. Eles podem não estar presentes durante a chamada ou ser 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 reunião) em que uma conferência é realizada. Apenas uma videoconferência ativa pode ser realizada em um espaço por vez. Um espaço de reunião também ajuda os usuários a encontrar e acessar recursos compartilhados.

URI da reunião

Um URL clicável que inicia ou conecta um usuário a uma ligação. 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 participou de 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-dispositivo que participa de uma ligação. Há um recurso conferenceRecords.participants.participantSessions para cada sessão. Se o participante entrar na mesma chamada várias vezes do mesmo par de participante-dispositivo, cada um deles vai receber IDs de sessão exclusivos.