Method: spaces.setup

Erstellt einen Gruppenbereich und fügt ihm bestimmte Nutzer hinzu. Der anfragende Nutzer wird dem Gruppenbereich automatisch hinzugefügt und sollte in der Anfrage nicht als Mitgliedschaft angegeben werden. Ein Beispiel finden Sie unter Gruppenbereich mit ersten Mitgliedern einrichten.

Wenn Sie die hinzuzufügenden natürlichen Personen angeben möchten, fügen Sie Mitgliedschaften mit der entsprechenden membership.member.name hinzu. Wenn Sie einen Nutzer hinzufügen möchten, verwenden Sie users/{user}. {user} kann die E-Mail-Adresse des Nutzers sein. Bei Nutzern in derselben Workspace-Organisation kann {user} auch die id für die Person aus der People API oder die id für den Nutzer in der Directory API sein. Wenn die ID des Personenprofils in der People API für user@example.com beispielsweise 123456789 lautet, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Sie membership.member.name auf users/user@example.com oder users/123456789 festlegen.

Um die hinzuzufügenden Google-Gruppen anzugeben, fügen Sie Mitgliedschaften mit der entsprechenden membership.group_member.name hinzu. Wenn Sie eine Google-Gruppe hinzufügen oder einladen möchten, verwenden Sie groups/{group}. Dabei ist {group} die id der Gruppe aus der Cloud Identity Groups API. Sie können beispielsweise die Cloud Identity Groups Lookup API verwenden, um die ID 123456789 für die Gruppen-E-Mail-Adresse group@example.com abzurufen. Anschließend können Sie die Gruppe dem Gruppenbereich hinzufügen, indem Sie membership.group_member.name auf groups/123456789 festlegen. E-Mail-Adressen von Gruppen werden nicht unterstützt und Google-Gruppen können nur als Mitglieder zu benannten Gruppenbereichen hinzugefügt werden.

Wenn der Anrufer einige Mitglieder blockiert oder von ihnen blockiert wird oder keine Berechtigung zum Hinzufügen bestimmter Mitglieder hat, werden diese Mitglieder dem erstellten Gruppenbereich nicht hinzugefügt.

Wenn Sie eine Direktnachricht (DM) zwischen dem anrufenden Nutzer und einem anderen menschlichen Nutzer erstellen möchten, geben Sie genau eine Mitgliedschaft an, die den menschlichen Nutzer repräsentiert. Wenn ein Nutzer den anderen blockiert, schlägt die Anfrage fehl und die Direktnachricht wird nicht erstellt.

Wenn Sie eine DM zwischen dem anrufenden Nutzer und der anrufenden App erstellen möchten, legen Sie Space.singleUserBotDm auf true fest und geben Sie keine Mitgliedschaften an. Mit dieser Methode können Sie nur eine Direktnachricht mit der Anruf-App einrichten. Wenn Sie die Anruf-App als Mitglied eines Gruppenbereichs oder einer bestehenden Direktnachricht zwischen zwei Nutzern hinzufügen möchten, lesen Sie den Hilfeartikel Nutzer oder App zu einem Gruppenbereich einladen oder hinzufügen.

Wenn zwischen zwei Nutzern bereits eine Direktnachricht besteht, wird diese zurückgegeben, auch wenn einer der Nutzer den anderen blockiert, während eine Anfrage gestellt wird.

Gruppenbereiche mit verschachtelten Antworten werden nicht unterstützt. Wenn Sie beim Einrichten 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.

Erfordert die Nutzerauthentifizierung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
Felder
space

object (Space)

Erforderlich. Space.spaceType ist ein Pflichtfeld.

Wenn Sie einen Gruppenbereich erstellen möchten, setzen Sie Space.spaceType auf SPACE und Space.displayName. Wenn Sie beim Einrichten 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.

Wenn Sie einen Gruppenchat erstellen möchten, setzen Sie Space.spaceType auf GROUP_CHAT. Legen Sie Space.displayName nicht fest.

Wenn Sie eine Unterhaltung zwischen zwei Menschen erstellen möchten, legen Sie Space.spaceType auf DIRECT_MESSAGE und Space.singleUserBotDm auf false fest. Legen Sie nicht Space.displayName oder Space.spaceDetails fest.

Wenn Sie eine Unterhaltung zwischen einer natürlichen Person und der anrufenden Chat-App starten möchten, legen Sie Space.spaceType auf DIRECT_MESSAGE und Space.singleUserBotDm auf true fest. Legen Sie nicht Space.displayName oder Space.spaceDetails fest.

Wenn ein DIRECT_MESSAGE-Bereich bereits vorhanden ist, wird dieser zurückgegeben, anstatt einen neuen Bereich zu erstellen.
requestId

string

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 Chat-App mit einem anderen authentifizierten Nutzer angeben, wird ein Fehler zurückgegeben.
memberships[]

object (Membership)

Optional. Die Google Chat-Nutzer oder -Gruppen, die zum Beitritt zum Gruppenbereich eingeladen werden sollen. Den anrufenden Nutzer weglassen, da er automatisch hinzugefügt wird.

Derzeit sind bis zu 49 Mitgliedschaften (zusätzlich zum Anrufer) möglich.

Bei einer Mitgliedschaft für natürliche Personen muss das Feld Membership.member ein user mit ausgefülltem name enthalten (Format: users/{user}) und type auf User.Type.HUMAN festgelegt sein. Sie können nur bei der Einrichtung eines Gruppenbereichs Nutzer hinzufügen. Das Hinzufügen von Chat-Apps wird nur für die Einrichtung von Direktnachrichten mit der Anruf-App unterstützt. Sie können auch Mitglieder hinzufügen, indem Sie die E-Mail-Adresse des Nutzers als Alias für {user} verwenden. user.name kann beispielsweise users/example@gmail.com sein. Wenn Sie Gmail-Nutzer oder Nutzer aus externen Google Workspace-Domains einladen möchten, muss die E-Mail-Adresse des Nutzers für {user} verwendet werden.

Für die Mitgliedschaft in Google-Gruppen muss das Feld Membership.group_member ein group mit name enthalten (Format groups/{group}). Sie können Google-Gruppen nur hinzufügen, wenn Sie Space.spaceType auf SPACE festlegen.

Optional, wenn Space.spaceType auf SPACE gesetzt ist.

Erforderlich, wenn Space.spaceType auf GROUP_CHAT gesetzt ist, zusammen mit mindestens zwei Mitgliedschaften.

Erforderlich, wenn Space.spaceType auf DIRECT_MESSAGE gesetzt ist und ein Nutzer dabei ist, sowie genau eine Mitgliedschaft.

Muss leer sein, wenn eine Unterhaltung zwischen einem Nutzer und der anrufenden Chat-App erstellt wird (wenn Space.spaceType auf DIRECT_MESSAGE und Space.singleUserBotDm auf true gesetzt wird).

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Space.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.