Um espaço de reunião representa um lugar virtual ou um objeto persistente (como uma sala de reunião) em que as conferências são realizadas. Só é possível realizar uma videoconferência ativa em um espaço por vez. Um espaço de reunião também ajuda os usuários a encontrar e acessar recursos compartilhados.
As seções a seguir detalham como criar, acessar e atualizar um espaço de reunião.
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 a seguir duas maneiras importantes de identificar um espaço de reunião usando o campo
name
:
space
é o identificador de recurso do espaço, formatado comospaces/{space}
. É um ID exclusivo gerado pelo servidor e diferencia maiúsculas de minúsculas. Por exemplo,spaces/jQCFfuBOdN5z
.meetingCode
é um alias para o espaço, formatado comospaces/{meetingCode}
. É uma string de caracteres única que pode ser digitada e não diferencia maiúsculas de minúsculas. Por exemplo,abc-mnop-xyz
. O comprimento máximo é de 128 caracteres. Ele faz parte domeetingUri
:https://meet.google.com/abc-mnop-xyz
.
Para gerenciar um espaço de reunião, use os seguintes valores para o campo {name}
:
Para saber mais sobre um espaço de reunião, use
spaces/{space}
ou o aliasspaces/{meetingCode}
. Para mais informações, consulte Criar um espaço de reunião.Para atualizar os detalhes de um espaço de reunião, só é possível usar
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, só é possível usar
spaces/{space}
. Para mais informações, consulte Encerrar a conferência ativa.
Criar um espaço de reunião
Para criar um espaço de reunião, use o método
create
no recurso
spaces
.
O método retorna uma instância de um recurso spaces
, que inclui o
objeto SpaceConfig
, que é
a configuração do espaço de reunião. Ele também contém o objeto
ActiveConference
,
que é um link para o recurso
conferenceRecords
atual
no espaço de reunião.
O exemplo de código a seguir mostra como criar um espaço de reunião:
Java
Node.js
Python
Acessar um espaço para reuniões
Para conferir detalhes sobre um espaço de reunião, use o método
get
no recurso
spaces
com um name
especificado.
Para mais informações, consulte Como o Meet identifica um espaço de
reunião.
O método retorna um espaço de reunião como uma instância do recurso
space
.
O exemplo de código abaixo mostra como recuperar um espaço de reunião:
Java
Node.js
Python
Substitua o nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reuniões.
Atualizar um espaço de reunião
Para atualizar os detalhes de um espaço de reunião, use o método
patch
no recurso
spaces
com um name
especificado.
Para mais informações, consulte Como o Meet identifica um espaço de
reunião.
O método patch
também usa um parâmetro updateMask
opcional. O campo é
do tipo
FieldMask
.
Esta é uma lista delimitada por vírgulas dos campos que você quer atualizar no espaço.
O método retorna um espaço de reunião como uma instância do
recurso spaces
.
O exemplo de código a seguir mostra como atualizar um espaço de reunião:
Java
Node.js
Python
Substitua o nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.
Encerrar a conferência ativa
Para encerrar uma conferência ativa em um espaço de reunião, use o método
spaces.endActiveConference
no recurso spaces
. O
corpo da solicitação e da resposta estão vazios. Para mais informações, consulte Como
o Meet identifica um espaço de reunião.
O exemplo de código a seguir mostra como encerrar uma conferência ativa:
Java
Node.js
Python
Substitua o nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.