Method: spaces.members.create

Erstellt eine Mitgliedschaft durch einen Mitarbeiter oder eine App-Mitgliedschaft für die aufrufende App. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel finden Sie im Hilfeartikel Nutzer oder eine Google Chat-App in einen Gruppenbereich einladen oder hinzufügen. Wenn das angegebene Mitglied beim Erstellen einer Mitgliedschaft die Richtlinie zum automatischen Annehmen deaktiviert hat, wird es eingeladen und 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.

Um das hinzuzufügende Mitglied anzugeben, legen Sie membership.member.name in der CreateMembershipRequest 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.

  • Verwenden Sie users/{user}, um einen menschlichen Nutzer hinzuzufügen, wobei {user} die E-Mail-Adresse des Nutzers sein kann. Für Nutzer 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 Person-Profil-ID 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 setzen.

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}

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.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.