Questa guida spiega come creare, recuperare e aggiornare uno spazio di riunione, nonché terminare una conferenza attiva nella risorsa spaces
dell'API REST di Google Meet.
Uno spazio per riunioni rappresenta un luogo virtuale o un oggetto persistente (ad esempio una sala riunioni) in cui vengono svolte conferenze. In uno spazio è possibile tenere una sola conferenza attiva alla volta. Uno spazio per riunioni aiuta inoltre gli utenti a incontrarsi e trovare risorse condivise.
Per scoprire come configurare un meeting space tramite programmazione, consulta Configurare meeting space e membri.
La seguente tabella illustra i ruoli di riunione richiesti per utilizzare i metodi dello spazio di riunione:
Metodo | Proprietari | Partecipanti | Altro |
---|---|---|---|
endActiveConference() |
x | ||
get() |
x | x | x |
con impostazioni | x | ||
con conferenza attiva | x | x | |
patch() |
x |
L'autenticazione e l'autorizzazione con le credenziali dell'utente consentono alle app Google Meet di accedere ai dati dell'utente ed eseguire operazioni per conto dell'utente autenticato. L'autenticazione con la delega a livello di dominio ti consente di autorizzare l'account di servizio di un'applicazione ad accedere ai dati dei tuoi utenti senza che sia necessario il consenso di ogni utente.
In che modo Meet identifica uno spazio per le riunioni
L'API REST di Google Meet genera una risorsa spaces
per ogni spazio di riunione. Il campo name
è il nome della risorsa.
Di seguito sono riportati due modi importanti per identificare uno spazio per riunioni utilizzando il
name
campo:
space
è l'identificatore della risorsa per lo spazio, formattato comespaces/{space}
. Si tratta di un ID univoco generato dal server ed è sensibile alle maiuscole. Ad esempio:spaces/jQCFfuBOdN5z
.meetingCode
è un alias per lo spazio, formattato comespaces/{meetingCode}
. È una stringa di caratteri univoca digitabile e non è sensibile alle maiuscole. Ad esempio:abc-mnop-xyz
. La lunghezza massima è di 128 caratteri. Fa parte delmeetingUri
:https://meet.google.com/abc-mnop-xyz
.
Per gestire uno spazio di riunione, utilizza i seguenti valori per il campo {name}
:
Per ottenere i dettagli di uno spazio per riunioni, puoi utilizzare
spaces/{space}
o l'aliasspaces/{meetingCode}
. Per ulteriori informazioni, vedi Creare uno spazio per le riunioni.Per aggiornare i dettagli di uno spazio di riunione, 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 di riunione, puoi utilizzare solo
spaces/{space}
. Per ulteriori informazioni, vedi Termina la conferenza attiva.
Creare uno spazio per le riunioni
Per creare uno spazio di riunione, utilizza il metodo
create()
sulla risorsa
spaces
.
Il metodo restituisce un'istanza di una risorsa spaces
, che include l'oggetto
SpaceConfig
che rappresenta la configurazione dello spazio di riunione. Contiene inoltre l'oggetto
ActiveConference
che è un link alla risorsa
conferenceRecords
corrente
all'interno dello spazio di riunione.
Il seguente esempio di codice mostra come creare uno spazio di riunione:
Java
Node.js
Python
Visualizzare i dettagli di uno spazio per riunioni
Per visualizzare i dettagli di uno spazio di riunione attivo e le relative impostazioni, utilizza il metodo
get()
sulla risorsa
spaces
con un name
specificato.
Per ulteriori informazioni, vedi In che modo Meet identifica uno spazio per le riunioni.
Il metodo restituisce uno spazio per le riunioni come istanza della risorsa spaces
.
Il seguente esempio di codice mostra come recuperare uno spazio per riunioni:
Java
Node.js
Python
Sostituisci il valore del nome dello spazio con l'ID univoco generato dal server per lo spazio riunioni.
Aggiornare uno spazio per le riunioni
Per aggiornare i dettagli di uno spazio di riunione, utilizza il metodo
patch()
sulla risorsa
spaces
con un name
specificato.
Per ulteriori informazioni, vedi In che modo Meet identifica uno spazio per le riunioni.
Il metodo patch()
accetta anche un parametro di query updateMask
facoltativo. Il
campo è di tipo
FieldMask
.
Si tratta di un elenco delimitato da virgole dei campi da aggiornare nello spazio.
Il metodo restituisce uno spazio per le riunioni come istanza della risorsa spaces
.
Il seguente esempio di codice mostra come aggiornare uno spazio di riunione:
Java
Node.js
Python
Sostituisci il valore del nome dello spazio con l'ID univoco generato dal server per lo spazio riunioni.
Terminare la conferenza attiva
Per terminare una conferenza attiva all'interno di uno spazio di riunione (se presente), utilizza il metodo
endActiveConference()
nella risorsa spaces
. Sia il corpo della richiesta che quello della risposta sono vuoti. Per ulteriori 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 valore del nome dello spazio con l'ID univoco generato dal server per lo spazio riunioni.