Optional. The maximum number of results to return. The service can return fewer than this number. If omitted or set to 0, the default is 50 results per page. The maximum allowed value is 100.pageSizevalues greater than 100 default to 100.
pageToken
string
Optional. The pagination token received from a prior call to PoliciesService.ListPolicies to retrieve the next page of results. When paginating, all other parameters provided toListPoliciesRequestmust match the call that provided the page token.
filter
string
Optional. A CEL expression for filtering the results.
Policies can be filtered by application with this expression: setting.type.matches('^settings/gmail\..*$') Policies can be filtered by setting type with this expression: setting.type.matches('^.*\.service_status$') A maximum of one of the above setting.type clauses can be used.
Policies can be filtered by customer with this expression: customer == "customers/{customer}" Wherecustomeris theidfrom theAdmin SDKCustomerresource. You may usecustomers/my_customerto specify your own organization. When no customer is mentioned it will be default to customers/my_customer. A maximum of one customer clause can be used.
The above clauses can only be combined together in a single filter expression with the&&operator.
[[["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 endpoint retrieves a list of policies via an HTTP GET request to \u003ccode\u003ehttps://cloudidentity.googleapis.com/v1/policies\u003c/code\u003e, supporting gRPC Transcoding.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003epageSize\u003c/code\u003e (default 50, max 100) and \u003ccode\u003epageToken\u003c/code\u003e can be used to manage pagination of results, and \u003ccode\u003efilter\u003c/code\u003e can be used to narrow down results based on specific criteria, such as setting type or customer.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of policy objects within the \u003ccode\u003epolicies\u003c/code\u003e field, along with a \u003ccode\u003enextPageToken\u003c/code\u003e string if there are more results to fetch.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires one of two OAuth scopes, either \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.policies.readonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.policies\u003c/code\u003e, for proper authorization.\u003c/p\u003e\n"]]],[],null,["# Method: policies.list\n\nList Policies\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/policies`\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 [PoliciesService.ListPolicies](/identity/docs/reference/rest/v1/policies/list#google.apps.cloudidentity.policies.v1.PoliciesService.ListPolicies).\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.policies.readonly`\n- `https://www.googleapis.com/auth/cloud-identity.policies`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
