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 dieid
für die Person aus der People API oder dieid
für den Nutzer in der Directory API sein. Wenn die Personen-Profil-ID der People API füruser@example.com
beispielsweise123456789
lautet, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Siemembership.member.name
aufusers/user@example.com
oderusers/123456789
setzen.
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: 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.