- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- CustomInterestOperation
- MutateCustomInterestResult
- Try it!
Creates or updates custom interests. Operation statuses are returned.
List of thrown errors: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError
HTTP request
POST https://googleads.googleapis.com/v16/customers/{customerId}/customInterests:mutate
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
customer |
Required. The ID of the customer whose custom interests are being modified. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"operations": [
{
object ( |
Fields | |
---|---|
operations[] |
Required. The list of operations to perform on individual custom interests. |
validate |
If true, the request is validated but not executed. Only errors are returned, not results. |
Response body
Response message for custom interest mutate.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"results": [
{
object ( |
Fields | |
---|---|
results[] |
All results for the mutate. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adwords
For more information, see the OAuth 2.0 Overview.
CustomInterestOperation
A single operation (create, update) on a custom interest.
JSON representation |
---|
{ "updateMask": string, // Union field |
Fields | |
---|---|
update |
FieldMask that determines which resource fields are modified in an update. This is a comma-separated list of fully qualified names of fields. Example: |
Union field operation . The mutate operation. operation can be only one of the following: |
|
create |
Create operation: No resource name is expected for the new custom interest. |
update |
Update operation: The custom interest is expected to have a valid resource name. |
MutateCustomInterestResult
The result for the custom interest mutate.
JSON representation |
---|
{ "resourceName": string } |
Fields | |
---|---|
resource |
Returned for successful operations. |