Required. The parent resource under which to list allGroupresources.
Must be of the formidentitysources/{identity_source_id}for external- identity-mapped groups orcustomers/{customer_id}for Google Groups. Thecustomer_idmust begin with "C" (for example, 'C046psxkn').Find your customer ID.
Note that the number of results returned may be less than this value even if there are more available results. To fetch all results, clients must continue calling this method repeatedly until the response no longer contains anext_page_token.
If unspecified, defaults to 200 forView.BASICand to 50 forView.FULL.
Must not be greater than 1000 forView.BASICor 500 forView.FULL.
pageToken
string
Thenext_page_tokenvalue returned from a previous list request, if any.
[[["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 endpoint retrieves a list of \u003ccode\u003eGroup\u003c/code\u003e resources associated with a specified customer or namespace.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e parameter, which is required, determines whether you are listing groups under an external identity source or a Google customer, with specific formatting requirements.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eview\u003c/code\u003e parameter allows you to choose between returning \u003ccode\u003eBASIC\u003c/code\u003e or \u003ccode\u003eFULL\u003c/code\u003e details for each group, affecting the amount of information received.\u003c/p\u003e\n"],["\u003cp\u003ePagination is supported, enabling retrieval of results in batches using the \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization via OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.groups.readonly\u003c/code\u003e, is required to access this API.\u003c/p\u003e\n"]]],[],null,["# Method: groups.list\n\nLists the `Group` resources under a customer or namespace.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1beta1/groups`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response message for [GroupsService.ListGroups](/identity/docs/reference/rest/v1beta1/groups/list#google.apps.cloudidentity.groups.v1beta1.GroupsService.ListGroups).\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\nView\n----\n\nThe view options for the [GroupsService.ListGroups](/identity/docs/reference/rest/v1beta1/groups/list#google.apps.cloudidentity.groups.v1beta1.GroupsService.ListGroups) method."]]
