--- title: "POST /v23/customers/{+customerId}/conversionValueRules:mutate" method: POST path: "/v23/customers/{+customerId}/conversionValueRules:mutate" tags: ["customers"] --- # POST /v23/customers/{+customerId}/conversionValueRules:mutate `POST /v23/customers/{+customerId}/conversionValueRules:mutate` Creates, updates, or removes conversion value rules. Operation statuses are returned. ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesMutateConversionValueRulesRequest — Request message for ConversionValueRuleService.MutateConversionValueRules. - `partialFailure` boolean — If true, successful operations will be carried out and invalid operations will return errors. If false, all operations will be carried out in one transaction if and only if they are all valid. Default is false. - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results. - `operations` GoogleAdsSearchads360V23ServicesConversionValueRuleOperation[] — Required. The list of operations to perform on individual conversion value rules. - `remove` string — Remove operation: A resource name for the removed conversion value rule is expected, in this format: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesConversionValueRule — A conversion value rule - `action` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAction — Action applied when rule is applied. - `value` number, double — Specifies applied value. - `operation` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'MULTIPLY' | 'SET' — Specifies applied operation. - `ownerCustomer` string — Output only. The resource name of the conversion value rule's owner customer. When the value rule is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `deviceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleDeviceCondition — Condition on Device dimension. - `deviceTypes` string[] — Value for device type condition. - `resourceName` string — Immutable. The resource name of the conversion value rule. Conversion value rule resource names have the form: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `id` string, int64 — Output only. The ID of the conversion value rule. - `audienceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAudienceCondition — Condition on Audience dimension. - `userLists` string[] — User Lists. - `userInterests` string[] — User Interests. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — The status of the conversion value rule. - `geoLocationCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleGeoLocationCondition — Condition on Geo dimension. - `excludedGeoTargetConstants` string[] — Geo locations that advertisers want to exclude. - `excludedGeoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Excluded Geo location match type. - `geoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Included Geo location match type. - `geoTargetConstants` string[] — Geo locations that advertisers want to include. - `itineraryCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryCondition — Condition on Itinerary dimension. - `advanceBookingWindow` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryAdvanceBookingWindow — Range for the number of days between the date of the booking and the start of the itinerary. - `minDays` integer — Minimum number of days between the date of the booking the start date. - `maxDays` integer — Maximum number of days between the date of the booking the start date. - `travelStartDay` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelStartDay — The days of the week on which an itinerary's travel can start. - `monday` boolean — The travel can start on Monday. - `tuesday` boolean — The travel can start on Tuesday. - `friday` boolean — The travel can start on Friday. - `wednesday` boolean — The travel can start on Wednesday. - `sunday` boolean — The travel can start on Sunday. - `thursday` boolean — The travel can start on Thursday. - `saturday` boolean — The travel can start on Saturday. - `travelLength` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelLength — Range for the itinerary length in number of nights. - `minNights` integer — Minimum number of nights between the start date and the end date. - `maxNights` integer — Maximum number of days between the start date and the end date. - `update` GoogleAdsSearchads360V23ResourcesConversionValueRule — A conversion value rule - `action` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAction — Action applied when rule is applied. - `value` number, double — Specifies applied value. - `operation` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'MULTIPLY' | 'SET' — Specifies applied operation. - `ownerCustomer` string — Output only. The resource name of the conversion value rule's owner customer. When the value rule is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `deviceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleDeviceCondition — Condition on Device dimension. - `deviceTypes` string[] — Value for device type condition. - `resourceName` string — Immutable. The resource name of the conversion value rule. Conversion value rule resource names have the form: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `id` string, int64 — Output only. The ID of the conversion value rule. - `audienceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAudienceCondition — Condition on Audience dimension. - `userLists` string[] — User Lists. - `userInterests` string[] — User Interests. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — The status of the conversion value rule. - `geoLocationCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleGeoLocationCondition — Condition on Geo dimension. - `excludedGeoTargetConstants` string[] — Geo locations that advertisers want to exclude. - `excludedGeoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Excluded Geo location match type. - `geoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Included Geo location match type. - `geoTargetConstants` string[] — Geo locations that advertisers want to include. - `itineraryCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryCondition — Condition on Itinerary dimension. - `advanceBookingWindow` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryAdvanceBookingWindow — Range for the number of days between the date of the booking and the start of the itinerary. - `minDays` integer — Minimum number of days between the date of the booking the start date. - `maxDays` integer — Maximum number of days between the date of the booking the start date. - `travelStartDay` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelStartDay — The days of the week on which an itinerary's travel can start. - `monday` boolean — The travel can start on Monday. - `tuesday` boolean — The travel can start on Tuesday. - `friday` boolean — The travel can start on Friday. - `wednesday` boolean — The travel can start on Wednesday. - `sunday` boolean — The travel can start on Sunday. - `thursday` boolean — The travel can start on Thursday. - `saturday` boolean — The travel can start on Saturday. - `travelLength` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelLength — Range for the itinerary length in number of nights. - `minNights` integer — Minimum number of nights between the start date and the end date. - `maxNights` integer — Maximum number of days between the start date and the end date. - `responseContentType` 'UNSPECIFIED' | 'RESOURCE_NAME_ONLY' | 'MUTABLE_RESOURCE' — The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)