Configurar participantes e espaços para reuniões

Um espaço de reunião representa um lugar virtual ou um objeto persistente (como uma sala de reunião) em que reuniões 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 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ões, consulte Criar e gerenciar espaços de reuniões.

As seções a seguir detalham como configurar um espaço de reunião usando esses objetos e métodos.

Definir a moderação e o acesso à reunião

É possível definir como os usuários entram em uma reunião, os modos de moderação, as restrições de recursos e as permissões que os usuários recebem quando entram em uma reunião pelo objeto SpaceConfig.

Acessar espaços para reuniões

Para determinar quem pode entrar em um espaço de reunião sem pedir, 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 hospedadas em um espaço de reuniões, defina o campo entryPointAccess usando o objeto EntryPointAccess. Defina como ALL para permitir todos os pontos de entrada ou CREATOR_APP_ONLY para limitar os pontos de entrada apenas aos que pertencem ao projeto do Google Cloud que criou o espaço de reunião.

Gerar relatório de presença

Para criar um relatório de presença para o espaço de reunião, defina o campo attendanceReportGenerationType booleano 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 um e-mail também será enviado.

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 a reunião com recursos como o gerenciamento de coorganizadores (consulte spaces.members) e as restrições de recursos usando o campo moderationRestrictions. Para mais informações sobre os 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 de chat ou reações ou para compartilhar a tela.

Para definir as restrições de recurso no campo moderationRestrictions, use o tipo enumerado RestrictionType para aplicar chatRestriction, reactionRestriction e presentRestriction. Defina como HOSTS_ONLY para aplicar as permissões ao organizador e ao coanfitrião da reunião ou NO_RESTRICTION para aplicar a todos os participantes.

Para restringir o papel padrão atribuído aos usuários como espectador, defina o campo booleano defaultJoinAsViewerType usando o tipo enumerado DefaultJoinAsViewerType. Se defaultJoinAsViewerType for on, os usuários vão participar como espectadores. Se off, os usuários entram como colaboradores. O padrão é off. Se uma função explícita for definida para um usuário em spaces.members, ele vai participar como essa função.

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 são capturadas e organizadas nos Documentos Google automaticamente. 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 de criar o espaço de reunião. 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.

Para definir artefatos automáticos, use o objeto ArtifactConfig no objeto 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

Definir ou acessar as configurações de reuniões requer os seguintes escopos do OAuth:

Caso de uso Código do escopo
Definir 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.created
https://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 Conheça os escopos da API REST.

Gerenciar participantes do espaço

Os organizadores da reunião sempre podem entrar sem pedir, mas você também pode configurar outros membros para participar 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 entrou em uma chamada ou que usa o modo companion, assistindo 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.