Configurare le impostazioni dello spazio riunioni

Uno spazio per le riunioni rappresenta un luogo virtuale o un oggetto persistente (ad esempio una sala riunioni) in cui si tengono le conferenze. Uno spazio per riunioni aiuta anche gli utenti a incontrarsi e trovare risorse condivise.

Quando crei uno spazio per le riunioni utilizzando il metodo spaces.create, viene restituita un'istanza di una risorsa spaces. La risorsa include l'oggetto SpaceConfig, che è la configurazione dello spazio per le riunioni. Contiene anche l'oggetto ActiveConference che è un link alla risorsa conferenceRecords corrente all'interno dello spazio per riunioni. Per saperne di più sulla gestione di uno spazio per le riunioni, consulta Gestire gli spazi per le riunioni.

Le sezioni seguenti descrivono in dettaglio come configurare uno spazio per le riunioni utilizzando questi oggetti e metodi.

Impostare la moderazione e l'accesso alla riunione

Puoi impostare la modalità di partecipazione degli utenti a una riunione, le modalità di moderazione, le limitazioni delle funzionalità e le autorizzazioni che gli utenti ricevono quando partecipano a una riunione tramite l'oggetto SpaceConfig.

Configurare l'accesso alle riunioni

Per determinare chi può partecipare a uno spazio di riunione senza chiedere di partecipare, imposta il campo accessType utilizzando l'oggetto AccessType. Puoi scegliere tra più impostazioni per decidere se consentire automaticamente ai partecipanti di partecipare. Il campo utilizza per impostazione predefinita le impostazioni di accesso predefinite dell'utente.

Per definire i punti di accesso che possono essere utilizzati per partecipare alle riunioni ospitate in uno spazio riunioni, imposta il campo entryPointAccess utilizzando l'oggetto EntryPointAccess. Imposta ALL per consentire tutti i punti di ingresso o CREATOR_APP_ONLY per limitare i punti di ingresso solo a quelli di proprietà del progetto Google Cloud che ha creato lo spazio di incontro.

Il seguente esempio di codice mostra come configurare le impostazioni di accesso per uno spazio per riunioni:

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"
    }
  }'

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci il nome dello spazio con l'ID univoco generato dal server per lo spazio della riunione.

Configurare le impostazioni di moderazione

Per moderare una riunione, puoi impostare il campo moderation utilizzando l'oggetto Moderation. Quando la modalità moderation è on, l'organizzatore della riunione ha il controllo della riunione con funzionalità come la gestione dei co-organizzatori (vedi spaces.members) e le limitazioni delle funzionalità utilizzando il campo moderationRestrictions. Per ulteriori informazioni sui membri, vedi Gestire i membri dello spazio di riunione.

Per definire le limitazioni delle funzionalità quando la riunione è moderata (moderation è on), imposta il campo moderationRestrictions utilizzando l'oggetto ModerationRestrictions. Le limitazioni definiscono chi ha l'autorizzazione all'interno dello spazio della riunione per inviare messaggi di chat o reazioni oppure per condividere lo schermo.

Per impostare le limitazioni delle funzionalità nel campo moderationRestrictions, utilizza RestrictionType per applicare chatRestriction, reactionRestriction e presentRestriction. Imposta HOSTS_ONLY per applicare le autorizzazioni sia all'organizzatore della riunione sia ai co-organizzatori oppure NO_RESTRICTION per applicarle a tutti i partecipanti.

Per limitare il ruolo predefinito assegnato agli utenti come visualizzatore, imposta il campo defaultJoinAsViewerType utilizzando DefaultJoinAsViewerType. Se defaultJoinAsViewerType è on, gli utenti partecipano in qualità di spettatori. Se off, gli utenti partecipano come collaboratori. Il valore predefinito è off. Se per un utente è impostato un ruolo esplicito in spaces.members, l'utente entra con quel ruolo.

Configurare i report sulla partecipazione

Per creare un report sulla partecipazione per lo spazio della riunione, imposta il campo attendanceReportGenerationType utilizzando l'oggetto AttendanceReportGenerationType. Se viene richiesto un report, Google Meet lo salva su Google Drive dell'organizzatore della riunione e viene inviata anche un'email.

Gestire gli artefatti automatici

