Uno spazio per riunioni rappresenta un luogo virtuale o un oggetto persistente (ad esempio una sala riunioni) in cui vengono svolte conferenze. Uno spazio di riunione aiuta inoltre gli utenti a incontrarsi e trovare risorse condivise.
Quando crei uno spazio di riunione utilizzando il metodo
spaces.create(), viene
restituito 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 saperne di più sulla gestione di uno spazio per le riunioni, consulta
Utilizzare gli spazi per le riunioni.
Le sezioni seguenti descrivono in dettaglio come configurare uno spazio di riunione utilizzando diversi nuovi metodi e oggetti beta.
Impostare la moderazione e l'accesso alle riunioni
Grazie ai nuovi oggetti beta, ora puoi impostare le modalità di moderazione, le limitazioni delle funzionalità e le autorizzazioni che gli utenti ricevono quando partecipano a una riunione. Questi parametri vengono impostati tramite l'oggetto aggiornato SpaceConfig.
Il campo moderation è una modalità di moderazione preconfigurata per una riunione, con il valore predefinito controllato dai criteri dell'utente. Utilizza l'oggetto
Moderation. Quando la modalità di moderazione è attiva, 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à (vedi moderationRestrictions). Per ulteriori informazioni sui membri, vedi Gestire i membri dello spazio.
Il campo moderationRestrictions applica le limitazioni di moderazione per la riunione quando moderation è attivo. Utilizza l'oggetto
ModerationRestrictions. Le restrizioni definiscono chi ha l'autorizzazione a inviare messaggi di chat e reazioni, condividere lo schermo e se limitare il ruolo predefinito assegnato agli utenti come visualizzatori. Il campo moderationRestrictions
si basa su un
RestrictionType
per applicare le prime tre limitazioni. RestrictionType può essere applicato all'organizzatore e al co-organizzatore della riunione o a tutti i partecipanti. DefaultJoinAsViewerType applica l'autorizzazione finale quando gli utenti partecipano come collaboratori per impostazione predefinita, ma gli host possono anche limitare la partecipazione degli utenti come spettatori.
Il campo firstJoinerType imposta se gli utenti possono partecipare prima dell'organizzatore alle conferenze in questo spazio di riunione. Definisce quali utenti possono partecipare per primi alla riunione e se altri sono in stato di attesa. Utilizza l'oggetto
FirstJoinerType.
Gestire i membri dello spazio
Un organizzatore della riunione poteva sempre partecipare senza dover chiedere, ma ora puoi configurare i membri che possono partecipare alla riunione senza dover 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 dover suonare, 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 la chiamata come spettatore o un dispositivo della stanza 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 valore FieldMask per filtrare le risposte. Un FieldMask consente ai chiamanti dell'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.
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" nello spazio di riunione. Quando queste impostazioni sono attivate, lo spazio della riunione viene registrato automaticamente, 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 riunioni. I sottotitoli codificati delle registrazioni sono disponibili solo in inglese.
Puoi preconfigurare gli elementi automatici quando crei uno spazio riunioni o dopo averlo creato. 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.
Gli elementi automatici vengono impostati tramite l'oggetto
ArtifactConfig
nell'oggetto
SpaceConfig
che fa parte della risorsa spaces. ArtifactConfig è costituito dai campi recordingConfig,
transcriptionConfig e smartNotesConfig.
Ogni campo è mappato a un oggetto simile, ad esempio
RecordingConfig
,
TranscriptionConfig
e
SmartNotesConfig
. Ogni oggetto viene impostato utilizzando l'enum booleano
AutoGenerationType
per attivare o disattivare l'oggetto config.
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.createdhttps://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.