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 ti consente di creare e gestire riunioni per 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 attiva una sola conferenza alla volta. Uno spazio per riunioni aiuta anche gli utenti a incontrarsi e trovare risorse condivise.

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

Come chiamare i metodi dello spazio per le riunioni

La seguente tabella descrive i ruoli della riunione necessari per utilizzare i metodi dello spazio di riunione:

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

Come Meet identifica uno spazio per le riunioni

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

La tabella seguente mostra come identificare e partecipare a uno spazio 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. {meetingCode} è una stringa di caratteri univoca e digitabile e non è sensibile alle maiuscole. È formattato come spaces/{meetingCode}. Ad esempio, spaces/abc-mnop-xyz. La lunghezza massima è di 128 caratteri. Fa parte del meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess I metodi di accesso telefonico per questo spazio riunioni. L'oggetto phoneAccess contiene le informazioni necessarie per accedere a una conferenza, inclusi i numeri di telefono regionali per lo spazio della riunione 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 da chiamare. Puoi visualizzare altri numeri di telefono per uno spazio 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 al 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 riunioni, utilizza i seguenti valori per il campo name:

Ciclo di vita di uno spazio per le riunioni

Uno spazio per riunioni passa attraverso diversi stati durante il suo ciclo di vita. Il seguente diagramma mostra i passaggi generali del ciclo di vita di uno spazio 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 riunioni viene creato e l'oggetto spaces restituito contiene la stringa meetingUri. Il meetingUri viene poi distribuito ai partecipanti.

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

    Anziché partecipare a un sondaggio, puoi anche iscriverti agli eventi di Meet per ricevere notifiche push.

  3. Avvia la conferenza. Quando il primo partecipante fa clic su meetingUri all'interno dello spazio della riunione, inizia 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 metodo conferenceRecords.participants.list 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 metodo spaces.endActiveConference per terminare in modo programmatico una conferenza attiva per tutti i partecipanti.

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

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

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

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

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