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 para o 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 participantes.

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

A autenticação e a autorização com credenciais de usuário permitem que os apps do Google Meet acessem dados do usuário e realizem operações em nome do usuário autenticado. A autenticação com delegação em todo o domínio permite autorizar a conta de serviço de um aplicativo a acessar os dados dos usuários sem precisar pedir o consentimento de cada um.

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 campo name é o nome do recurso.

Confira duas maneiras importantes de identificar um espaço de reunião usando o campo name:

  • space_id é o identificador do recurso para o espaço, formatado como spaces/{space}. É um ID exclusivo gerado pelo servidor e diferencia maiúsculas de minúsculas. Por exemplo, spaces/jQCFfuBOdN5z.

  • meetingCode é um alias do espaço, formatado como spaces/{meetingCode}. É uma string de caracteres exclusiva e digitável, que não diferencia maiúsculas de minúsculas. Por exemplo, abc-mnop-xyz. O tamanho máximo é de 128 caracteres. Ele faz parte do meetingUri: https://meet.google.com/abc-mnop-xyz.

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

  • Para ver 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.