Method: spaces.members.create

Hiermit wird eine Mitgliedschaft oder App-Mitgliedschaft für die anrufende App erstellt. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel finden Sie unter Nutzer oder Google Chat-Apps zu einem Gruppenbereich einladen oder hinzufügen. Wenn das angegebene Mitglied beim Erstellen einer Mitgliedschaft die Richtlinie für die automatische Annahme deaktiviert hat, wird es eingeladen. Es muss die Einladung zum Gruppenbereich annehmen, bevor es beitreten kann. Andernfalls wird das Mitglied beim Erstellen einer Mitgliedschaft direkt dem angegebenen Gruppenbereich hinzugefügt. Erfordert eine Nutzerauthentifizierung.

Wenn Sie das Mitglied angeben möchten, das hinzugefügt werden soll, legen Sie die membership.member.name für das menschliche oder das App-Mitglied oder die membership.group_member.name für das Gruppenmitglied fest.

  • Verwenden Sie users/app, um die Anruf-App einem Gruppenbereich oder einer Direktnachricht zwischen zwei menschlichen Nutzern hinzuzufügen. Dem Gruppenbereich können keine weiteren Apps hinzugefügt werden.

  • Zum Hinzufügen eines menschlichen Nutzers verwenden Sie users/{user}, wobei {user} die E-Mail-Adresse des Nutzers sein kann. Für Nutzer in derselben Workspace-Organisation kann {user} auch der id für die Person aus der People API oder der id für den Nutzer in der Directory API sein. Wenn beispielsweise die Personenprofil-ID der People API für user@example.com 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.

  • Verwenden Sie groups/{group}, um eine Google-Gruppe in einem benannten Gruppenbereich hinzuzufügen oder einzuladen. Dabei ist {group} der id für die 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 einem benannten Gruppenbereich hinzufügen oder sie in einen benannten Gruppenbereich einladen, indem Sie membership.group_member.name auf groups/123456789 setzen. E-Mail-Adressen von Gruppen werden nicht unterstützt und Google-Gruppen können nur in benannten Gruppenbereichen als Mitglieder hinzugefügt werden.

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 Gruppenbereichs, für den die Mitgliedschaft erstellt werden soll.

Format: Leerzeichen/{Leerzeichen}

Abfrageparameter

Parameter
useAdminAccess

boolean

Wenn true, wird die Methode mit den Google Workspace-Administratorberechtigungen des 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 das Erstellen von Mitgliedschaften für Nutzer außerhalb der Google Workspace-Organisation des Administrators wird über den 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.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 Leitfaden zur Autorisierung.