Ein Konferenzraum ist ein virtueller Ort oder ein festes Objekt (z. B. ein Konferenzraum), an dem Konferenzen stattfinden. In einem Gruppenbereich kann immer nur eine aktive Videokonferenz stattfinden. Ein Gruppenbereich hilft Nutzern auch, sich zu treffen und gemeinsam genutzte Ressourcen zu finden.
In den folgenden Abschnitten wird beschrieben, wie Sie einen Konferenzraum erstellen, abrufen und aktualisieren.
So wird ein Konferenzraum in Google Meet erkannt
Die Google Meet REST API generiert für jeden Besprechungsraum eine spaces
-Ressource. Das Feld name
ist der Ressourcenname der Ressource.
Es gibt zwei wichtige Möglichkeiten, einen Besprechungsraum mit dem Feld name
anzugeben:
space
ist die Ressourcen-ID für den Bereich im Formatspaces/{space}
. Es handelt sich um eine eindeutige, servergenerierte ID, bei der zwischen Groß- und Kleinschreibung unterschieden wird. Beispiel:spaces/jQCFfuBOdN5z
meetingCode
ist ein Alias für den Gruppenbereich im Formatspaces/{meetingCode}
. Es ist ein eingabefähiger, eindeutiger Zeichenstring, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird. Beispiel:abc-mnop-xyz
Die maximale Länge beträgt 128 Zeichen. Sie ist Teil desmeetingUri
:https://meet.google.com/abc-mnop-xyz
.
Verwenden Sie die folgenden Werte für das Feld {name}
, um einen Besprechungsraum zu verwalten:
Sie können entweder
spaces/{space}
oder den Aliasspaces/{meetingCode}
verwenden, um Details zu einem Besprechungsraum abzurufen. Weitere Informationen finden Sie unter Videokonferenzraum erhalten.Wenn Sie die Details eines Konferenzraums aktualisieren möchten, können Sie nur
spaces/{space}
verwenden. Weitere Informationen finden Sie unter Konferenzraum 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.
Konferenzräume erstellen
Verwenden Sie zum Erstellen eines Konferenzraums die Methode create
für die Ressource spaces
.
Die Methode gibt eine Instanz einer spaces
-Ressource zurück, die das Objekt SpaceConfig
enthält, das die Konfiguration für den Besprechungsraum darstellt. Außerdem enthält es das Objekt ActiveConference
, das einen Link zur aktuellen conferenceRecords
-Ressource im Konferenzraum ist.
Das folgende Codebeispiel zeigt, wie ein Besprechungsraum erstellt wird:
Java
Node.js
Python
Konferenzraum erhalten
Wenn Sie Details zu einem Besprechungsraum abrufen möchten, verwenden Sie die Methode get
für die Ressource spaces
mit einer angegebenen name
.
Weitere Informationen finden Sie unter So erkennt Meet einen Besprechungsraum.
Die Methode gibt einen Konferenzraum als Instanz der Ressource space
zurück.
Im folgenden Codebeispiel wird gezeigt, wie ein Besprechungsraum abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Gruppenbereichsnamen durch die eindeutige, servergenerierte ID für den Gruppenbereich.
Besprechungsraum aktualisieren
Wenn Sie die Details eines Besprechungsraums aktualisieren möchten, verwenden Sie die Methode patch
für die Ressource spaces
mit einer angegebenen name
.
Weitere Informationen finden Sie unter So wird in Google Meet ein Konferenzraum identifiziert.
Die Methode patch
akzeptiert auch einen optionalen Parameter updateMask
. Das Feld hat den Typ FieldMask
.
Dies ist eine durch Kommas getrennte Liste der Felder, die Sie im Gruppenbereich aktualisieren möchten.
Die Methode gibt einen Besprechungsraum als Instanz der Ressource spaces
zurück.
Im folgenden Codebeispiel wird gezeigt, wie ein Besprechungsraum aktualisiert wird:
Java
Node.js
Python
Ersetzen Sie den Gruppenbereichsnamen durch die eindeutige, servergenerierte ID für den Gruppenbereich für die Videokonferenz.
Aktive Konferenz beenden
Wenn Sie eine aktive Konferenz in einem Konferenzraum beenden möchten, verwenden Sie die Methode spaces.endActiveConference
für die Ressource spaces
. Sowohl der Anfragetext als auch der Antworttext sind leer. Weitere Informationen finden Sie unter So erkennt Google Meet einen Konferenzraum.
Im folgenden Codebeispiel wird gezeigt, wie eine aktive Konferenz beendet wird:
Java
Node.js
Python
Ersetzen Sie den Gruppenbereichsnamen durch die eindeutige, servergenerierte ID für den Gruppenbereich.