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.
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 recursospaces
. - 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.
Temas relacionados
Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo o processamento de 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 de reunião.
Para saber como se inscrever em eventos do Google Workspace, consulte Inscrever-se em eventos usando a API Google Workspace Events.