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 die Nutzerauthentifizierung und den chat.memberships-Bereich (für Humanmitgliedschaften) oder chat.memberships.app (für App-Mitgliedschaften).

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.

  • Verwenden Sie users/{user}, um einen menschlichen Nutzer hinzuzufügen. Dabei ist {user} entweder der {person_id} für die Person aus der People API oder der id für den Nutzer in der Directory API. Wenn die Person der resourceName API beispielsweise people/123456789 ist, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Sie membership.member.name auf 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.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.