Must contain equality operators on the parent, e.g. parent ==
'customers/{customer_id}'. The customer_id must begin with "C" (for example, 'C046psxkn'). Find your customer ID.
Can contain optional inclusion operators on labels such as 'cloudidentity.googleapis.com/groups.discussion_forum' in labels).
Can contain an optional equality operator on domain_name. e.g. domain_name == 'examplepetstore.com'
Can contain optional startsWith/contains/equality operators on group_key, e.g. group_key.startsWith('dev'), group_key.contains('dev'), group_key == 'dev@examplepetstore.com'
Can contain optional startsWith/contains/equality operators on display_name, such as display_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 a next_page_token.
If unspecified, defaults to 200 for GroupView.BASIC and 50 for GroupView.FULL.
Must not be greater than 1000 for GroupView.BASIC or 500 for GroupView.FULL.
pageToken
string
The next_page_token value 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)."]]
