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) 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 método spaces.create, ele devolve 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 para reuniões. 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 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 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 para reuniões 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ã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 na nuvem do Google que criou o espaço para reuniões.

Moderar espaços para reuniões

Para moderar uma reunião, defina o campo 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 para reuniões para enviar mensagens ou reações no chat ou compartilhar a tela.

Para definir as restrições de recursos no campo moderationRestrictions, use 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 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 com essa função.

Gerar relatório de participação

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

Gerenciar artefatos automáticos

Os organizadores de reuniões, mas não os coorganizadores, podem pré-configurar a gravação automática, as transcrições automáticas e as anotações 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 a ata da reunião é capturada e organizada automaticamente no Google Docs. Cada recurso é independente e definido por espaço para reuniões. 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 para reuniões ou depois que ele for criado. Os dois métodos exigem o escopo OAuth meetings.space.settings. Para mais informações, consulte Escopos do OAuth para configurações.

Também é possível configurar artefatos automáticos para reuniões criadas no Google Agenda.

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 AutoGenerationType para alternar 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 anotações inteligentes

Embora as transcrições de reuniões e as anotações inteligentes (também conhecidas como "faça anotações para mim") capturem informações da sua reunião, esses recursos têm finalidades diferentes e produzem artefatos diferentes.

A tabela a seguir mostra as diferenças:

Recurso Transcrições Notas inteligentes
Visão geral Uma gravação literal, palavra por palavra. Um resumo conciso dos pontos principais gerados pelo Gemini.
Nível de detalhes 100% de detalhes. Tudo o que é dito é anotado. Alto nível. Foco 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 que chegam atrasados se atualizem instantaneamente, automatiza a ata e o acompanhamento do projeto.
Uso em tempo real Usado para legendas. O arquivo é gerado após a chamada. Você pode conferir o resumo sendo criado no painel lateral durante a chamada.
Saída Um documento longo do Google Docs com o nome do falante e carimbos de data/hora. Um documento conciso do Google Docs com a ata da reunião, seções e marcadores.
Citação Contém o texto completo que pode ser vinculado. Inclui citações (marcações de tempo) que remetem ao momento específico na transcrição para contexto, se as transcrições e as anotações 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 anotações inteligentes também podem ser usadas ao mesmo tempo para criar artefatos melhores após a reunião.

Quando os dois estiverem ativados, você vai encontrar citações no documento de anotações 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 ficar ativos durante toda 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 host. Os dois arquivos também são anexados automaticamente ao evento da 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
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 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 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

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

Os organizadores da reunião podem entrar automaticamente no espaço para reuniões, mas você também pode configurar outros participantes para entrar sem precisar pedir. Além disso, os membros podem ser configurados para ter um Role na reunião, como COHOST, que dá a eles 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 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 para reuniões. Já os métodos "delete" e "get" usam o campo name para filtrar os resultados com base no espaço para reuniões e no nome do membro. Todos os métodos, exceto "delete", retornam uma instância do recurso spaces.members.

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.