Hiermit wird eine Mitgliedschaft oder App-Mitgliedschaft für die anrufende App erstellt. Das Erstellen von Mitgliedschaften für andere Apps wird nicht unterstützt. Ein Beispiel finden Sie unter Nutzer oder Google Chat-Apps zu einem Gruppenbereich einladen oder hinzufügen. Wenn das angegebene Mitglied beim Erstellen einer Mitgliedschaft die Richtlinie für die automatische Annahme deaktiviert hat, wird es eingeladen. Es 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.
Wenn Sie das Mitglied angeben möchten, das hinzugefügt werden soll, legen Sie die membership.member.name
für das menschliche oder das App-Mitglied oder die membership.group_member.name
für das Gruppenmitglied 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.Zum Hinzufügen eines menschlichen Nutzers verwenden Sie
users/{user}
, wobei{user}
die E-Mail-Adresse des Nutzers sein kann. Für Nutzer in derselben Workspace-Organisation kann{user}
auch derid
für die Person aus der People API oder derid
für den Nutzer in der Directory API sein. Wenn beispielsweise die Personenprofil-ID der People API füruser@example.com
123456789
lautet, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Siemembership.member.name
aufusers/user@example.com
oderusers/123456789
festlegen.Verwenden Sie
groups/{group}
, um eine Google-Gruppe in einem benannten Gruppenbereich hinzuzufügen oder einzuladen. Dabei ist{group}
derid
für die Gruppe aus der Cloud Identity Groups API. Sie können beispielsweise die Cloud Identity Groups Lookup API verwenden, um die ID123456789
für die Gruppen-E-Mail-Adressegroup@example.com
abzurufen. Anschließend können Sie die Gruppe einem benannten Gruppenbereich hinzufügen oder sie in einen benannten Gruppenbereich einladen, indem Siemembership.group_member.name
aufgroups/123456789
setzen. E-Mail-Adressen von Gruppen werden nicht unterstützt und Google-Gruppen können nur in benannten Gruppenbereichen als Mitglieder hinzugefügt werden.
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 Das Erstellen von App-Mitgliedschaften oder das Erstellen von 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.