Google Meet-Konferenzräume – Übersicht

Google Meet REST API Abbildung

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

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

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

Methoden für Konferenzräume aufrufen

In der folgenden Tabelle werden die für die Verwendung der Methoden für Konferenzräume erforderlichen Besprechungsrollen beschrieben:

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

So identifiziert Meet einen Konferenzraum

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

In der folgenden Tabelle sehen Sie, wie Sie einen Konferenzraum identifizieren und ihm beitreten:

Feldname Beschreibung
name Der Name des Gruppenbereichs. Der String {space} ist die Ressourcen-ID für den Bereich und wird als spaces/{space} formatiert. Es handelt sich um eine eindeutige, vom Server generierte ID, bei der zwischen Groß- und Kleinschreibung unterschieden wird. Beispiel: spaces/jQCFfuBOdN5z
meetingCode Der Alias für den Namen des Gruppenbereichs. {meetingCode} ist eine eindeutige Zeichenfolge, die eingegeben werden kann. Die Groß- und Kleinschreibung spielt dabei keine Rolle. Das Format sieht so aus: spaces/{meetingCode}. Beispiel: spaces/abc-mnop-xyz Die maximale Länge beträgt 128 Zeichen. Sie ist Teil der meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Die Telefonzugriffsmethoden 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 bei der Meet-Benutzeroberfläche enthält die Ressource spaces eine begrenzte Anzahl von Einwahlnummern. Sie können zusätzliche Telefonnummern für einen Konferenzraum aufrufen, indem Sie {meetingCode} an die folgende URL anhängen: https://meet.google.com/tel/. Beispiel: https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Die SIP-Zugriffsmethoden (Session Initiation Protocol) für diesen Konferenzraum. Eine SIP-Adresse enthält Informationen dazu, 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 Feld name, um einen Konferenzraum zu verwalten:

  • Um Details zu einem Besprechungsraum abzurufen, können Sie entweder spaces/{space} oder den Alias spaces/{meetingCode} verwenden. Weitere Informationen finden Sie unter Besprechungsraum reservieren.

  • 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 Videokonferenz beenden.

Lebenszyklus eines Konferenzraums

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

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

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

  2. Umfrage zum neuen Besprechungsbereich starten: Rufen Sie die Methode spaces.get auf, um den Konferenzstatus zu prüfen.

    Anstatt zu pollen, können Sie auch Meet-Termine abonnieren, um Push-Benachrichtigungen zu erhalten.

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

  4. Optional: Konferenzdaten abrufen Während einer aktiven Videokonferenz können Sie auf einige conferenceRecord-Werte zugreifen. Rufen Sie beispielsweise die Methode conferenceRecords.participants.list auf, um alle Teilnehmer der Videokonferenz 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 Organisator der Besprechung die Methode spaces.endActiveConference aufrufen, um eine aktive Konferenz für alle Teilnehmer programmatisch zu beenden.

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

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

    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 Methode conferenceRecords.recordings.get auf, um eine Aufnahme anhand der Aufnahme-ID abzurufen.

    Sobald das Artefakt bereit ist, wird ein URI zum Artefaktobjekt ausgefüllt und als Teil des Ressourcenobjekts zurückgegeben.