Com a API REST do Google Meet, você pode criar e gerenciar reuniões no Google Meet e oferecer pontos de entrada aos usuários diretamente no seu app.
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).
Também é possível 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 de um usuário especificado. Para mais informações, consulte Assinar 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 executar as seguintes tarefas:
Antes de uma conferência: crie um espaço para personalizar a experiência de videoconferência conforme necessário. Também é possível gerenciar convidados e pré-definir as configuraçõ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 uso da API REST do Meet:
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.
- Execute transcrições e gravações com modelos de IA para gerar treinamento 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.
- Recupere gravações que permitam aos estudantes revisar os materiais após o término do curso.
Operações do desenvolvedor
- Crie reuniões para conectar instantaneamente colegas de equipe.
- Permitir 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 por modelos de IA para gerar as próximas etapas corretas.
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 videoconferência.
- Evento da agenda
- Um evento no Google Agenda com vários convidados, geralmente criado pelo organizador da reunião, que contém as informações de participação. O Meet pode ser a solução de videoconferência para o evento.
- Ligar
- Uma sessão usando o Meet ou para notificar outras pessoas de que uma chamada está iniciando ou em andamento e permitir que elas entrem imediatamente.
- Conferência
- Uma videoconferência é uma instância de uma chamada em um espaço de reunião. Os usuários geralmente consideram esse cenário uma única reunião.
- Co-host
- Uma pessoa em uma chamada que recebeu privilégios de gerenciamento de hosts de 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 a controla. O organizador pode organizar a reunião, mas não estar presente no momento em que ela ocorrer. Um host também pode delegar privilégios de host a um coorganizador.
- Código da reunião
Uma string exclusiva e tipada de 10 caracteres de um espaço para reuniões usado no URI de reunião de um espaço desse tipo. 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 para reuniões e podem ser reutilizados em diferentes espaços no 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ões no Google Meet.
- Nome da reunião
Um código 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 camponame
de um recursospaces
.- 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 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 conferências) em que uma conferência é realizada. 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 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 que consiste em
https://meet.google.com/
seguido do código da reunião. Por exemplo,https://meet.google.com/abc-mnop-xyz
.- 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 e dispositivo que participa de uma chamada. Há um recurso
conferenceRecords.participants.participantSessions
para cada sessão. Se o participante entrar na mesma chamada várias vezes usando o mesmo par de participante e dispositivo, serão atribuídos IDs de sessão exclusivos a cada um.
Informações de autorização e autenticação específicas da API
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 não são necessários para o app. Os usuários concedem mais acesso 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ão a que o usuário tenha acesso. | Sensível |
https://www.googleapis.com/auth/meetings.space.created |
Permite que os apps criem, modifiquem e leiam metadados sobre os espaços para reuniões criados pelo seu app. | Sensível |
https://www.googleapis.com/auth/drive.readonly |
Permitir que os 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.
Temas relacionados
Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo como lidar com autenticação e autorização, consulte Desenvolver no Google Workspace.
Para saber como criar um espaço para reuniões com a API REST do Meet, leia o guia Trabalhar com espaços para reuniões.
Para saber como se inscrever em eventos do Google Workspace, consulte Inscrever-se em eventos usando a API Google Workspace Events.