Method: spaces.members.create

Erstellt eine Mitgliedschaft für die aufrufende Chat-App, einen Nutzer oder eine Google-Gruppe. Das Erstellen von Mitgliedschaften für andere Chat-Apps wird nicht unterstützt. Wenn Sie eine Mitgliedschaft erstellen und die angegebene Person die Richtlinie zum automatischen Akzeptieren deaktiviert hat, wird sie eingeladen und muss die Einladung für den Bereich annehmen, bevor sie beitreten kann. Andernfalls wird das Mitglied durch das Erstellen einer Mitgliedschaft direkt dem angegebenen Gruppenbereich hinzugefügt.

Unterstützt die folgenden Arten der Authentifizierung:

  • App-Authentifizierung mit Administratorgenehmigung und dem Autorisierungsbereich:

    • https://www.googleapis.com/auth/chat.app.memberships

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (um die Anruf-App dem Gruppenbereich hinzuzufügen)
    • https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)
    • Bei der Nutzerauthentifizierung werden Administratorrechte gewährt, wenn ein Administratorkonto authentifiziert wird, useAdminAccess gleich true ist und der folgende Autorisierungsbereich verwendet wird:
      • https://www.googleapis.com/auth/chat.admin.memberships

Die App-Authentifizierung wird für die folgenden Anwendungsfälle nicht unterstützt:

  • Nutzer einladen, die nicht zur Workspace-Organisation gehören, die Eigentümer des Gruppenbereichs ist.
  • Google-Gruppen zu Gruppenbereichen hinzufügen
  • Eine Chat-App zu einem Gruppenbereich hinzufügen

Beispiele zur Verwendung finden Sie unter:

HTTP-Anfrage

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Spaces, für den die Mitgliedschaft erstellt werden soll.

Format: spaces/{space}

Abfrageparameter

Parameter
useAdminAccess

boolean

Optional. Wenn true, wird die Methode mit den Administratorberechtigungen des Google Workspace-Nutzers ausgeführt.

Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung Unterhaltungen in Chats und Gruppenbereichen verwalten sein.

Erfordert den chat.admin.memberships OAuth 2.0-Bereich.

Das Erstellen von App-Mitgliedschaften oder Mitgliedschaften für Nutzer außerhalb der Google Workspace-Organisation des Administrators wird mit Administratorzugriff nicht unterstützt.

Anfragetext

Der Anfragetext enthält eine Instanz von Membership.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Membership.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Weitere Informationen finden Sie im Autorisierungsleitfaden.