Erstellt einen Gruppenbereich. Kann verwendet werden, um einen benannten Gruppenbereich oder einen Gruppenchat in Import mode zu erstellen. Ein Beispiel finden Sie unter Bereich erstellen.
Unterstützt die folgenden Authentifizierungstypen:
Bei der Authentifizierung als App muss das Feld space.customer in der Anfrage festgelegt sein.
Die Mitgliedschaft im Gruppenbereich beim Erstellen hängt davon ab, wo der Gruppenbereich erstellt wird:Import mode
- Importmodus:Es werden keine Mitglieder erstellt.
- Alle anderen Modi:Der anrufende Nutzer wird als Mitglied hinzugefügt. Das ist:
- Die App selbst, wenn die App-Authentifizierung verwendet wird.
- Der Nutzer bei Verwendung der Nutzerauthentifizierung.
Wenn Sie beim Erstellen eines Gruppenbereichs die Fehlermeldung ALREADY_EXISTS erhalten, versuchen Sie es mit einer anderen displayName. Möglicherweise wird dieser Anzeigename bereits für einen vorhandenen Gruppenbereich in der Google Workspace-Organisation verwendet.
HTTP-Anfrage
POST https://chat.googleapis.com/v1/spaces
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter | |
|---|---|
request |
Optional. Eine eindeutige Kennung für diese Anfrage. Eine zufällige UUID wird empfohlen. Wenn Sie eine vorhandene Anfrage-ID angeben, wird der mit dieser ID erstellte Gruppenbereich zurückgegeben, anstatt einen neuen zu erstellen. Wenn Sie eine vorhandene Anfrage-ID aus derselben Google Chat-App mit einem anderen authentifizierten Nutzer angeben, wird ein Fehler zurückgegeben. |
Anfragetext
Der Anfragetext enthält eine Instanz von Space.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Space.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.app.spaces.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.