Configurar participantes e espaços para reuniões

Um espaço para reuniões 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 para reuniões usando o spaces.create método, ele retorna uma instância de um spaces recurso. O recurso inclui o SpaceConfig objeto que é a configuração do espaço para reuniões. Ele também contém o ActiveConference objeto que é um link para o recurso conferenceRecords atual no espaço para reuniões. Para mais informações sobre como gerenciar um espaço para reuniões, consulte Criar e gerenciar espaços para reuniões.

As seções a seguir detalham como configurar um espaço para reuniões 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 quando participam de uma reunião, pelo objeto.SpaceConfig

Acessar espaços para reuniões

Para determinar quem pode participar de um espaço para reuniões sem pedir, defina o accessType campo usando o AccessType objeto. Você pode escolher entre várias configurações sobre se deve permitir automaticamente que os participantes participem. O campo é definido como 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 para 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 àqueles pertencentes ao projeto na nuvem do Google Cloud que criou o espaço para reuniões.

Moderar espaços para reuniões

Para moderar uma reunião, defina o moderation campo usando o Moderation objeto. Quando o modo moderation está on, o organizador da reunião tem controle sobre a reunião com recursos como o gerenciamento de co-organizador (consulte spaces.members) e restrições de recursos usando o moderationRestrictions campo. Para mais informações sobre os membros, 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 ModerationRestrictions objeto. As restrições definem quem tem permissão no espaço para reuniões para enviar mensagens de chat ou reações ou para compartilhar a tela.

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

Para restringir a função padrão atribuída aos usuários como leitor, defina o campo booleano defaultJoinAsViewerType usando o DefaultJoinAsViewerType. Se defaultJoinAsViewerType for on, os usuários vão participar como leitores. Se off, os usuários vão participar como colaboradores. O padrão é off. Se uma função explícita for definida para um usuário em spaces.members, o usuário vai participar como essa função.

Gerar relatório de participação

Para criar um relatório de participação no espaço para reuniões, defina o attendanceReportGenerationType campo usando o AttendanceReportGenerationType objeto. 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.

Gerenciar artefatos automáticos

Os organizadores da reunião, mas não os co-organizadores, podem pré-configurar a gravação automática, as transcrições automáticas e as notas inteligentes no espaço para reuniões. Quando essas configurações estão ativadas, o espaço para reuniões é gravado, as transcrições são geradas e as atas da reunião são capturadas e organizadas automaticamente no Google Docs. Cada recurso é independente e definido por espaço para reuniões. As legendas de gravação só estão disponíveis em inglês.

Você pode pré-configurar os artefatos automáticos ao criar um espaço para reuniões ou depois que ele for criado. Os dois métodos exigem o escopo do OAuth meetings.space.settings. Para mais informações, consulte Escopos do OAuth para configurações.

Você também pode configurar artefatos automáticos para reuniões criadas no Google Agenda.

Para definir artefatos automáticos, use o ArtifactConfig objeto, no SpaceConfig objeto. 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 AutoGenerationType para ativar ou desativar o objeto de configuração on ou off.

Para recuperar os artefatos criados durante uma conferência, consulte Trabalhar com artefatos.

Diferença entre transcrições e notas inteligentes

Embora as transcrições de reuniões e as notas inteligentes (também conhecidas como "Anotar para mim") capturem informações da reunião, esses recursos têm propósitos diferentes e produzem artefatos diferentes.

A tabela a seguir mostra como eles diferem:

Recurso	Transcrições	Notas inteligentes
Visão geral	Um registro literal, palavra por palavra.	Um resumo conciso dos principais pontos gerados pelo Gemini.
Nível de detalhe	100% de detalhes. Tudo o que é dito é anotado.	Alto nível. Concentra-se em decisões e ações necessárias.
Caso de uso	Conformidade legal, verificação de citações exatas e acessibilidade do usuário.	Permite que os participantes atrasados se atualizem instantaneamente; automatiza a tomada de atas e o acompanhamento de projetos.
Uso em tempo real	Usado para legendas. O arquivo é gerado após a chamada.	Você pode conferir o resumo no painel lateral durante a chamada.
Saída	Um documento longo do Google Docs com o nome do orador e as marcações de tempo.	Um documento conciso do Google Docs com ata da reunião com seções e marcadores.
Citação	Contém o texto completo que pode ser vinculado.	Inclui citações (marcações de tempo) que vinculam ao momento específico na transcrição para contexto, se as transcrições e as notas inteligentes estiverem ativadas. Para mais informações, consulte Quando os dois recursos estão ativados.

Quando os dois recursos estão ativados

Embora cada recurso possa ser usado separadamente, as transcrições e as notas inteligentes também podem ser usadas ao mesmo tempo para criar artefatos melhores após a reunião.

Quando os dois estão ativados, você vai encontrar citações no documento de notas inteligentes gerado. Essas citações ficam na seção de detalhes e são vinculadas a marcações de tempo específicas na transcrição da reunião. Ao clicar nas citações, você pula diretamente para a parte relevante da transcrição e entende melhor o contexto do que foi dito.

Durante a reunião, os participantes veem indicadores de que os dois recursos estão ativos. Eles precisam permanecer ativos durante a reunião para gerar citações clicáveis. Mesmo que os arquivos estejam interligados, o sistema ainda gera dois documentos distintos no Google Drive do organizador. Os dois arquivos também são anexados automaticamente ao evento do Google Agenda.

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
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 criadas por outros apps.	`https://www.googleapis.com/auth/meetings.space.readonly`
Receber ou listar outras configurações de pré-reunião de um espaço para reuniões 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 para reuniões 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 os escopos do OAuth, consulte Escopos da API REST do Meet.

Gerenciar participantes do espaço

Um participante do espaço é um usuário configurado para ter uma função no espaço para reuniões. Esses usuários podem participar do espaço para reuniões sem solicitar permissão para se conectar (também conhecido como "pedir").

Embora os organizadores da reunião possam entrar automaticamente no espaço para reuniões, você também pode configurar outros participantes para participar da reunião sem pedir. Além disso, os participantes podem ser configurados para ter uma Role na reunião, como COHOST, que oferece as mesmas habilidades para gerenciar a reunião que o organizador. Para mais informações sobre como acessar um espaço para reuniões sem pedir, consulte AccessType.

O recurso spaces.members inclui os campos name, user e role.

Note que um membro é diferente de um participante. Um participante é uma pessoa que participa de uma chamada ou que usa o modo companion, assistindo como leitor, ou um dispositivo de sala conectado a uma chamada. Há um conferenceRecords.participants recurso para cada pessoa.

Você pode gerenciar os participantes 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 para reuniões, e os métodos de exclusão e recebimento usando o campo name para filtrar os resultados com base no espaço para reuniões e no nome do participante. Todos os métodos, exceto excluir, retornam uma instância do recurso spaces.members.

Todos os métodos, exceto excluir, oferecem suporte ao fields parâmetro em SystemParameterContext. Quando o parâmetro fields é omitido, a resposta da API é definida como "name,email,role,user".

O parâmetro fields depende de um FieldMask para filtragem de respostas. Um 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 que apenas determinados campos em um objeto são usados, enquanto os outros campos permanecem inalterados. O uso de um FieldMask permite que a API evite trabalhos desnecessários e melhore a performance. Uma máscara de campo é usada para métodos de criação, recebimento e lista. Para mais informações sobre máscaras de campo, consulte Usar máscaras de campo da API Google Sheets.