Visão geral dos espaços para reuniões do Google Meet

Ilustração da API REST do Google Meet

Este guia explica como a API REST do Google Meet permite criar e gerenciar reuniões no Google Meet.

Um espaço para reuniões representa um lugar virtual ou um objeto persistente (como uma sala de reunião) onde as conferências são realizadas. 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 encontrar e encontrar recursos compartilhados.

Para trabalhar com espaços de reunião, consulte Criar e gerenciar espaços. Para saber como configurar um espaço para reuniões de maneira programática, consulte Configurar espaços para reuniões e membros.

Como chamar os métodos de espaço para reuniões

A tabela de comparação a seguir detalha as funções de reunião necessárias para usar os métodos de espaço para reuniões:

Método Proprietários Participantes Outros
endActiveConference
get
com configurações
com conferência ativa
patch

Como o Meet identifica um espaço para reuniões

A API REST do Google Meet gera um spaces recurso para cada espaço para reuniões. O recurso spaces oferece vários pontos de entrada para participar de uma conferência.

A tabela a seguir mostra como identificar e participar de um espaço para reuniões:

Nome do campo Descrição
name O nome do espaço. A string {space} é o identificador de recurso do espaço e é formatada como spaces/{space}. É um ID exclusivo gerado pelo servidor e diferencia maiúsculas de minúsculas. Por exemplo, spaces/jQCFfuBOdN5z.
meetingCode O alias do nome do espaço. O {meetingCode} é uma string de caracteres exclusiva e não diferencia maiúsculas de minúsculas. Ele é formatado como spaces/{meetingCode}. Por exemplo, spaces/abc-mnop-xyz. O comprimento máximo é de 128 caracteres. Ele faz parte do meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Os métodos de acesso por telefone para esse espaço para reuniões. O objeto phoneAccess contém as informações necessárias para ligar para uma conferência, incluindo os números de telefone regionais do espaço para reuniões e um código PIN específico para esse número de telefone. O PIN consiste apenas em dígitos decimais, e o comprimento pode variar. Por exemplo, "pin": 19707127300.

Semelhante à interface do Meet, o recurso spaces inclui um conjunto limitado de números de discagem. É possível conferir outros números de telefone de um espaço para reuniões anexando o {meetingCode} ao URL a seguir: https://meet.google.com/tel/. Por exemplo, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Os métodos de acesso ao protocolo de início de sessão (SIP) para esse espaço para reuniões. Um endereço SIP detalha como o hardware de videoconferência de terceiros pode encontrar e participar de uma conferência do Meet. O objeto gatewaySipAccess contém um URI e um código de acesso numérico. O Meet oferece suporte ao esquema de URI SIP.

Para gerenciar um espaço para reuniões, use os seguintes valores para o name campo:

  • Para obter detalhes sobre um espaço para reuniões, use spaces/{space} ou o alias spaces/{meetingCode}. Para mais informações, consulte Receber um espaço de reunião.

  • Para atualizar os detalhes de um espaço para reuniões, use apenas spaces/{space}. Para mais informações, consulte Atualizar um espaço de reunião.

  • Para encerrar uma conferência ativa em um espaço para reuniões, use apenas spaces/{space}. Para mais informações, consulte Encerrar a conferência ativa.

Ciclo de vida de um espaço para reuniões

Um espaço para reuniões passa por vários estados durante o ciclo de vida. O diagrama a seguir mostra as etapas gerais de um ciclo de vida de espaço para reuniões:

O ciclo de vida do espaço para reuniões.
Figura 1. O ciclo de vida de um espaço para reuniões.

  1. Chame spaces.create. O espaço para reuniões é criado, e o objeto spaces retornado contém a string meetingUri. O meetingUri é distribuído aos participantes.

  2. Sondar o novo espaço para reuniões. Chame o spaces.get método para verificar o estado da conferência.

    Em vez de pesquisar, você também pode se inscrever em eventos do Meet para receber notificações push.

  3. Inicie a conferência. Quando o primeiro participante clica no meetingUri dentro do espaço para reuniões, uma conferência é iniciada. O objeto activeConference é preenchido, e a string activeConference.conferenceRecord é definida.

  4. (Opcional) Receba dados da conferência. Durante uma conferência ativa, é possível acessar alguns valores de conferenceRecord. Por exemplo, chame o conferenceRecords.participants.list método para conferir todos os participantes da conferência. Também é possível acessar essas informações por até 30 dias após a conferência.

  5. (Opcional) Encerre a conferência. Durante a conferência, o proprietário da reunião pode chamar o spaces.endActiveConference método para encerrar uma conferência ativa de maneira programática para todos os participantes.

  6. A conferência termina. Quando o último participante sai, a conferência termina.

  7. Pesquise artefatos pós-conferência. A conferência terminou (STATE=ENDED), mas os artefatos ainda não foram gerados. O startTime e o endTime da conferência também são preenchidos. É necessário pesquisar o endpoint do artefato até que o objeto de artefato STATE leia FILE_GENERATED.

    Em vez de pesquisar, você pode se inscrever em eventos do Meet para receber notificações push.

  8. Receba artefatos pós-conferência. É possível recuperar artefatos como gravações e transcrições depois que eles são gerados. Por exemplo, chame o conferenceRecords.recordings.get método para receber uma gravação pelo ID de gravação.

    Quando estiver pronto, um URI para o objeto de artefato será preenchido e retornado como parte do objeto de recurso.