Gli organizzatori delle riunioni, ma non i co-organizzatori, possono preconfigurare la registrazione automatica, le trascrizioni automatiche e gli appunti intelligenti all'interno dello spazio della riunione. Quando queste impostazioni sono attive, lo spazio della riunione viene registrato, vengono generate le trascrizioni e gli appunti della riunione vengono acquisiti e organizzati automaticamente in Documenti Google. Ogni funzionalità è indipendente e viene impostata per ogni spazio riunioni. I sottotitoli codificati delle registrazioni sono disponibili solo in inglese.

Puoi preconfigurare gli artefatti automatici quando crei uno spazio per la riunione o una volta creato lo spazio per la riunione. Entrambi i metodi richiedono l'ambito OAuth meetings.space.settings. Per maggiori informazioni, consulta la sezione Ambiti OAuth per caso d'uso.

Puoi anche configurare gli artefatti automatici per le riunioni create da Google Calendar.

Per impostare gli artefatti automatici, utilizza l'oggetto ArtifactConfig all'interno dell'oggetto SpaceConfig. ArtifactConfig è composto dai campi recordingConfig, transcriptionConfig e smartNotesConfig.

Ogni campo è mappato a un oggetto simile, ad esempio RecordingConfig, TranscriptionConfig, e SmartNotesConfig. Per impostare ogni oggetto, utilizza AutoGenerationType per attivare/disattivare l'oggetto di configurazione on o off.

Per recuperare gli artefatti creati durante una conferenza, consulta Utilizzare gli artefatti.

Differenze tra trascrizioni e appunti intelligenti

Sebbene le trascrizioni delle riunioni e gli appunti intelligenti (noti anche come "Prendi appunti per me") acquisiscano informazioni dalla riunione, queste funzionalità hanno scopi diversi e producono artefatti diversi.

La tabella seguente mostra le differenze:

Funzionalità Trascrizioni Appunti intelligenti
Panoramica Una registrazione letterale, parola per parola. Un riepilogo conciso dei punti chiave generato da Gemini.
Livello di dettaglio 100% di dettagli. Tutto ciò che viene detto viene scritto. Di alto livello. Si concentra su decisioni e attività.
Caso d'uso Conformità legale, controllo delle citazioni esatte e accessibilità per gli utenti. Consente ai partecipanti in ritardo di recuperare immediatamente; automatizza la stesura del verbale e il monitoraggio del progetto.
Utilizzo in tempo reale Utilizzato per i sottotitoli codificati. Il file viene generato dopo la chiamata. Puoi visualizzare l'edificio riepilogativo nel riquadro laterale durante la chiamata.
Output Un documento Google Docs lungo con il nome dell'oratore e i timestamp. Un documento di Documenti conciso con gli appunti della riunione con sezioni ed elenchi puntati.
Citazione Contiene il testo completo a cui è possibile collegarsi. Include citazioni (timestamp) che rimandano al momento specifico della trascrizione per il contesto, se sono attive sia le trascrizioni che gli appunti intelligenti. Per saperne di più, consulta Quando entrambe le funzionalità sono attive.

Quando entrambe le funzionalità sono attive

Sebbene ogni funzionalità possa essere utilizzata separatamente, sia le trascrizioni che gli appunti intelligenti possono essere utilizzati contemporaneamente per creare artefatti post-riunione migliori.

Quando entrambe sono attive, vedrai le citazioni nel documento con gli appunti intelligenti che è stato generato. Le citazioni si trovano nella sezione dei dettagli e rimandano a timestamp specifici nella trascrizione della riunione. Facendo clic sulle citazioni, puoi passare direttamente alla sezione pertinente della trascrizione per comprendere meglio la discussione.

Durante la riunione, i partecipanti vedono indicatori che segnalano l'attivazione di entrambe le funzionalità. Devono rimanere attivi per tutta la durata della riunione per generare citazioni su cui è possibile fare clic. Anche se i file sono collegati tra loro, il sistema genera comunque due documenti distinti nel Drive dell'host. Entrambi i file vengono allegati automaticamente anche all'evento di Calendar.

Per ulteriori informazioni sugli ambiti OAuth richiesti per gli spazi e le impostazioni delle riunioni, consulta Ambiti OAuth per caso d'uso.