Panoramica degli spazi per le riunioni di Google Meet

Illustrazione dell'API REST Google Meet

Questa guida spiega come l'API REST di Google Meet consente di creare e gestire le riunioni di Google Meet.

Uno spazio per le riunioni rappresenta un luogo virtuale o un oggetto persistente (ad esempio una sala riunioni) in cui si tengono le conferenze. In uno spazio può essere tenuta una sola conferenza attiva alla volta. Uno spazio per le riunioni aiuta anche gli utenti a incontrarsi e a trovare risorse condivise.

Per lavorare con gli spazi per le riunioni, vedi Creare e gestire gli spazi per le riunioni. Per scoprire come configurare uno spazio per le riunioni a livello di programmazione, vedi Configurare gli spazi per le riunioni e i membri.

Come chiamare i metodi dello spazio per le riunioni

La seguente tabella di confronto descrive in dettaglio i ruoli della riunione necessari per utilizzare i metodi dello spazio per le riunioni:

Metodo Proprietari Partecipanti Altro
endActiveConference
get
con le impostazioni
con la conferenza attiva
patch

Come Meet identifica uno spazio per le riunioni

L'API REST di Google Meet genera una spaces risorsa per ogni spazio per le riunioni. La risorsa spaces offre più punti di accesso per partecipare a una conferenza.

La tabella seguente mostra come identificare e partecipare a uno spazio per le riunioni:

Nome campo Descrizione
name Il nome dello spazio. La stringa {space} è l'identificatore della risorsa per lo spazio ed è formattata come spaces/{space}. È un ID univoco generato dal server e fa distinzione tra maiuscole e minuscole. Ad esempio, spaces/jQCFfuBOdN5z.
meetingCode L'alias per il nome dello spazio. Il {meetingCode} è una stringa di caratteri univoca e digitabile e non fa distinzione tra maiuscole e minuscole. È formattato come spaces/{meetingCode}. Ad esempio, spaces/abc-mnop-xyz. La lunghezza massima è di 128 caratteri. Fa parte di meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess I metodi di accesso via telefono per questo spazio per le riunioni. L'oggetto phoneAccess contiene le informazioni necessarie per chiamare una conferenza, inclusi i numeri di telefono regionali per lo spazio per le riunioni e un codice PIN specifico per quel numero di telefono. Il PIN è composto solo da cifre decimali e la lunghezza può variare. Ad esempio, "pin": 19707127300.

Analogamente all'interfaccia utente di Meet, la risorsa spaces include un insieme limitato di numeri di accesso via telefono. Puoi visualizzare altri numeri di telefono per uno spazio per le riunioni aggiungendo {meetingCode} al seguente URL: https://meet.google.com/tel/. Ad esempio, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess I metodi di accesso Session Initiation Protocol (SIP) per questo spazio per le riunioni. Un indirizzo SIP descrive in che modo l'hardware per videoconferenze di terze parti può trovare e partecipare a una conferenza Meet. L'oggetto gatewaySipAccess contiene un URI e un codice di accesso numerico. Meet supporta lo schema URI SIP .

Per gestire uno spazio per le riunioni, utilizza i seguenti valori per il name campo:

  • Per ottenere i dettagli di uno spazio per le riunioni, puoi utilizzare spaces/{space} o l'alias spaces/{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.

Ciclo di vita di uno spazio per le riunioni

Uno spazio per le riunioni attraversa diversi stati durante il suo ciclo di vita. Il seguente diagramma mostra i passaggi di alto livello del ciclo di vita di uno spazio per le riunioni:

Il ciclo di vita dello spazio per riunioni.
Figura 1. Il ciclo di vita di uno spazio per le riunioni.

  1. Chiama spaces.create. Lo spazio per le riunioni viene creato e l'oggetto spaces restituito contiene la stringa meetingUri. Il meetingUri viene quindi distribuito ai partecipanti.

  2. Esegui il polling del nuovo spazio per le riunioni. Chiama il spaces.get metodo per controllare lo stato della conferenza.

    Anziché eseguire il polling, puoi anche abbonarti agli eventi di Meet per ricevere notifiche push .

  3. Avvia la conferenza. Quando il primo partecipante fa clic su meetingUri all'interno dello spazio per le riunioni, viene avviata una conferenza. L'oggetto activeConference viene compilato e la stringa activeConference.conferenceRecord viene impostata.

  4. (Facoltativo) Ottieni i dati della conferenza. Durante una conferenza attiva, puoi accedere ad alcuni valori di conferenceRecord. Ad esempio, chiama il conferenceRecords.participants.list metodo per visualizzare tutti i partecipanti alla conferenza. Puoi accedere a queste informazioni anche fino a 30 giorni dopo la conferenza.

  5. (Facoltativo) Termina la conferenza. Durante la conferenza, il proprietario della riunione può chiamare il spaces.endActiveConference metodo per terminare a livello di programmazione una conferenza attiva per tutti i partecipanti.

  6. La conferenza termina. Quando l'ultimo partecipante abbandona la riunione, la conferenza termina.

  7. Esegui il polling degli artefatti post-conferenza. La conferenza è terminata (STATE=ENDED), ma gli artefatti non sono ancora stati generati. Vengono compilati anche startTime e endTime per la conferenza. Devi eseguire il polling dell'endpoint dell'artefatto finché l'oggetto dell'artefatto STATE non legge FILE_GENERATED.

    Anziché eseguire il polling, puoi abbonarti agli eventi di Meet per ricevere notifiche push.

  8. Ottieni gli artefatti post-conferenza. Una volta generati, puoi recuperare artefatti come registrazioni e trascrizioni. Ad esempio, chiama il conferenceRecords.recordings.get metodo per ottenere una registrazione in base all'ID di registrazione.

    Una volta pronto, un URI all'oggetto dell'artefatto viene compilato e restituito come parte dell'oggetto risorsa.