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 virtueller Treffpunkt repräsentiert einen virtuellen Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem Konferenzen abgehalten werden. In einem virtuellen Treffpunkt kann immer nur eine aktive Konferenz stattfinden. Ein virtueller Treffpunkt hilft Nutzern auch, sich zu treffen und gemeinsame Ressourcen zu finden.

Informationen zum Arbeiten mit virtuellen Treffpunkten finden Sie unter Virtuelle Treffpunkte erstellen und verwalten. Informationen zum programmatischen Konfigurieren eines virtuellen Treffpunkts finden Sie unter Virtuelle Treffpunkte und Mitglieder konfigurieren.

Methoden für virtuelle Treffpunkte aufrufen

In der folgenden Tabelle sind die Besprechungsrollen aufgeführt, die für die Verwendung der Methoden für virtuelle Treffpunkte erforderlich sind:

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

So identifiziert Meet einen virtuellen Treffpunkt

Die Google Meet REST API generiert für jeden virtuellen Treffpunkt 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 virtuellen Treffpunkt identifizieren und daran teilnehmen:

Feldname Beschreibung
name Der Name des virtuellen Treffpunkts. Der String {space} ist die Ressourcen ID für den virtuellen Treffpunkt und wird als spaces/{space} formatiert. Es handelt sich um eine eindeutige, vom Server generierte ID, bei der die Groß- und Kleinschreibung beachtet wird. Beispiel: spaces/jQCFfuBOdN5z.
meetingCode Der Alias für den Namen des virtuellen Treffpunkts. 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 des meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Die Methoden für den Telefonzugriff für diesen virtuellen Treffpunkt. Das phoneAccess-Objekt enthält Informationen, die für die Einwahl in eine Konferenz erforderlich sind, einschließlich der regionalen Telefonnummern für den virtuellen Treffpunkt 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 virtuellen Treffpunkt 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 virtuellen Treffpunkt. 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 virtuellen Treffpunkt zu verwalten:

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

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

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

Lebenszyklus eines virtuellen Treffpunkts

Ein virtueller Treffpunkt durchläuft im Laufe seines Lebenszyklus mehrere Status. Das folgende Diagramm zeigt die allgemeinen Schritte des Lebenszyklus eines virtuellen Treffpunkts:

Der Lebenszyklus von Konferenzräumen.
Abbildung 1. Der Lebenszyklus eines virtuellen Treffpunkts.

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

  2. Neuen virtuellen Treffpunkt 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 im virtuellen Treffpunkt auf meetingUri 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 beendet. Wenn der letzte Teilnehmer die Konferenz verlässt, wird sie beendet.

  7. Artefakte nach der Konferenz abfragen. Die Konferenz wurde 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 der URI zum Artefaktobjekt verfügbar ist, wird er ausgefüllt und als Teil des Ressourcenobjekts zurückgegeben.