Method: spaces.members.create

Erstellt eine Mitgliedschaft oder App-Mitgliedschaft für die Anruf-App. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel finden Sie unter Mitgliedschaft erstellen. Wenn beim Erstellen einer Mitgliedschaft die Richtlinie zum automatischen Akzeptieren deaktiviert ist, wird das Mitglied 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 die Nutzerauthentifizierung.

Um das hinzuzufügende Mitglied anzugeben, legen Sie membership.member.name in CreateMembershipRequest fest:

  • Verwenden Sie users/app, um die Anruf-App einem Gruppenbereich oder einer Direktnachricht zwischen zwei 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 Personen-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.