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 svolgono conferenze. Uno spazio di incontro aiuta inoltre gli utenti a incontrarsi e trovare risorse condivise.

Quando crei uno spazio di riunione utilizzando il metodo spaces.create, viene restituita un'istanza di una risorsa spaces. La risorsa include l'oggetto SpaceConfig che rappresenta la configurazione dello spazio per riunioni. Contiene inoltre l'oggetto ActiveConference che è un link alla risorsa conferenceRecords corrente all'interno dello spazio di riunione. Per ulteriori informazioni sulla gestione di uno spazio per le riunioni, vedi Creare e gestire gli spazi per le riunioni.

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

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 per le riunioni

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

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

Generare un report sulla partecipazione

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

Moderare gli spazi per le riunioni

Per moderare una riunione, puoi impostare il campo booleano moderation utilizzando l'oggetto Moderation. Quando la modalità moderation è on, l'organizzatore della riunione ha il controllo sulla 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, 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 di riunione per inviare messaggi di chat o reazioni o per condividere lo schermo.

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

Per limitare il ruolo predefinito assegnato agli utenti come visualizzatori, imposta il campo booleano defaultJoinAsViewerType utilizzando l'enum DefaultJoinAsViewerType. Se defaultJoinAsViewerType è on, gli utenti partecipano come spettatori. Se off, gli utenti partecipano come collaboratori. Il valore predefinito è off. Se per un utente in spaces.members è impostato un ruolo esplicito, l'utente si unisce con quel ruolo.

Gestire gli elementi automatici

Gli organizzatori delle riunioni, ma non i co-organizzatori, possono preconfigurare la registrazione automatica, le trascrizioni automatiche e l'opzione "Prendi appunti per me" all'interno dello spazio di riunione. Quando queste impostazioni sono attivate, lo spazio della riunione viene registrato, le trascrizioni vengono generate e le note della riunione vengono acquisite e organizzate automaticamente in Documenti Google. Ogni funzionalità è indipendente e viene impostata per ogni spazio di riunione. I sottotitoli codificati delle registrazioni sono disponibili solo in inglese.

Puoi preconfigurare gli elementi automatici quando crei uno spazio riunioni o dopo aver creato lo spazio riunioni. Questa funzionalità ti consente anche di configurare gli elementi automatici per le riunioni create da Google Calendar. Entrambi i metodi richiedono l'ambito OAuth meetings.space.settings. Per ulteriori informazioni, consulta Eseguire l'accesso con OAuth per le impostazioni.

Per impostare gli elementi automatici, utilizza l'oggetto ArtifactConfig nell'oggetto SpaceConfig. ArtifactConfig è costituito dai campi recordingConfig, transcriptionConfig e smartNotesConfig.

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

Ambiti OAuth per le impostazioni

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

Caso d'uso Codice ambito
Imposta la generazione automatica di elementi per gli spazi creati da altre app. https://www.googleapis.com/auth/meetings.space.settings
Recuperare o elencare gli elementi delle conferenze create da altre app. https://www.googleapis.com/auth/meetings.space.readonly
Ottenere o elencare altre impostazioni pre-riunione di uno spazio di riunione 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 di riunione a cui un utente può accedere tramite qualsiasi altra app, ad esempio Calendar. https://www.googleapis.com/auth/meetings.space.settings

Per ulteriori informazioni sugli ambiti OAuth, consulta Ambiti dell'API REST di Meet.

Gestire i membri dello spazio

Sebbene gli organizzatori della riunione possano sempre partecipare senza chiedere, puoi anche configurare altri membri per partecipare alla riunione senza chiedere. Inoltre, i membri possono essere configurati per avere un ruolo nella riunione, ad esempio COHOST, che conferisce loro le stesse autorizzazioni di gestione della riunione dell'organizzatore. Per ulteriori informazioni su come accedere a uno spazio per 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 partecipa a una chiamata o che utilizza la modalità Complementare, che guarda la chiamata 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 path con i metodi create e list che utilizzano il campo parent per indicare lo spazio di riunione e i metodi delete e get che utilizzano il campo name per filtrare i risultati in base allo spazio di riunione e al nome del membro.

Tutti i metodi, ad eccezione di delete, supportano il parametro fields in SystemParameterContext. Se il parametro fields viene omesso, il valore predefinito della risposta dell'API è "name,email,role,user".

Il parametro fields si basa su un FieldMask per il filtro delle risposte. Un FieldMask consente agli utenti che effettuano chiamate all'API di elencare i campi che deve restituire una richiesta. Si tratta di un elenco di campi separati da virgole per specificare solo alcuni campi di un oggetto da utilizzare, lasciando invariati gli altri campi. L'utilizzo di un FieldMask consente all'API di evitare operazioni non necessarie e migliora le prestazioni. Una maschera di campo viene utilizzata per i metodi create, get ed list. Per ulteriori informazioni sulle maschere di campo, consulta la sezione Utilizzare le maschere di campo dell'API Fogli Google.