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. 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. Para mais informações sobre como gerenciar um espaço de reunião, consulte
Trabalhar com espaços 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 organizador 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
os 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
organizador 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 organizador sempre podia entrar na reunião sem pedir permissão, mas agora é possível
configurar membros que também podem participar da reunião sem pedir.
Além disso, os participantes podem ter uma função na reunião, como
COHOST, que dá a eles as mesmas habilidades de gerenciamento da reunião que o
organizador. 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 delete, oferecem suporte ao parâmetro fields em
SystemParameterContext
. Quando o parâmetro fields é omitido, a resposta da API é definida como
"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.
Gerenciar artefatos automáticos
Os organizadores da reunião, mas não os coorganizadores, podem pré-configurar a gravação automática, as transcrições automáticas e a opção "Fazer anotações para mim" no espaço da reunião. Quando essas configurações são ativadas, o espaço da reunião é gravado, as transcrições são geradas e as anotações da reunião são capturadas e organizadas automaticamente nos Documentos Google. Cada recurso é independente e é definido por espaço de reunião. As legendas de gravação estão disponíveis apenas em inglês.
É possível pré-configurar os artefatos automáticos ao criar um espaço de
reunião ou depois que ele for
criado. Esse recurso também permite configurar artefatos automáticos para reuniões
criadas no Google Agenda. Ambos os métodos exigem o
escopo OAuth meetings.space.settings. Para mais informações, consulte Escopos do OAuth
para configurações.
Os artefatos automáticos são definidos pelo objeto
ArtifactConfig
no objeto
SpaceConfig,
que faz parte do recurso
spaces. ArtifactConfig é composto pelos campos recordingConfig,
transcriptionConfig e smartNotesConfig.
Cada campo é mapeado para um objeto semelhante, como
RecordingConfig,
TranscriptionConfig
e
SmartNotesConfig. Cada objeto é definido usando o
enum booleano
AutoGenerationType para ativar ou desativar o objeto de configuração.
Escopos do OAuth para configurações
Definir ou acessar as configurações de reuniões requer os seguintes escopos do OAuth:
| Caso de uso | Código do escopo |
|---|---|
| Defina a geração automática de artefatos para espaços criados por outros apps. | https://www.googleapis.com/auth/meetings.space.settings |
| Receber ou listar artefatos de conferências criados por outros apps. | https://www.googleapis.com/auth/meetings.space.readonly |
| Receber ou listar outras configurações pré-reunião de um espaço de reunião criado por um app de terceiros. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Ler e editar as configurações de todos os espaços de reunião que um usuário pode acessar por qualquer outro app, como o Agenda. | https://www.googleapis.com/auth/meetings.space.settings |
Para mais informações sobre os escopos do OAuth, consulte Escopos da API REST do Meet.