Must contain equality operators on the parent, e.g.parent ==
'customers/{customer_id}'. Thecustomer_idmust begin with "C" (for example, 'C046psxkn').Find your customer ID.
Can contain optional inclusion operators onlabelssuch as'cloudidentity.googleapis.com/groups.discussion_forum' in labels).
Can contain an optional equality operator ondomain_name. e.g.domain_name == 'examplepetstore.com'
Can contain optionalstartsWith/contains/equalityoperators ongroup_key, e.g.group_key.startsWith('dev'),group_key.contains('dev'), group_key == 'dev@examplepetstore.com'
Can contain optionalstartsWith/contains/equalityoperators ondisplay_name, such asdisplay_name.startsWith('dev'),display_name.contains('dev'),display_name == 'dev'
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 forGroupView.BASICand 50 forGroupView.FULL.
Must not be greater than 1000 forGroupView.BASICor 500 forGroupView.FULL.
pageToken
string
Thenext_page_tokenvalue returned from a previous search 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 allows searching for \u003ccode\u003eGroup\u003c/code\u003e resources using a \u003ccode\u003eGET\u003c/code\u003e request with specified query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe required \u003ccode\u003equery\u003c/code\u003e parameter uses Common Expression Language (CEL) and must include an equality operator on the \u003ccode\u003eparent\u003c/code\u003e, such as \u003ccode\u003eparent == 'customers/{customer_id}'\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional search operators are supported for \u003ccode\u003elabels\u003c/code\u003e, \u003ccode\u003edomain_name\u003c/code\u003e, \u003ccode\u003egroup_key\u003c/code\u003e, and \u003ccode\u003edisplay_name\u003c/code\u003e fields.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a list of \u003ccode\u003eGroup\u003c/code\u003e objects matching the query, along with a \u003ccode\u003enextPageToken\u003c/code\u003e for paginating through results.\u003c/p\u003e\n"],["\u003cp\u003eThe parameters \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003eview\u003c/code\u003e allow you to refine the search and control the results, such as maximum results and result detail.\u003c/p\u003e\n"]]],[],null,["# Method: groups.search\n\nSearches for `Group` resources matching a specified query.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/groups:search`\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.SearchGroups](/identity/docs/reference/rest/v1/groups/search#google.apps.cloudidentity.groups.v1.GroupsService.SearchGroups).\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)."]]
