- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Lists all Controls by their parent Catalog
.
HTTP request
GET https://retail.googleapis.com/v2/{parent=projects/*/locations/*/catalogs/*}/controls
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
Required. The catalog resource name. Format: |
Query parameters
pageSize
integer
Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
pageToken
string
Optional. A page token, received from a previous controls.list
call. Provide this to retrieve the subsequent page.
filter
string
Optional. A filter to apply on the list results. Supported features:
- List all the products under the parent branch if
filteris unset. - List controls that are used in a single ServingConfig: 'servingConfig = "boosted_home_page_cvr"'
Request body
The request body must be empty.
Response body
Response for controls.list method.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"controls"
:
[
{
object (
|
| Fields | |
|---|---|
controls[]
|
All the Controls for a given catalog. |
nextPageToken
|
Pagination token, if not returned indicates the last page. |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
IAM Permissions
Requires the following IAM
permission on the parent
resource:
-
retail.controls.list
For more information, see the IAM documentation .

