Method: spaces.members.create

Erstellt eine Nutzer- oder App-Mitgliedschaft für die anrufende App. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel findest du unter Mitgliedschaft erstellen. Wenn das angegebene Mitglied bei der Erstellung einer Mitgliedschaft die Richtlinie für die automatische Annahme deaktiviert hat, wird es eingeladen und muss vor dem Beitritt die Einladung zum Gruppenbereich annehmen. Andernfalls wird eine Person direkt zum angegebenen Gruppenbereich hinzugefügt. Erfordert Nutzerauthentifizierung.

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

  • Wenn Sie die Anruf-App einem Gruppenbereich oder einer Direktnachricht zwischen zwei menschlichen Nutzern hinzufügen möchten, verwenden Sie users/app. Andere Apps können dem Gruppenbereich nicht hinzugefügt werden.

  • Wenn Sie einen menschlichen Nutzer hinzufügen möchten, verwenden Sie users/{user}. Dabei kann {user} die E-Mail-Adresse des Nutzers sein. Für Nutzer in derselben Workspace-Organisation kann {user} auch {person_id} für die Person aus der People API oder id für den Nutzer in der Directory API sein. Wenn die People API-Person resourceName für user@example.com beispielsweise people/123456789 ist, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Sie membership.member.name auf users/user@example.com oder users/123456789 festlegen.

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: Gruppenbereiche/{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.