Method: members.hasMember
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Prüft, ob der angegebene Nutzer Mitglied der Gruppe ist. Die Mitgliedschaft kann direkt oder verschachtelt sein. Bei einer verschachtelten Mitgliedschaft müssen memberKey
und groupKey
jedoch Entitäten in derselben Domain sein, da sonst ein Invalid input
-Fehler zurückgegeben wird. Wenn Sie nach verschachtelten Mitgliedschaften suchen möchten, die Entitäten außerhalb der Domain der Gruppe enthalten, verwenden Sie die Methode checkTransitiveMembership()
in der Cloud Identity Groups API.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
groupKey |
string
Identifiziert die Gruppe in der API-Anfrage. Der Wert kann die E-Mail-Adresse, der Alias oder die eindeutige ID der Gruppe sein.
|
memberKey |
string
Identifiziert das Nutzermitglied in der API-Anfrage. Der Wert kann die primäre E-Mail-Adresse, der Alias oder die eindeutige ID des Nutzers sein.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
JSON-Vorlage für die Antwort „Hat Mitglied“ in der Directory API.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"isMember": boolean
} |
Felder |
isMember |
boolean
Nur Ausgabe. Gibt an, ob der angegebene Nutzer Mitglied der Gruppe ist. Die Mitgliedschaft kann direkt oder verschachtelt sein.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://apps-apis.google.com/a/feeds/groups/
https://www.googleapis.com/auth/admin.directory.group
https://www.googleapis.com/auth/admin.directory.group.member
https://www.googleapis.com/auth/admin.directory.group.member.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: members.hasMember\n\nChecks whether the given user is a member of the group. Membership can be direct or nested, but if nested, the `memberKey` and `groupKey` must be entities in the same domain or an `Invalid input` error is returned. To check for nested memberships that include entities outside of the group's domain, use the [`checkTransitiveMembership()`](https://cloud.google.com/identity/docs/reference/rest/v1/groups.memberships/checkTransitiveMembership) method in the Cloud Identity Groups API.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `groupKey` | `string` Identifies the group in the API request. The value can be the group's email address, group alias, or the unique group ID. |\n| `memberKey` | `string` Identifies the user member in the API request. The value can be the user's primary email address, alias, or unique ID. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nJSON template for Has Member response in Directory API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------|\n| ``` { \"isMember\": boolean } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------|\n| `isMember` | `boolean` Output only. Identifies whether the given user is a member of the group. Membership can be direct or nested. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://apps-apis.google.com/a/feeds/groups/`\n- `\n https://www.googleapis.com/auth/admin.directory.group`\n- `\n https://www.googleapis.com/auth/admin.directory.group.member`\n- `\n https://www.googleapis.com/auth/admin.directory.group.member.readonly`\n- `\n https://www.googleapis.com/auth/admin.directory.group.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]