Visão geral da API REST do Google Meet

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

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

  • Criar um espaço para reuniões para conectar usuários por vídeo.
  • Encontrar um espaço para reuniões ou uma videoconferência pelo nome do recurso.
  • Acessar uma lista de participantes e sessões de participantes.
  • Acessar 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 de mudanças, inscreva-se em um espaço para reuniões específico ou em todos os espaços para reuniões pertencentes a um usuário específico. Confira mais informações em:

Casos de uso

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

  • Antes de uma videoconferência: personalize a experiência da videoconferência conforme necessário criando o espaço para reuniões. Também é possível gerenciar convidados e pré-configurar as definiçõ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 situações em que você pode usar a API REST do Meet:

  • Vendas e gerenciamento de contas

    • Recupere informações de reuniões e participantes para fins de registro.
    • Busque artefatos de reuniões e poste-os 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 que permitem que os estudantes revisem os materiais após o término do curso.

  • Operações de desenvolvedor

    • Crie reuniões para conectar colegas de equipe instantaneamente.
    • Permita 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 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.

Também é possível incorporar outras APIs do Google Workspace, como a API Chat, ao 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 nessa API:

Artefato
Um arquivo gerado pelo Meet em resposta a uma videoconferência, como recordings e transcripts. Os artefatos são salvos no Google Drive do organizador da reunião. Eles geralmente ficam prontos para serem buscados logo após o término de uma videoconferência.
Evento da agenda
Um evento no Google Agenda com vários convidados, normalmente criado por um organizador da reunião, que contém as informações de como participar de uma reunião. O Meet pode ser a solução de videoconferê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 para reuniões. Os usuários geralmente consideram esse cenário uma única reunião.
Registro de videoconferência
Um ID exclusivo para cada instância de uma videoconferência. Ele é criado automaticamente quando a videoconferência começa. O conferenceRecords recurso usa o formato conferenceRecords/{conferenceRecord}. Por exemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
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.
Ligar para reunião
Usar um smartphone para participar de uma chamada ou ouvir uma chamada transmitida.
Host
A pessoa que criou uma chamada (o organizador da reunião) ou a pessoa que controla a chamada. Um organizador de reuniões pode organizar a 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 para reuniões usado no URI da reunião de um espaço para reuniões. Ele não diferencia maiúsculas de minúsculas. Por exemplo, abc-mnop-xyz. O comprimento 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 para diferentes espaços para reuniões no futuro. Geralmente, 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 para reuniões. Ele diferencia maiúsculas de minúsculas. Por exemplo, jQCFfuBOdN5z. O ID da reunião é retornado no name campo de um spaces recurso. Para mais informações, consulte Como o Meet identifica um espaço para reuniões.

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. Ele pode não estar presente durante a chamada ou ser o organizador da reunião. Só pode haver um organizador de reuniões.

Espaço para reuniões

Um lugar virtual ou um objeto persistente (como uma sala de reunião) onde uma videoconferência é realizada. Somente uma videoconferê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 encontrar e encontrar 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 pelo código da reunião. Por exemplo, https://meet.google.com/abc-mnop-xyz.

Participante

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

Sessão do participante

Um ID de sessão exclusivo criado para cada par de dispositivo-participante que participa de uma chamada. Há um participantSessions recurso para cada sessão. Se o participante participar da mesma chamada várias vezes do mesmo par de dispositivo-participante, cada um deles receberá IDs de sessão exclusivos.

Endereço SIP

Um endereço do Session Initiation Protocol (SIP) detalha como o hardware de videoconferência de terceiros pode encontrar e participar de uma videoconferência do Meet. O Meet oferece suporte ao esquema de URI SIP.