Configurare spazi per le riunioni e membri

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, ovvero 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, vedi Creare e gestire spazi per le riunioni.

Le sezioni seguenti descrivono in dettaglio come configurare uno spazio di incontro 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.

Accedere agli spazi per le riunioni

Per determinare chi può partecipare a uno spazio riunioni 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 ingresso 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.

Moderare gli spazi per le riunioni

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 saperne di più sui membri, consulta Gestire i membri dello spazio.

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, presentRestriction. Imposta HOSTS_ONLY per applicare le autorizzazioni sia all'organizzatore della riunione sia al co-organizzatore oppure NO_RESTRICTION per applicarle a tutti i partecipanti.

Per limitare il ruolo predefinito assegnato agli utenti come visualizzatore, imposta il campo booleano 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.

Generare un 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 sul 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 registrati 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 le impostazioni.

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, vedi Utilizzare gli artefatti.

Differenza tra trascrizioni e note 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 la creazione del riepilogo nel riquadro laterale durante la chiamata.
Output Un documento Google Docs lungo con il nome dell'oratore e i timestamp. Un documento Google Docs conciso con gli appunti della riunione, suddivisi in sezioni ed elenchi puntati.
Citazione Contiene il testo completo a cui è possibile collegarsi. Include citazioni (timestamp) che rimandano al momento specifico della trascrizione per fornire un 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 che entrambe le funzionalità sono attive. 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 Google Drive dell'host. Entrambi i file vengono allegati automaticamente anche all'evento di Google Calendar.

Ambiti OAuth per le impostazioni

L'impostazione o l'accesso alle impostazioni delle riunioni richiede i seguenti ambiti OAuth:

Caso d'uso Codice ambito
Imposta la generazione automatica di artefatti per gli spazi creati da altre app. https://www.googleapis.com/auth/meetings.space.settings
Recuperare o elencare gli artefatti delle conferenze create da altre app. https://www.googleapis.com/auth/meetings.space.readonly
Recupera o elenca altre impostazioni pre-riunione di uno spazio riunioni creato da un'app di terze parti. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Leggi e modifica le impostazioni di tutti gli spazi per le riunioni a cui un utente può accedere tramite qualsiasi altra app, ad esempio Calendar. https://www.googleapis.com/auth/meetings.space.settings

Per saperne di più sugli ambiti OAuth, consulta Ambiti dell'API REST di Meet.

Gestire i membri dello spazio

Un membro dello spazio è un utente configurato per avere un ruolo nello spazio della riunione. Questi utenti possono partecipare allo spazio di riunione senza richiedere l'autorizzazione a connettersi (nota anche come "toccare").

Sebbene gli organizzatori della riunione possano accedere automaticamente allo spazio della riunione, puoi anche configurare altri membri per partecipare alla riunione senza chiedere. Inoltre, i membri possono essere configurati per avere un Role nella riunione, ad esempio COHOST, che consente loro di gestire la riunione come l'organizzatore. Per saperne di più su come accedere a uno spazio riunioni senza bussare, consulta AccessType.

La risorsa spaces.members include i campi name, user e role.

Tieni presente che un membro è diverso da un partecipante. Un partecipante è una persona che ha partecipato a una chiamata o che utilizza la modalità Complementare, che guarda come spettatore o un dispositivo per sale riunioni connesso a una chiamata. Esiste una conferenceRecords.participants risorsa per ogni persona.

Puoi gestire i membri dello spazio utilizzando i seguenti metodi:

Ogni metodo accetta un parametro di percorso con i metodi create e list che utilizzano il campo parent per indicare lo spazio riunioni e i metodi delete e get che utilizzano il campo name per filtrare i risultati in base allo spazio riunioni e al nome del membro. Tutti i metodi, ad eccezione di delete, restituiscono un'istanza della risorsa spaces.members.

Tutti i metodi, ad eccezione di delete, supportano il parametro fields in SystemParameterContext. Se il parametro fields viene omesso, la risposta API è impostata per impostazione predefinita su "name,email,role,user".

Il parametro fields si basa su una FieldMask per il filtraggio delle risposte. Un FieldMask consente ai chiamanti API di elencare i campi che una richiesta deve restituire. È un elenco delimitato da virgole di campi per specificare che solo determinati campi di un oggetto vengono utilizzati, mentre gli altri campi rimangono invariati. L'utilizzo di un FieldMask consente all'API di evitare lavoro non necessario e migliora le prestazioni. Una maschera del campo viene utilizzata per i metodi create, get e list. Per ulteriori informazioni sulle maschere di campo, consulta la sezione Utilizzare le maschere di campo dell'API Google Sheets.