Method: spaces.create

• HTTP-Anfrage
• Suchparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche
• Testen!

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:

• App-Authentifizierung mit Administratorzustimmung in der Entwicklervorschau und einer der folgenden Autorisierungsbereiche:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces

• Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)

Bei der Authentifizierung als App muss das Feld space.customer in der Anfrage festgelegt sein.

Bei der Authentifizierung als App wird die Chat-App als Mitglied des Gruppenbereichs hinzugefügt. Im Gegensatz zur Authentifizierung durch eine Person wird die Chat-App jedoch nicht als Administrator des Gruppenbereichs hinzugefügt. Standardmäßig kann die Chat-App von allen Mitgliedern des Gruppenbereichs entfernt werden. Wenn nur Administratoren des Gruppenbereichs die App aus einem Gruppenbereich entfernen dürfen, legen Sie für space.permission_settings.manage_apps den Wert managersAllowed fest.

Die Gruppenbereichs-Mitgliedschaft 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
requestId	string Optional. Eine eindeutige Kennung für diese Anfrage. Wir empfehlen eine zufällige UUID. 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 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.create
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.spaces
• https://www.googleapis.com/auth/chat.spaces.create

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.