Configurare spazi per le riunioni e membri

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

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

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

Impostare la moderazione e l'accesso alle riunioni

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 riunioni

Per determinare chi può partecipare a uno spazio riunioni senza chiedere di partecipare, imposta il accessType campo utilizzando l' AccessType oggetto. Puoi scegliere tra più impostazioni se consentire automaticamente ai partecipanti di partecipare. Per impostazione predefinita, il campo utilizza 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 su ALL per consentire tutti i punti di accesso o CREATOR_APP_ONLY per limitare i punti di accesso solo a quelli di proprietà del progetto Google Cloud che ha creato lo spazio riunioni.

Moderare gli spazi riunioni

Per moderare una riunione, puoi impostare il moderation campo utilizzando l' Moderation oggetto. 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 moderationRestrictions campo. 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' ModerationRestrictions oggetto. Le limitazioni definiscono chi ha l'autorizzazione all'interno dello spazio riunioni per inviare messaggi di chat o reazioni o per condividere lo schermo.

Per impostare le limitazioni delle funzionalità nel campo moderationRestrictions, utilizza RestrictionType per applicare chatRestriction, reactionRestriction, presentRestriction. Imposta su 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 spettatori, imposta il campo booleano defaultJoinAsViewerType utilizzando DefaultJoinAsViewerType. Se defaultJoinAsViewerType è on, gli utenti partecipano come 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 partecipa con quel ruolo.

Generare un report sulla partecipazione

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

Gestire gli artefatti automatici

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

Puoi preconfigurare gli artefatti automatici quando crei uno spazio riunioni o una volta creato. Entrambi i metodi richiedono l'ambito OAuth meetings.space.settings. Per saperne di più, consulta 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' ArtifactConfig oggetto, all'interno dell' SpaceConfig oggetto. 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 lo AutoGenerationType per attivare o disattivare l'oggetto di configurazione on o off.

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

Differenza tra trascrizioni e appunti intelligenti

Sebbene le trascrizioni delle riunioni e le note intelligenti (note 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à degli utenti.	Consente ai partecipanti in ritardo di recuperare immediatamente; automatizza la stesura dei verbali e il monitoraggio dei progetti.
Utilizzo in tempo reale	Utilizzato per i sottotitoli. Il file viene generato dopo la chiamata.	Puoi visualizzare il riepilogo in fase di creazione nel riquadro laterale durante la chiamata.
Output	Un lungo documento di Documenti Google con il nome dell'oratore e i timestamp.	Un documento conciso di Documenti Google con gli appunti sulla riunione, con sezioni ed elenchi puntati.
Citazione	Contiene il testo completo a cui è possibile creare un link.	Include citazioni (timestamp) che rimandano al momento specifico della trascrizione per il contesto, se sono attivate sia le trascrizioni sia gli appunti intelligenti. Per saperne di più, consulta Quando entrambe le funzionalità sono attivate.

Quando entrambe le funzionalità sono attivate

Sebbene ogni funzionalità possa essere utilizzata separatamente, sia le Trascrizioni sia gli appunti intelligenti possono essere utilizzati contemporaneamente per creare artefatti migliori dopo la riunione.

Quando entrambe le funzionalità sono attivate, 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 e comprendere meglio la discussione.

Durante la riunione, i partecipanti vedono indicatori che indicano che entrambe le funzionalità sono attive. Devono rimanere attive per tutta la durata della riunione per generare citazioni su cui è possibile fare clic. Anche se i file sono interconnessi, il sistema genera comunque due documenti distinti nel Google Drive dell'organizzatore. Entrambi i file vengono allegati automaticamente all'evento di Google Calendar.

Ambiti OAuth per le impostazioni

Per impostare o accedere alle impostazioni delle riunioni sono necessari i seguenti ambiti OAuth:

Caso d'uso	Codice ambito
Impostare la generazione automatica di artefatti per gli spazi creati da altre app.	`https://www.googleapis.com/auth/meetings.space.settings`
Ottenere o elencare gli artefatti delle conferenze create da altre app.	`https://www.googleapis.com/auth/meetings.space.readonly`
Ottenere o elencare 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`
Leggere e modificare le impostazioni di tutti gli spazi 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 riunioni. Questi utenti possono partecipare allo spazio riunioni senza richiedere l'autorizzazione a connettersi (nota anche come "chiedere di partecipare").

Sebbene gli organizzatori della riunione possano accedere automaticamente allo spazio riunioni, puoi anche configurare altri membri per partecipare alla riunione senza chiedere di partecipare. Inoltre, i membri possono essere configurati per avere un Role nella riunione, ad esempio COHOST, che conferisce loro le stesse capacità di gestire la riunione dell'organizzatore della riunione. Per saperne di più sull'accesso a uno spazio riunioni senza chiedere di partecipare, 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 della sala 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, tranne delete, restituiscono un'istanza della risorsa spaces.members.

Tutti i metodi, tranne delete, supportano il fields parametro in SystemParameterContext. Se il parametro fields viene omesso, la risposta dell'API assume il valore predefinito "name,email,role,user".

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