Erstellt eine Mitgliedschaft durch einen Mitarbeiter oder eine App-Mitgliedschaft für die aufrufende App. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel finden Sie im Hilfeartikel Nutzer oder eine Google Chat-App in einen Gruppenbereich einladen oder hinzufügen. Wenn das angegebene Mitglied beim Erstellen einer Mitgliedschaft die Richtlinie zum automatischen Annehmen deaktiviert hat, wird es 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 eine Nutzerauthentifizierung.
Um das hinzuzufügende Mitglied anzugeben, legen Sie membership.member.name
in der CreateMembershipRequest
fest:
Verwenden Sie
users/app
, um die Anruf-App einem Gruppenbereich oder einer Direktnachricht zwischen zwei menschlichen 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 Person-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.