Ein Konferenzraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in 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 Besprechungsraum 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 Gruppenbereich, formatiert alsspaces/{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, der alsspaces/{meetingCode}
formatiert ist. 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.Zum Aktualisieren der Details eines Besprechungsraums können Sie nur
spaces/{space}
verwenden. Weitere Informationen finden Sie unter Konferenzraum aktualisieren.Um eine aktive Konferenz in einem Besprechungsraum zu beenden, können Sie nur
spaces/{space}
verwenden. Weitere Informationen finden Sie unter Aktive Konferenz beenden.
Besprechungsraum 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 sie das ActiveConference
-Objekt, das einen Link zur aktuellen conferenceRecords
-Ressource im Konferenzraum darstellt.
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 wird in Google Meet ein Konferenzraum identifiziert.
Die Methode gibt einen Besprechungsraum 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 Besprechungsraum identifiziert.
Die Methode patch
akzeptiert auch den 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.
Aktive Konferenz beenden
Wenn Sie eine aktive Konferenz in einem Besprechungsraum 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.