Method: spaces.create

Erstellt einen Gruppenbereich. Kann verwendet werden, um einen benannten Gruppenbereich oder einen Gruppenchat im Import mode zu erstellen. Ein Beispiel finden Sie unter Gruppenbereich erstellen.

Unterstützt die folgenden Arten der Authentifizierung:

  • App-Authentifizierung mit Administratorgenehmigung und einem 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 werden.

Bei der Authentifizierung als App wird die Chat App als Mitglied des Gruppenbereichs hinzugefügt. Im Gegensatz zur Nutzerauthentifizierung 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 space.permission_settings.manage_apps auf managersAllowed fest.

Die Mitgliedschaft im Gruppenbereich hängt davon ab, ob der Gruppenbereich im Import mode erstellt wird:

  • Importmodus:Es werden keine Mitglieder erstellt.
  • Alle anderen Modi:Der aufrufende Nutzer wird als Mitglied hinzugefügt. Das ist:
    • Die App selbst bei der App-Authentifizierung.
    • Der menschliche Nutzer bei der Nutzerauthentifizierung.

Wenn beim Erstellen eines Gruppenbereichs die Fehlermeldung ALREADY_EXISTS angezeigt wird, versuchen Sie es mit einem anderen displayName. Ein vorhandener Gruppenbereich in der Google Workspace-Organisation verwendet möglicherweise bereits diesen Anzeigenamen.

HTTP-Anfrage

POST https://chat.googleapis.com/v1/spaces

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
requestId

string

Optional. Eine eindeutige ID für diese Anfrage. Eine zufällige UUID wird empfohlen. Wenn Sie eine Anfrage-ID angeben, wird die Anfrage idempotent. Das bedeutet, dass bei mehreren identischen Anfragen mit derselben Anfrage-ID nur ein einziger Gruppenbereich erstellt wird. Bei nachfolgenden Anfragen mit derselben Anfrage-ID wird der vorhandene Gruppenbereich zurückgegeben und nicht aktualisiert, auch wenn sich die angeforderten Details vom aktuellen Status unterscheiden.

So verwenden Sie dieses Feld effektiv:

  • Achten Sie darauf, dass nachfolgende Anfragen identisch sind und dieselben Authentifizierungsdaten wie die ursprüngliche Anfrage verwenden.
  • Wenn ein Gruppenbereich bereits mit der angegebenen Anfrage-ID erstellt wurde, wird dieser Gruppenbereich von der Anfrage zurückgegeben. Der zurückgegebene Gruppenbereich ist möglicherweise nicht vollständig ausgefüllt. Die API gibt den Gruppenbereich in Ihrer Anfrage mit dem vom System zugewiesenen Ressourcennamen zurück. Rufen Sie spaces.get auf, um die neuesten Metadaten für den Gruppenbereich abzurufen.
  • Wenn Sie eine vorhandene Anfrage-ID mit einem anderen authentifizierten Nutzer wiederverwenden, tritt ein Fehler auf.

Anfragetext

Der Anfragetext enthält eine Instanz von Space.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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.