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 derid
für den Nutzer in der Directory API. Wenn diePerson
derresourceName
API beispielsweisepeople/123456789
ist, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Siemembership.member.name
aufusers/123456789
festlegen.
HTTP-Anfrage
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
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.