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. Um espaço de reunião também ajuda os usuários a encontrar e acessar recursos compartilhados.
Quando você cria um espaço de reunião usando o método
spaces.create, ele retorna
uma instância de um recurso spaces. O
recurso 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.
As seções a seguir detalham como configurar um espaço de reunião usando vários objetos e métodos beta.
Definir a moderação e o acesso à reunião
Com os novos objetos Beta, agora é possível definir modos de moderação, restrições
de recursos e as permissões que os usuários recebem ao entrar em uma reunião. Elas
são definidas pelo objeto
SpaceConfig
atualizado.
O campo moderation é um modo de moderação pré-configurado para uma reunião, com
o padrão controlado pelas políticas do usuário. Ele usa o objeto
Moderation. Quando o modo de moderação está ativado, o proprietário da reunião tem controle sobre a
reunião com recursos como o gerenciamento de coorganizadores (consulte
spaces.members)
e as restrições de recursos (consulte moderationRestrictions). Para mais informações sobre
participantes, consulte Gerenciar participantes do espaço.
O campo moderationRestrictions aplica restrições de moderação à
reunião quando moderation está ativado. Ele usa o objeto
ModerationRestrictions. As restrições definem quem tem permissão para
enviar mensagens de chat e reações, compartilhar a tela e restringir
a função padrão atribuída aos usuários como espectador. O campo moderationRestrictions
depende de um
RestrictionType
para aplicar as três primeiras restrições. O RestrictionType pode ser aplicado ao
proprietário e ao coorganizador da reunião ou a todos os participantes. O
DefaultJoinAsViewerType
aplica a permissão final em que os usuários entram como colaboradores por padrão, mas
os hosts também podem restringir os usuários a participar como espectadores.
O campo firstJoinerType define se os usuários podem entrar antes do organizador em
conferências neste espaço de reunião. Ela define quais usuários podem entrar na reunião
primeiro e se outros estão em um estado de espera. Ele usa o objeto
FirstJoinerType.
Gerenciar participantes do espaço
O proprietário da reunião sempre podia entrar sem pedir, mas agora é possível
configurar membros que também podem participar sem pedir. Além disso,
os participantes podem ser configurados para ter um papel na reunião, como COHOST, que
dá a eles as mesmas habilidades de gerenciamento da reunião que o proprietário. Para
mais informações sobre como acessar um espaço de reunião sem bater, consulte
AccessType.
O recurso
spaces.members
inclui os campos name, user e role.
Um membro é diferente de um
participante. Um participante é uma pessoa que participou
de uma chamada ou que usa o modo
companion
para assistir como espectador ou um dispositivo de sala conectado a uma chamada. Há um recurso
conferenceRecords.participants
para cada pessoa.
É possível gerenciar os membros do espaço usando os seguintes métodos:
Cada método usa um parâmetro de caminho com os métodos de criação e lista usando o
campo parent para indicar o espaço de reunião e os métodos de exclusão e recebimento usando
o campo name para filtrar os resultados com base no espaço de reunião e no nome do
membro.
Todos os métodos, exceto excluir, oferecem suporte ao parâmetro fields em
SystemParameterContext
. Quando o parâmetro fields é omitido, a resposta da API é padrão para
"name,email,role,user".
O parâmetro fields depende de uma
FieldMask
para a filtragem de respostas. Uma FieldMask é uma maneira de os autores de chamadas de API listarem os campos que uma
solicitação precisa retornar. É uma lista de campos delimitada por vírgulas para especificar apenas
determinados campos em um objeto que são usados, deixando os outros campos inalterados.
O uso de um FieldMask permite que a API evite trabalho desnecessário e melhore a
performance. Uma máscara de campo é usada para métodos de criação, acesso e listagem. Para mais
informações sobre máscaras de campo, consulte Usar máscaras de campo na API Planilhas Google.