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 e configure espaços para reuniões e conecte usuários por vídeo.
  • Pré-configure níveis de acesso ao espaço, configurações de moderação e gravações ou transcrições automáticas.
  • Gerenciar os membros do espaço para reuniões e atribuir funções de coorganizador.
  • Encerrar uma conferência ativa de forma programática em um espaço para reuniões.
  • Acesse registros de conferências, detalhes de participação e metadados da sessão do participante.
  • Recuperar 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 para reuniões específico ou em todos os espaços para reuniões de um usuário específico. Para mais informações, consulte:

Casos de uso

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

  • Antes de uma conferência: crie espaços de reunião sob demanda, pré-configure restrições de acesso (aberto, confiável ou restrito), aplique controles de moderação (compartilhamento de tela, chat, reações, microfone e câmera), configure a gravação ou transcrição automática e atribua funções de coorganizador aos membros do espaço.

  • Durante uma conferência: recupere metadados ativos da conferência e sessões de participantes, gerencie membros de forma dinâmica, ouça eventos de ciclo de vida em tempo real usando a API Google Workspace Events ou encerre a conferência ativa de forma programática.

  • Depois de uma conferência: recupere registros e logs de participação, faça o download de gravações e transcrições do Google Docs no Google Drive e acesse entradas de fala detalhadas para treinamento, conformidade ou análise de IA.

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 e postagem de materiais da reunião 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.

  • Suporte ao cliente e consultoria

    • Crie espaços de reunião seguros e restritos diretamente dos tíquetes do help desk ou dos portais do cliente.
    • Pré-configure o gerenciamento de organizadores para que apenas os representantes de suporte possam apresentar ou gerenciar a participação.
    • Ative a gravação ou transcrição automática para controle de qualidade e registros de conformidade.
    • Encerre programaticamente as conferências ativas quando os agendamentos ou as sessões de suporte terminarem.

  • 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:

Conferência ativa
A conferência em andamento que acontece em um espaço para reuniões. Só é possível realizar uma videoconferência ativa por vez em um espaço para reuniões. Depois de encerrada, ela se torna um registro histórico de conferência.
Artefato
Um arquivo gerado pelo Meet em resposta a uma conferência, como recordings e transcripts. Os materiais são salvos no Drive do organizador da reunião. Eles geralmente ficam prontos para serem buscados logo após o término de uma conferência.
Evento da agenda
Um evento do Google Agenda com vários participantes, geralmente criado por um organizador de reuniões, que contém as informações de como participar 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.
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.
Conferência
Uma conferência é uma instância de uma chamada em um espaço para reuniões. Os usuários normalmente consideram esse cenário uma única reunião.
Recorde da conferência
Um ID exclusivo para cada instância de uma conferência. Ele é criado automaticamente quando a conferência começa. O recurso conferenceRecords usa o formato conferenceRecords/{conferenceRecord}. Por exemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Ligar para reunião
Para usar um smartphone e participar de uma ligação ou ouvir uma ligação transmitida.
Host
A pessoa que criou uma chamada (o organizador da reunião) ou 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 para reuniões usado no URI do espaço para reuniões. 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 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. Para mais informações, consulte Como o Meet identifica um espaço de reunião.

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

Membro

Um usuário adicionado explicitamente a um espaço para reuniões com uma função designada (como COHOST). Ao contrário de um participante, que está presente apenas durante uma conferência ao vivo, um membro está associado ao espaço para reuniões persistente e mantém os privilégios em várias conferências nesse espaço.

Participante

Uma pessoa que participa de uma chamada ou usa o modo companion 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.

Gravação

Um arquivo de vídeo MP4 e os metadados associados gerados quando uma conferência é gravada. As gravações são salvas no Drive do organizador da reunião e podem ser recuperadas como artefatos da reunião.

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 conferência do Meet. O Meet é compatível com o esquema de URI SIP.

Transcrição

Um documento de texto que captura a conversa falada de uma conferência, exportado para o Drive do organizador da reunião como um arquivo do Documentos.

Entrada de transcrição

Um segmento discreto de fala transcrita de um participante em uma conferência. Cada entrada inclui a identidade do participante, o carimbo de data/hora, o texto falado e o código do idioma, e fica disponível por 30 dias após o fim da conferência.