Google Meet-Konferenzräume – Übersicht

Google Meet REST API Abbildung

In dieser Anleitung wird beschrieben, wie Sie mit der Google Meet REST API Besprechungen für Google Meet erstellen und verwalten.

Ein Besprechungsraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem Konferenzen abgehalten werden. In einem Raum kann jeweils nur eine aktive Konferenz stattfinden. Ein Konferenzraum hilft Nutzern auch, sich zu treffen und freigegebene Ressourcen zu finden.

Informationen zum Arbeiten mit Besprechungsräumen finden Sie unter Besprechungsräume erstellen und verwalten. Informationen zum programmatischen Konfigurieren eines Konferenzraums finden Sie unter Konferenzräume und Mitglieder konfigurieren.

Methoden für Konferenzräume aufrufen

In der folgenden Tabelle sind die Besprechungsrollen aufgeführt, die für die Verwendung der Methoden für Konferenzräume erforderlich sind:

Methode Inhaber Teilnehmer Sonstiges
endActiveConference x
get x x x
mit Einstellungen x
mit aktiver Konferenz x x
patch x

Wie Meet einen Konferenzraum identifiziert

Die Google Meet REST API generiert für jeden Konferenzraum eine spaces-Ressource. Die spaces-Ressource bietet mehrere Einstiegspunkte für die Teilnahme an einer Konferenz.

In der folgenden Tabelle wird beschrieben, wie Sie einen Konferenzraum identifizieren und daran teilnehmen:

Feldname Beschreibung
name Der Name des Raums. Der String {space} ist die Ressourcen ID für den Raum und wird als spaces/{space} formatiert. Es ist eine eindeutige, vom Server generierte ID, bei der die Groß- und Kleinschreibung beachtet wird. Beispiel: spaces/jQCFfuBOdN5z.
meetingCode Der Alias für den Raumnamen. Der {meetingCode} ist ein eindeutiger String, bei dem die Groß- und Kleinschreibung nicht beachtet wird. Er wird als spaces/{meetingCode} formatiert. Beispiel: spaces/abc-mnop-xyz. Die maximale Länge beträgt 128 Zeichen. Er ist Teil der meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Die Methoden für den Telefonzugriff für diesen Konferenzraum. Das phoneAccess-Objekt enthält Informationen, die für die Einwahl in eine Konferenz erforderlich sind, einschließlich der regionalen Telefonnummern für den Konferenzraum und eines PIN-Codes, der für diese Telefonnummer spezifisch ist. Die PIN besteht nur aus Dezimalziffern und die Länge kann variieren. Beispiel: "pin": 19707127300.

Ähnlich wie in der Meet-Benutzeroberfläche enthält die spaces-Ressource eine begrenzte Anzahl von Einwahlnummern. Weitere Telefonnummern für einen Konferenzraum finden Sie, indem Sie die folgende URL mit {meetingCode} ergänzen: https://meet.google.com/tel/. Beispiel: https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Die Methoden für den Zugriff über das Session Initiation Protocol (SIP) für diesen Konferenzraum. Eine SIP-Adresse gibt an, wie Videokonferenzhardware von Drittanbietern eine Meet-Konferenz finden und daran teilnehmen kann. Das gatewaySipAccess-Objekt enthält einen URI und einen numerischen Zugriffscode. Meet unterstützt das SIP-URI-Schema.

Verwenden Sie die folgenden Werte für das name Feld, um einen Konferenzraum zu verwalten:

  • Wenn Sie Details zu einem Konferenzraum abrufen möchten, können Sie entweder spaces/{space} oder den Alias spaces/{meetingCode} verwenden. Weitere Informationen finden Sie unter Besprechungsraum abrufen.

  • Wenn Sie die Details eines Konferenzraums aktualisieren möchten, können Sie nur spaces/{space} verwenden. Weitere Informationen finden Sie unter Besprechungsraum aktualisieren.

  • Wenn Sie eine aktive Konferenz in einem Konferenzraum beenden möchten, können Sie nur spaces/{space} verwenden. Weitere Informationen finden Sie unter Aktive Konferenz beenden.

Lebenszyklus eines Konferenzraums

Ein Konferenzraum durchläuft im Laufe seines Lebenszyklus mehrere Status. Das folgende Diagramm zeigt die allgemeinen Schritte des Lebenszyklus eines Konferenzraums:

Der Lebenszyklus von Konferenzräumen.
Abbildung 1. Der Lebenszyklus eines Konferenzraums.

  1. Aufrufen spaces.create. Der Konferenzraum wird erstellt und das zurückgegebene spaces-Objekt enthält den String meetingUri. Die meetingUri wird dann an die Teilnehmer verteilt.

  2. Neuen Konferenzraum abfragen. Rufen Sie die spaces.get Methode auf, um den Konferenzstatus zu prüfen.

    Anstatt abzufragen, können Sie auch Meet Ereignisse abonnieren, um Push Benachrichtigungen zu erhalten.

  3. Konferenz starten. Wenn der erste Teilnehmer auf die meetingUri im Konferenzraum klickt, beginnt eine Konferenz. Das activeConference Objekt wird ausgefüllt und der activeConference.conferenceRecord String wird festgelegt.

  4. (Optional) Konferenzdaten abrufen. Während einer aktiven Konferenz können Sie auf einige conferenceRecord-Werte zugreifen. Rufen Sie beispielsweise die conferenceRecords.participants.list Methode auf, um alle Teilnehmer der Konferenz zu sehen. Sie können auch bis zu 30 Tage nach der Konferenz auf diese Informationen zugreifen.

  5. (Optional) Konferenz beenden. Während der Konferenz kann der Inhaber der Besprechung die spaces.endActiveConference Methode aufrufen, um eine aktive Konferenz für alle Teilnehmer programmatisch zu beenden.

  6. Konferenz endet. Wenn der letzte Teilnehmer die Konferenz verlässt, endet sie.

  7. Artefakte nach der Konferenz abfragen. Die Konferenz ist beendet (STATE=ENDED), aber die Artefakte wurden noch nicht generiert. Außerdem werden startTime und endTime für die Konferenz ausgefüllt. Sie müssen den Artefakt-Endpunkt abfragen, bis für das Artefaktobjekt STATE der Wert FILE_GENERATED angezeigt wird.

    Anstatt abzufragen, können Sie Meet-Ereignisse abonnieren, um Push-Benachrichtigungen zu erhalten.

  8. Artefakte nach der Konferenz abrufen. Sie können Artefakte wie Aufzeichnungen und Transkripte abrufen, sobald sie generiert wurden. Rufen Sie beispielsweise die conferenceRecords.recordings.get Methode auf, um eine Aufzeichnung anhand der Aufzeichnungs-ID abzurufen.

    Sobald das Artefaktobjekt fertig ist, wird ein URI dafür ausgefüllt und als Teil des Ressourcenobjekts zurückgegeben.