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.

Assim como na 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.