Required. The parent resource under which to list allGroupresources.
Must be of the formidentitysources/{identity_source}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.
Request body
The request body must be empty.
Response body
Response message for groups.list operation.
If successful, the response body contains data with the following structure:
[[["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 lists \u003ccode\u003eGroup\u003c/code\u003e resources under a specified customer or namespace using a GET request to \u003ccode\u003ehttps://cloudidentity.googleapis.com/v1/groups\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e query parameter is required, specifying either an \u003ccode\u003eidentitysources/{identity_source}\u003c/code\u003e for external-identity-mapped groups or \u003ccode\u003ecustomers/{customer_id}\u003c/code\u003e for Google Groups.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the detail level of the returned information with the \u003ccode\u003eview\u003c/code\u003e query parameter and the number of results per page using the \u003ccode\u003epageSize\u003c/code\u003e parameter, with maximum limits enforced based on the chosen \u003ccode\u003eview\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a \u003ccode\u003egroups\u003c/code\u003e array containing the listed \u003ccode\u003eGroup\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e if additional pages of results are available.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires one of several OAuth scopes, including \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.groups.readonly\u003c/code\u003e and \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e, among others.\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/v1/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\nResponse message for groups.list operation.\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)."]]
