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.
Legen Sie zum Angeben des hinzuzufügenden Mitglieds die membership.member.name
für das Nutzer- oder App-Mitglied 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} |
Abfrageparameter
Parameter | |
---|---|
useAdminAccess |
true , wird die Methode mit den Google Workspace-Administratorberechtigungen des Nutzers ausgeführt.Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung „Unterhaltungen in Chats und Gruppenbereichen verwalten“ sein. Erfordert den OAuth 2.0-Bereich von Das Erstellen von App-Mitgliedschaften oder Mitgliedschaften für Nutzer außerhalb der Google Workspace-Organisation des Administrators wird über den Administratorzugriff nicht unterstützt. |
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.admin.memberships
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.