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 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, vedi Creare e gestire 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.

Accedere agli spazi per le riunioni

Per determinare chi può partecipare a uno spazio riunioni senza chiedere, 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 di riunione, 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.

Generare un report sulla partecipazione

Per creare un report sulla partecipazione per lo spazio della 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 viene inviata 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 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, consulta Gestire i membri di uno 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 l'enumerazione 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 l'enumerazione 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 viene aggiunto con quel ruolo.

Gestire gli artefatti automatici

Gli organizzatori delle riunioni, ma non i co-organizzatori, possono preconfigurare la registrazione automatica, le trascrizioni automatiche e la funzionalità "Prendi appunti per me" all'interno dello spazio della riunione. Quando queste impostazioni sono attive, lo spazio della riunione viene registrato, le trascrizioni vengono generate 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 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. Questa funzionalità consente anche di configurare gli artefatti automatici per le riunioni create da Google Calendar. Entrambi i metodi richiedono l'ambito OAuth meetings.space.settings. Per ulteriori informazioni, vedi Ambiti OAuth per le impostazioni.

Per impostare gli artefatti automatici, utilizza l'oggetto ArtifactConfig nell'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 l'enumerazione booleana AutoGenerationType per attivare/disattivare l'oggetto di configurazione on o off.

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
Leggere e modificare 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 ulteriori informazioni sugli ambiti OAuth, consulta Ambiti dell'API REST di Meet.

Gestire i membri dello spazio

Gli organizzatori della riunione possono sempre partecipare alla riunione senza chiedere, ma puoi anche configurare altri membri in modo che possano partecipare alla riunione senza chiedere. Inoltre, i membri possono essere configurati in modo da avere un ruolo nella riunione, ad esempio COHOST, che conferisce loro le stesse capacità di gestione della riunione dell'organizzatore. Per saperne di più su come accedere a uno spazio per le riunioni senza bussare, vedi 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. C'è 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, 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 un FieldMask per il filtraggio delle risposte. Un FieldMask consente ai chiamanti API di elencare i campi che una richiesta deve restituire. Si tratta di un elenco di campi delimitati da virgole per specificare che vengono utilizzati solo determinati campi in un oggetto, 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 di 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.