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 do Google Meet.

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

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

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

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

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

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

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

A tabela a seguir mostra como identificar e entrar em um espaço de reunião:

Nome do campo Descrição
name O nome do espaço. A string {space} é o identificador do recurso para o 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 digitável que não diferencia maiúsculas de minúsculas. Ele é formatado como spaces/{meetingCode}. Por exemplo, spaces/abc-mnop-xyz. O tamanho 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 este espaço de reunião. 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 de reunião e um código PIN específico para esse número de telefone. O PIN consiste apenas em dígitos decimais e o tamanho pode variar. Por exemplo, "pin": 19707127300.

Semelhante à interface do Meet, o recurso spaces inclui um conjunto limitado de números de discagem. Para conferir outros números de telefone de um espaço de reunião, adicione {meetingCode} ao seguinte URL: 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 este espaço de reunião. 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 é compatível com o esquema de URI SIP.

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

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

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

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

Ciclo de vida de um espaço de reunião

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

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

  1. Ligue para spaces.create. O espaço de reunião é criado, e o objeto spaces retornado contém a string meetingUri. Em seguida, o meetingUri é distribuído aos participantes.

  2. Faça uma pesquisa sobre o novo espaço de reunião. Chame o método spaces.get para verificar o estado da conferência.

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

  3. Inicie a conferência. Quando o primeiro participante clica em meetingUri dentro do espaço da reunião, 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 método conferenceRecords.participants.list para ver todos os participantes da conferência. Você também pode acessar essas informações por até 30 dias após a conferência.

  5. (Opcional) Encerre a videoconferência. Durante a conferência, o proprietário da reunião pode chamar o método spaces.endActiveConference para encerrar programaticamente uma conferência ativa 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. Os startTime e endTime da conferência também são preenchidos. Você precisa consultar o endpoint do artefato até que o objeto STATE leia FILE_GENERATED.

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

  8. Receber 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 método conferenceRecords.recordings.get para receber uma gravação pelo ID dela.

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