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 para reuniões também ajuda os usuários a se encontrar e encontrar recursos compartilhados.
Ao criar 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 para reuniões. 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 Criar e gerenciar espaços de reunião.
As seções a seguir detalham como configurar um espaço de reunião usando esses objetos e métodos.
Definir moderação e acesso à reunião
Você pode definir como os usuários participam de uma reunião, os modos de moderação, as restrições de recursos e as permissões que os usuários recebem ao participar de uma reunião usando o objeto SpaceConfig.
Acessar espaços para reuniões
Para determinar quem pode entrar em um espaço de reunião sem pedir permissão, defina o campo accessType usando o objeto AccessType.
Você pode escolher entre várias configurações para permitir automaticamente que os participantes entrem. O campo usa as configurações de acesso padrão do usuário.
Para definir os pontos de entrada que podem ser usados para participar de reuniões realizadas em um espaço
de reunião, defina o campo entryPointAccess usando o objeto
EntryPointAccess. Defina como ALL para permitir todos os pontos de entrada ou CREATOR_APP_ONLY para restringir os pontos de entrada apenas àqueles pertencentes ao projeto do Google Cloud que criou o espaço de reunião.
Gerar relatório de participação
Para criar um relatório de presença para o espaço de reunião, defina o campo booleano
attendanceReportGenerationType usando o objeto
AttendanceReportGenerationType. Se um relatório for solicitado, o Google Meet vai salvar o relatório de participação no Google Drive do organizador da reunião e enviar um e-mail.
Moderar espaços para reuniões
Para moderar uma reunião, defina o campo booleano moderation usando o objeto Moderation.
Quando o modo moderation é on, o organizador da reunião tem controle sobre ela com recursos como gerenciamento de coorganizadores (consulte spaces.members) e restrições de recursos usando o campo moderationRestrictions. Para mais
informações sobre participantes, consulte Gerenciar participantes do espaço.
Para definir restrições de recursos quando a reunião é moderada (moderation é
on), defina o campo moderationRestrictions usando o objeto
ModerationRestrictions. As restrições definem quem tem permissão no espaço da reunião para
enviar mensagens ou reações no chat ou compartilhar a tela.
Para definir as restrições de recursos no campo moderationRestrictions, use a enumeração RestrictionType para aplicar chatRestriction, reactionRestriction e presentRestriction. Defina como HOSTS_ONLY para aplicar as permissões ao organizador e ao coorganizador da reunião ou NO_RESTRICTION para aplicar a todos os participantes.
Para restringir a função padrão atribuída aos usuários como leitores, defina o campo booleano
defaultJoinAsViewerType
usando o enumerador
DefaultJoinAsViewerType. Se defaultJoinAsViewerType for on, os usuários vão participar como espectadores. Se off,
os usuários participam como colaboradores. O padrão é off. Se uma função explícita for definida para um usuário em spaces.members, ele vai entrar com essa função.
Gerenciar artefatos automáticos
Os organizadores, mas não os coorganizadores, podem pré-configurar a gravação automática, as transcrições automáticas e o recurso Faça anotações para mim no espaço da reunião. Quando essas configurações estão ativadas, o espaço da reunião é gravado, as transcrições são geradas, e as anotações são registradas e organizadas automaticamente nos Documentos Google. Cada recurso é independente e definido por espaço de reunião. As legendas de gravações 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. Com esse recurso, também é possível configurar artefatos automáticos para reuniões criadas no Google Agenda. Os dois métodos exigem o escopo OAuth meetings.space.settings. Para mais informações, consulte Escopos do OAuth para configurações.
Para definir artefatos automáticos, use o objeto
ArtifactConfig
em
SpaceConfig. ArtifactConfig é composto pelos campos recordingConfig, transcriptionConfig e smartNotesConfig.
Cada campo é mapeado para um objeto semelhante, como
RecordingConfig
,
TranscriptionConfig
e
SmartNotesConfig
. Para definir cada objeto, use o
enum booleano AutoGenerationType
para alternar o objeto de configuração on ou off.
Escopos do OAuth para configurações
Para definir ou acessar as configurações de reuniões, são necessários 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 |
| Receba ou liste materiais de conferências criadas por outros apps. | https://www.googleapis.com/auth/meetings.space.readonly |
| Receber ou listar outras configurações 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 Google Agenda. | https://www.googleapis.com/auth/meetings.space.settings |
Para mais informações sobre escopos do OAuth, consulte Conheça os escopos da API REST.
Gerenciar participantes do espaço
Os organizadores de reuniões sempre podem entrar sem pedir, mas você também pode configurar outros participantes para fazer o mesmo.
Além disso, os participantes podem ser configurados para ter uma função na reunião, como
COHOST, que dá a eles as mesmas habilidades de gerenciamento do
organizador da reunião. Para mais informações sobre como acessar um espaço de reunião sem
bater na porta, consulte
AccessType.
O recurso
spaces.members
inclui os campos name, user e role.
Um membro é diferente de um participante. Um participante é uma pessoa que entrou em uma chamada ou usa o modo companion, assiste como espectador ou um dispositivo de sala conectado a uma chamada. Há um recurso
conferenceRecords.participants
para cada pessoa.
É possível gerenciar membros do espaço usando os seguintes métodos:
Cada método usa um parâmetro de caminho. Os métodos "create" e "list" usam o campo parent para indicar o espaço de reunião. Já os métodos "delete" e "get" usam 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 usa "name,email,role,user" como padrão.
O parâmetro fields depende de um FieldMask para filtragem de respostas. Uma FieldMask é uma maneira de os autores de chamadas de API listarem os campos que uma
solicitação deve retornar. É uma lista de campos delimitada por vírgulas para especificar que apenas
determinados campos em um objeto são usados, deixando os outros inalterados.
Usar um FieldMask permite que a API evite trabalho desnecessário e melhore a performance. Uma máscara de campo é usada para os métodos "create", "get" e "list". Para mais informações sobre máscaras de campo, consulte Usar máscaras de campo na API Google Sheets.