- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Creates a Control.
If the Control to create already exists, an ALREADY_EXISTS error is returned.
HTTP request
POST https://retail.googleapis.com/v2/{parent=projects/*/locations/*/catalogs/*}/controls
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent |
Required. Full resource name of parent catalog. Format: |
Query parameters
| Parameters | |
|---|---|
controlId |
Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value should be 4-63 characters, and valid characters are /[a-z][0-9]-_/. |
Request body
The request body contains an instance of Control.
Response body
If successful, the response body contains a newly created instance of Control.
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.create
For more information, see the IAM documentation.