Visão geral da API REST do Google Meet

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

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

Você também pode se inscrever em eventos do Meet usando o na API Google Workspace Events. Para receber notificações sobre as mudanças, inscreva-se em um espaço para reuniões especificado ou a todos os espaços de reunião de um usuário específico. Para mais informações, consulte Inscrever-se em eventos usando o API Google Workspace Events e Assine o Google Meet .

Casos de uso

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

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

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

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

Alguns exemplos do uso da API REST do Meet incluem o seguintes:

  • 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.
    • Faça transcrições e gravações com modelos de IA para gerar coaching 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.
    • Recuperar gravações que permitem aos estudantes revisar os materiais após o curso as pontas.
  • Operações do desenvolvedor

    • Crie reuniões para conectar instantaneamente colegas de equipe.
    • Permita que outras partes interessadas participem de reuniões em andamento compartilhando informações em tempo real informações da reunião e dos participantes.
    • Executar dados de transcrição por modelos de IA para gerar a string correta etapas.
.
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 aplicativo para levar a colaboração ainda mais longe. 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 transcrições. 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 participantes, normalmente criado por um organizador da reunião, contendo as informações de participação de uma reunião. O Meet pode ser a solução de videoconferência para o evento.
Ligar
Uma sessão usando o Meet ou para notificar as outras pessoas de que uma chamada está iniciando ou em andamento e permite a participação imediatamente.
Conferência
Uma videoconferência é uma instância de uma chamada em um espaço de reunião. Usuários normalmente considere esse cenário como uma única reunião.
Co-host
Uma pessoa em uma chamada que recebeu privilégios de gerenciamento de organizadores por 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 controla a chamada. O organizador pode organizá-la mas não estar presente quando acontecer. Um organizador também pode delegar privilégios a um coorganizador.
Código da reunião

Uma string única e tipada de 10 caracteres para um espaço de reunião usado em URI de reunião de um espaço de reunião. 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 se dissociar de um espaço para reuniões e podem ser reutilizados em diferentes espaços da 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ão no Google Meet

Nome da reunião

Um código exclusivo gerado pelo servidor usado para identificar um espaço para reuniões. É o caso sensíveis. Por exemplo, jQCFfuBOdN5z. O ID da reunião é retornado Campo name de um recurso spaces.

Organizador da reunião

O usuário que criou o espaço para reuniões. Este 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ão.

Espaço para reuniões

Um lugar virtual ou um objeto persistente (como uma sala de conferências) em que um videoconferência. Apenas uma conferência ativa pode ser realizada em um espaço em a qualquer momento. 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 consistindo em https://meet.google.com/ seguido pela reunião código. Por exemplo, https://meet.google.com/abc-mnop-xyz.

Participante

Uma pessoa entrou em uma chamada ou que usa o modo Companion completo, assistindo visualizador ou um dispositivo da sala conectado a uma chamada. Há um conferenceRecords.participants recurso 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 call. Há um conferenceRecords.participants.participantSessions recurso para cada sessão. Se o participante entrar na mesma chamada várias vezes do mesmo par de participante e dispositivo, cada participante recebe IDs de sessão.