Ein Konferenzraum ist ein virtueller Ort oder ein festes Objekt (z. B. ein Konferenzraum), an dem Konferenzen stattfinden. Es kann jeweils nur eine aktive Konferenz an einem Ort abgehalten werden. Ein Besprechungsraum hilft Nutzern auch, gemeinsame Ressourcen zu finden.
In den folgenden Abschnitten wird beschrieben, wie Sie einen Konferenzraum erstellen, abrufen und aktualisieren.
So wird ein Konferenzraum in Meet identifiziert
Die Google Meet REST API generiert für jeden Konferenzraum eine spaces
-Ressource. Das Feld name
ist der Ressourcenname der Ressource.
Im Folgenden sind zwei wichtige Möglichkeiten zum Identifizieren eines Konferenzraums mithilfe des Felds name
aufgeführt:
space
ist die Ressourcen-ID für den Bereich im Formatspaces/{space}
. Es handelt sich um eine eindeutige, vom Server generierte ID, bei der die Groß- und Kleinschreibung berücksichtigt wird. Beispiel:spaces/jQCFfuBOdN5z
meetingCode
ist ein Alias für den Gruppenbereich im Formatspaces/{meetingCode}
. Es ist ein typbarer, eindeutiger String, 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 Konferenzraum zu verwalten:
Wenn Sie Details zu einem Konferenzraum abrufen möchten, können Sie entweder
spaces/{space}
oder den Aliasspaces/{meetingCode}
verwenden. Weitere InformationenWenn Sie die Details eines Konferenzraums aktualisieren möchten, können Sie nur
spaces/{space}
verwenden. Weitere InformationenWenn 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 Konferenzraum ist. Außerdem enthält es das Objekt ActiveConference
, das einen Link zur aktuellen conferenceRecords
-Ressource im Konferenzraum ist.
Das folgende Codebeispiel zeigt, wie Sie einen Konferenzraum erstellen:
Java
Node.js
Python
Einen Konferenzraum buchen
Wenn Sie Details zu einem Konferenzraum abrufen möchten, verwenden Sie die Methode get
für die Ressource spaces
mit einem angegebenen name
.
Weitere Informationen finden Sie unter So erkennt Meet einen Besprechungsraum.
Die Methode gibt einen Konferenzraum als Instanz der Ressource space
zurück.
Das folgende Codebeispiel zeigt, wie ein Konferenzraum abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Namen des Gruppenbereichs durch die eindeutige, vom Server generierte ID des Konferenzraums.
Konferenzraum aktualisieren
Wenn Sie die Details eines Konferenzraums aktualisieren möchten, verwenden Sie die Methode patch
für die Ressource spaces
mit einem angegebenen name
.
Weitere Informationen finden Sie unter So erkennt Meet einen Besprechungsraum.
Die Methode patch
verwendet auch einen optionalen updateMask
-Parameter. Das Feld hat den Typ FieldMask
.
Dies ist eine durch Kommas getrennte Liste von Feldern, die in dem Leerzeichen aktualisiert werden sollen.
Die Methode gibt einen Konferenzraum als Instanz der Ressource spaces
zurück.
Das folgende Codebeispiel zeigt, wie Sie einen Konferenzraum aktualisieren:
Java
Node.js
Python
Ersetzen Sie den Namen des Gruppenbereichs durch die eindeutige, vom Server generierte ID des Konferenzraums.
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 Anfrage- als auch der Antworttext sind leer. Weitere Informationen
Das folgende Codebeispiel zeigt, wie eine aktive Konferenz beendet wird:
Java
Node.js
Python
Ersetzen Sie den Namen des Gruppenbereichs durch die eindeutige, vom Server generierte ID des Konferenzraums.