Uno spazio per riunioni rappresenta un luogo virtuale o un oggetto persistente (ad esempio una sala riunioni) in cui vengono organizzate 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 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.
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, il proprietario 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, consulta 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 al proprietario e al co-organizzatore della riunione oppure 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 proprietario 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 consente loro di gestire la riunione come il proprietario. Per maggiori informazioni su come accedere a uno spazio per le riunioni senza dover chiedere l'autorizzazione, 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 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, la risposta dell'API è "name,email,role,user" per impostazione predefinita.
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.