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

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

  • Crie um espaço para reuniões para conectar os usuários por vídeo.
  • Escolha um espaço para reuniões ou uma videoconferência pelo nome do recurso.
  • Receba uma lista de participantes e sessões dos participantes.
  • Acessar artefatos 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 especificado 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 Assinar 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: adapte a experiência de videoconferência conforme necessário criando o espaço para reuniões. Também é possível gerenciar convidados e pré-definir as configurações.

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

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

Alguns exemplos de situações em que você pode usar a API REST do Meet incluem:

  • Vendas e gerenciamento de contas

    • Recuperar informações da reunião e do participante para fins de registro.
    • Busque e publique artefatos da reunião nas contas.
    • Execute transcrições e gravações usando modelos de IA para gerar coaching e análises de eficácia de vendas.

  • Aprendizado e desenvolvimento

    • Criar e pré-configurar reuniões para treinamento.
    • Atribua papéis de coorganizador a instrutores e líderes de sessão.
    • Recupere gravações que permitem aos alunos revisar materiais após o término do curso.

  • Operações do desenvolvedor

    • Crie reuniões para conectar colegas de equipe instantaneamente.
    • Permita que outras partes interessadas participem de reuniões em andamento compartilhando informações da reunião e do participante em tempo real.
    • Execute dados de transcrição usando 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 melhorar ainda mais a colaboração. 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 transcripts. Normalmente, um artefato está 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ão, contendo as informações de participação. O Meet pode ser a solução de conferência para o evento.
Ligar
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 é um exemplo de chamada em um espaço para reuniões. Os usuários costumam considerar este cenário como uma única reunião.
Co-host
Uma pessoa em uma chamada que recebeu privilégios de gerenciamento de hosts de um host, exceto a 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. Um organizador pode organizar a reunião, mas não está presente quando ela ocorrer. Um host também pode delegar privilégios de host a um co-host.
Código da reunião
Uma string única e digitado de 10 caracteres para um espaço para reuniões usada no URL de participação de um espaço. Por exemplo, abc-mnop-xyz. 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 podem ser reutilizados em outros espaços no futuro. Geralmente, os códigos expiram 365 dias após a última utilização. Para mais informações, consulte Saiba mais sobre códigos de reuniões no Google Meet.
Nome da reunião
Um ID exclusivo gerado pelo servidor usado para identificar um espaço para reuniões. 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 para reunião. Esse usuário também pode ser considerado o proprietário da reunião. Talvez ele não esteja presente durante a chamada ou seja 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) onde é realizada uma conferência. Apenas uma conferência ativa pode ser realizada em um espaço por vez. Um espaço para reuniões também ajuda os usuários a encontrar e encontrar recursos compartilhados.
Participante
Uma pessoa entrou em 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 ingressa em uma chamada. 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 receberá IDs exclusivos de sessão.

Informações de autorização e autenticação específicas da API

Os escopos de autorização são as permissões que você solicita que os usuários autorizem para que seu app acesse o conteúdo da reunião. Quando alguém instala seu app, o usuário é solicitado a validar esses escopos. Geralmente, escolha o escopo mais estreito possível e evite solicitar escopos que seu app não exige. Os usuários concedem acesso mais imediato a escopos limitados e claramente descritos.

A API REST do Meet é compatível com os seguintes escopos do OAuth 2.0:

Código do escopo Descrição Uso
https://www.googleapis.com/auth/meetings.space.readonly Permitir que os apps leiam metadados sobre qualquer espaço para reuniões a que o usuário tenha acesso. Sensível
https://www.googleapis.com/auth/meetings.space.created Permita que os apps criem, modifiquem e leiam metadados sobre espaços de reunião criados pelo seu app. Sensível
https://www.googleapis.com/auth/drive.readonly Permitir que apps façam o download de arquivos de gravação e transcrição da API Google Drive. Restrito

Para mais informações sobre escopos específicos do OAuth 2.0, consulte Escopos do OAuth 2.0 para APIs do Google.