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 Besprechungsbereich 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 Besprechungsbereichs finden Sie unter Besprechungsbereiche und Mitglieder konfigurieren.

Methoden für Konferenzräume aufrufen

In der folgenden Tabelle werden die für die Verwendung der Methoden für Besprechungsrä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 Besprechungsbereich 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 Besprechungsraum 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 wird dabei nicht beachtet. 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 Meetingbereich. Das phoneAccess-Objekt enthält Informationen, die für die Einwahl in eine Videokonferenz erforderlich sind, einschließlich der regionalen Telefonnummern für den Besprechungsraum und eines PIN-Codes, der für diese Telefonnummer spezifisch ist. Die PIN besteht nur aus Dezimalziffern und die Länge kann variieren. Zum Beispiel: "pin": 19707127300.

Ähnlich wie in der Meet-Benutzeroberfläche enthält die Ressource spaces eine begrenzte Anzahl von Einwahlnummern. Sie können zusätzliche Telefonnummern für einen Besprechungsraum 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 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 Feld name, um einen Besprechungsraum zu verwalten:

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

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

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

Lebenszyklus eines Besprechungsraums

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

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

  1. Anruf spaces.create: Der Besprechungsraum 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 Besprechungsbereich auf meetingUri klickt, wird eine Konferenz gestartet. 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 Videokonferenz 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.