Stay organized with collections
Save and categorize content based on your preferences.
Search transitive memberships of a group.
Note: This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. If the account of the group is not one of these, a 403 (PERMISSION_DENIED) HTTP status code will be returned.
A transitive membership is any direct or indirect membership of a group. Actor must have view permissions to all transitive memberships.
HTTP request
GET https://cloudidentity.googleapis.com/v1/{parent=groups/*}/memberships:searchTransitiveMemberships
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThis API allows searching for transitive memberships of a group, which includes both direct and indirect memberships.\u003c/p\u003e\n"],["\u003cp\u003eAccess to this feature is limited to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education, as well as Cloud Identity Premium accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint is \u003ccode\u003eGET https://cloudidentity.googleapis.com/v1/{parent=groups/*}/memberships:searchTransitiveMemberships\u003c/code\u003e, requiring the group's unique ID in the \u003ccode\u003eparent\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of \u003ccode\u003ememberships\u003c/code\u003e each detailing a transitive member with their \u003ccode\u003epreferredMemberKey\u003c/code\u003e, \u003ccode\u003emember\u003c/code\u003e, \u003ccode\u003eroles\u003c/code\u003e and \u003ccode\u003erelationType\u003c/code\u003e, and can be paginated using the \u003ccode\u003enextPageToken\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the specified OAuth scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.groups.readonly\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: groups.memberships.searchTransitiveMemberships\n\nSearch transitive memberships of a group.\n\n**Note:** This feature is only available to Google Workspace Enterprise Standard, Enterprise Plus, and Enterprise for Education; and Cloud Identity Premium accounts. If the account of the group is not one of these, a 403 (PERMISSION_DENIED) HTTP status code will be returned.\n\nA transitive membership is any direct or indirect membership of a group. Actor must have view permissions to all transitive memberships.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/{parent=groups/*}/memberships:searchTransitiveMemberships`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response message for [MembershipsService.SearchTransitiveMemberships](/identity/docs/reference/rest/v1/groups.memberships/searchTransitiveMemberships#google.apps.cloudidentity.groups.v1.MembershipsService.SearchTransitiveMemberships).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-identity.groups.readonly`\n- `https://www.googleapis.com/auth/cloud-identity.groups`\n- `https://www.googleapis.com/auth/cloud-identity`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nMemberRelation\n--------------\n\nMessage representing a transitive membership of a group."]]
