Definir as configurações do espaço 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 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 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 do Google Cloud que criou o espaço de reunião.

O exemplo de código a seguir mostra como configurar as configurações de acesso para um espaço de reunião:

Java

import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpaceConfig;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.apps.meet.v2.UpdateSpaceRequest;
import com.google.protobuf.FieldMask;

public class ConfigureSpaceAccess {
  public static void main(String[] args) throws Exception {
    try (SpacesServiceClient client = SpacesServiceClient.create()) {
      Space space =
          Space.newBuilder()
              .setName("spaces/SPACE_NAME")
              .setConfig(
                  SpaceConfig.newBuilder()
                      .setAccessType(SpaceConfig.AccessType.RESTRICTED)
                      .setEntryPointAccess(SpaceConfig.EntryPointAccess.ALL)
                      .build())
              .build();
      FieldMask updateMask =
          FieldMask.newBuilder()
              .addPaths("config.access_type")
              .addPaths("config.entry_point_access")
              .build();
      UpdateSpaceRequest request =
          UpdateSpaceRequest.newBuilder()
              .setSpace(space)
              .setUpdateMask(updateMask)
              .build();
      Space response = client.updateSpace(request);
      System.out.println("Updated space: " + response.getName());
    }
  }
}

Node.js

const {SpacesServiceClient} = require('@google-apps/meet').v2;

async function configureSpaceAccess(spaceName) {
  const meetClient = new SpacesServiceClient();
  const [response] = await meetClient.updateSpace({
    space: {
      name: spaceName,
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    },
    updateMask: {
      paths: ['config.access_type', 'config.entry_point_access'],
    },
  });
  console.log(`Updated space: ${response.name}`);
  return response;
}

Python

from google.apps import meet_v2
from google.protobuf import field_mask_pb2

def configure_space_access(space_name):
    client = meet_v2.SpacesServiceClient()
    space = meet_v2.Space(
        name=space_name,
        config=meet_v2.SpaceConfig(
            access_type=meet_v2.SpaceConfig.AccessType.RESTRICTED,
            entry_point_access=meet_v2.SpaceConfig.EntryPointAccess.ALL,
        ),
    )
    update_mask = field_mask_pb2.FieldMask(
        paths=["config.access_type", "config.entry_point_access"]
    )
    request = meet_v2.UpdateSpaceRequest(
        space=space,
        update_mask=update_mask
    )
    response = client.update_space(request=request)
    print(f"Updated space: {response.name}")
    return response

Apps Script

function configureSpaceAccess(spaceName) {
  const baseUrl = 'https://meet.googleapis.com/v2/';
  const mask = 'updateMask=config.accessType,config.entryPointAccess';
  const response = UrlFetchApp.fetch(`${baseUrl}${spaceName}?${mask}`, {
    method: 'patch',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
    },
    payload: JSON.stringify({
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    }),
  });
  const space = JSON.parse(response.getContentText());
  Logger.log('Updated space: ' + space.name);
  return space;
}

cURL

curl -X PATCH \
  "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType,config.entryPointAccess" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "accessType": "RESTRICTED",
      "entryPointAccess": "ALL"
    }
  }'

Substitua ACCESS_TOKEN pelo token de acesso que concede acesso à API.

Substitua o valor do nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.

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 membros, consulte Gerenciar membros do espaço para reuniões.

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 de chat ou reações 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 da reunião e aos coorganizadores 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 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 presença 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, mas não os coorganizadores, podem pré-configurar a gravação automática, as transcrições automáticas e as Minuta inteligente no espaço para reuniões. Quando essas configurações sã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çõ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 por caso de uso.

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 propósitos 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. Foca 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 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 nome do locutor 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 melhores artefatos pós-reunião.

Quando os dois recursos 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 Drive do host. Os dois arquivos também são anexados automaticamente ao evento da Agenda.

Para mais informações sobre os escopos do OAuth necessários para espaços e configurações de reunião, consulte Escopos do OAuth por caso de uso.