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 oderid
für den Nutzer in der Directory API sein. Wenn die People API-PersonresourceName
füruser@example.com
beispielsweisepeople/123456789
ist, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Siemembership.member.name
aufusers/user@example.com
oderusers/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.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.