Uno spazio per le riunioni rappresenta un luogo virtuale o un oggetto permanente (ad esempio una sala riunioni) in cui si tengono conferenze. È possibile tenere una sola conferenza attiva alla volta in uno spazio. Uno spazio per le riunioni consente inoltre agli utenti di incontrarsi e trovare risorse condivise.
Le sezioni seguenti spiegano come creare, recuperare e aggiornare uno spazio per le riunioni.
In che modo Meet identifica uno spazio per le riunioni
L'API REST Google Meet genera una risorsa spaces
per ogni spazio per le riunioni. Il campo name
è il nome della risorsa.
Di seguito sono riportati due modi importanti per identificare uno spazio per le riunioni utilizzando il campo name
:
space
è l'identificatore della risorsa per lo spazio, nel formatospaces/{space}
. Si tratta di un ID univoco generato dal server che fa distinzione tra maiuscole e minuscole. Ad esempio:spaces/jQCFfuBOdN5z
.meetingCode
è un alias dello spazio, nel formatospaces/{meetingCode}
. Si tratta di una stringa di caratteri univoci digitabile e non fa distinzione tra maiuscole e minuscole. Ad esempio:abc-mnop-xyz
. La lunghezza massima è di 128 caratteri. Fa parte dimeetingUri
:https://meet.google.com/abc-mnop-xyz
.
Per gestire uno spazio per le riunioni, utilizza i seguenti valori per il campo {name}
:
Per visualizzare i dettagli su uno spazio per le riunioni, puoi utilizzare
spaces/{space}
o l'aliasspaces/{meetingCode}
. Per ulteriori informazioni, vedi Ottenere uno spazio per le riunioni.Per aggiornare i dettagli di uno spazio per le riunioni, puoi utilizzare solo
spaces/{space}
. Per ulteriori informazioni, vedi Aggiornare uno spazio per le riunioni.Per terminare una conferenza attiva all'interno di uno spazio per le riunioni, puoi utilizzare solo
spaces/{space}
. Per ulteriori informazioni, vedi Terminare la conferenza attiva.
Crea uno spazio per le riunioni
Per creare uno spazio per le riunioni, utilizza il metodo create
nella risorsa spaces
.
Il metodo restituisce un'istanza di una risorsa spaces
, che include l'oggetto SpaceConfig
che rappresenta la configurazione per lo spazio delle riunioni. Contiene anche l'oggetto ActiveConference
, che è un link alla risorsa conferenceRecords
attuale all'interno dello spazio per le riunioni.
Il seguente esempio di codice mostra come creare uno spazio per le riunioni:
Java
Node.js
Python
Ottieni uno spazio per le riunioni
Per ottenere i dettagli su uno spazio per le riunioni, utilizza il metodo get
nella risorsa spaces
con un name
specificato.
Per ulteriori informazioni, vedi In che modo Meet identifica uno spazio per riunioni.
Il metodo restituisce uno spazio per riunioni come istanza della risorsa space
.
Il seguente esempio di codice mostra come recuperare uno spazio per le riunioni:
Java
Node.js
Python
Sostituisci il nome dello spazio con l'ID univoco generato dal server per lo spazio delle riunioni.
Aggiornare uno spazio per le riunioni
Per aggiornare i dettagli di uno spazio per le riunioni, utilizza il metodo patch
nella risorsa spaces
con un name
specificato.
Per ulteriori informazioni, vedi In che modo Meet identifica uno spazio per riunioni.
Il metodo patch
accetta anche un parametro updateMask
facoltativo. Il campo è di tipo FieldMask
.
Questo è un elenco di campi delimitato da virgole che vuoi aggiornare nello spazio.
Il metodo restituisce uno spazio per riunioni come istanza della risorsa spaces
.
Il seguente esempio di codice mostra come aggiornare uno spazio per le riunioni:
Java
Node.js
Python
Sostituisci il nome dello spazio con l'ID univoco generato dal server per lo spazio delle riunioni.
Termina conferenza attiva
Per terminare una conferenza attiva all'interno di uno spazio per riunioni, utilizza il metodo spaces.endActiveConference
sulla risorsa spaces
. Il corpo della richiesta e della risposta
è vuoto. Per maggiori informazioni, vedi In che modo
Meet identifica uno spazio per le riunioni.
Il seguente esempio di codice mostra come terminare una conferenza attiva:
Java
Node.js
Python
Sostituisci il nome dello spazio con l'ID univoco generato dal server per lo spazio delle riunioni.