GoogleAdsGoogleadsV25Services__MutateConversionValueRulesRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-mutate-conversion-value-rules-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateConversionValueRulesRequest",
  "description": "Request message for ConversionValueRuleService.MutateConversionValueRules.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-conversionvaluerules-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateConversionValueRulesRequest",
  "type": "object",
  "properties": {
    "partialFailure": {
      "type": "boolean",
      "description": "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."
    },
    "operations": {
      "type": "array",
      "description": "Required. The list of operations to perform on individual conversion value rules.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__ConversionValueRuleOperation"
      }
    },
    "validateOnly": {
      "description": "If true, the request is validated but not executed. Only errors are returned, not results.",
      "type": "boolean"
    },
    "responseContentType": {
      "x-enumDescriptions": [
        "Not specified. Will return the resource name only in the response.",
        "The mutate response will be the resource name.",
        "The mutate response will contain the resource name and the resource with mutable fields if possible. Otherwise, only the resource name will be returned."
      ],
      "enum": [
        "UNSPECIFIED",
        "RESOURCE_NAME_ONLY",
        "MUTABLE_RESOURCE"
      ],
      "description": "The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation.",
      "type": "string"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleAction": {
      "type": "object",
      "properties": {
        "value": {
          "type": "number",
          "description": "Specifies applied value.",
          "format": "double"
        },
        "operation": {
          "type": "string",
          "description": "Specifies applied operation.",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Add provided value to conversion value.",
            "Multiply conversion value by provided value.",
            "Set conversion value to provided value."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ADD",
            "MULTIPLY",
            "SET"
          ]
        }
      },
      "description": "Action applied when rule is applied."
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleAudienceCondition": {
      "type": "object",
      "properties": {
        "userLists": {
          "description": "User Lists.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "userInterests": {
          "type": "array",
          "description": "User Interests.",
          "items": {
            "type": "string"
          }
        }
      },
      "description": "Condition on Audience dimension."
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleDeviceCondition": {
      "description": "Condition on Device dimension.",
      "type": "object",
      "properties": {
        "deviceTypes": {
          "description": "Value for device type condition.",
          "items": {
            "type": "string",
            "x-enumDescriptions": [
              "Not specified.",
              "Used for return value only. Represents value unknown in this version.",
              "Mobile device.",
              "Desktop device.",
              "Tablet device."
            ],
            "enum": [
              "UNSPECIFIED",
              "UNKNOWN",
              "MOBILE",
              "DESKTOP",
              "TABLET"
            ]
          },
          "type": "array"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleGeoLocationCondition": {
      "description": "Condition on Geo dimension.",
      "type": "object",
      "properties": {
        "excludedGeoTargetConstants": {
          "type": "array",
          "description": "Geo locations that advertisers want to exclude.",
          "items": {
            "type": "string"
          }
        },
        "geoMatchType": {
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Either Area of Interest or Location of Presence can be used to match.",
            "Only Location of Presence can be used to match."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ANY",
            "LOCATION_OF_PRESENCE"
          ],
          "description": "Included Geo location match type.",
          "type": "string"
        },
        "geoTargetConstants": {
          "type": "array",
          "description": "Geo locations that advertisers want to include.",
          "items": {
            "type": "string"
          }
        },
        "excludedGeoMatchType": {
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Either Area of Interest or Location of Presence can be used to match.",
            "Only Location of Presence can be used to match."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ANY",
            "LOCATION_OF_PRESENCE"
          ],
          "description": "Excluded Geo location match type.",
          "type": "string"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryAdvanceBookingWindow": {
      "description": "Range for the number of days between the date of the booking and the start of the itinerary.",
      "type": "object",
      "properties": {
        "minDays": {
          "description": "Minimum number of days between the date of the booking the start date.",
          "type": "integer",
          "format": "int32"
        },
        "maxDays": {
          "type": "integer",
          "description": "Maximum number of days between the date of the booking the start date.",
          "format": "int32"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryCondition": {
      "type": "object",
      "properties": {
        "travelLength": {
          "description": "Range for the itinerary length in number of nights.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryTravelLength"
        },
        "advanceBookingWindow": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryAdvanceBookingWindow",
          "description": "Range for the number of days between the date of the booking and the start of the itinerary."
        },
        "travelStartDay": {
          "description": "The days of the week on which this itinerary's travel can start.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryTravelStartDay"
        }
      },
      "description": "Condition on Itinerary dimension."
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryTravelLength": {
      "description": "Range for the itinerary length in number of nights.",
      "type": "object",
      "properties": {
        "maxNights": {
          "description": "Maximum number of days between the start date and the end date.",
          "type": "integer",
          "format": "int32"
        },
        "minNights": {
          "description": "Minimum number of nights between the start date and the end date.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryTravelStartDay": {
      "type": "object",
      "properties": {
        "sunday": {
          "description": "The travel can start on Sunday.",
          "type": "boolean"
        },
        "wednesday": {
          "description": "The travel can start on Wednesday.",
          "type": "boolean"
        },
        "saturday": {
          "type": "boolean",
          "description": "The travel can start on Saturday."
        },
        "friday": {
          "description": "The travel can start on Friday.",
          "type": "boolean"
        },
        "tuesday": {
          "description": "The travel can start on Tuesday.",
          "type": "boolean"
        },
        "thursday": {
          "description": "The travel can start on Thursday.",
          "type": "boolean"
        },
        "monday": {
          "description": "The travel can start on Monday.",
          "type": "boolean"
        }
      },
      "description": "The days of the week on which an itinerary's travel can start."
    },
    "GoogleAdsGoogleadsV25Resources__ConversionValueRule": {
      "description": "A conversion value rule",
      "type": "object",
      "properties": {
        "audienceCondition": {
          "description": "Condition for audience that must be satisfied for the value rule to apply.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleAudienceCondition"
        },
        "itineraryCondition": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleItineraryCondition",
          "description": "Condition for itinerary that must be satisfied for the value rule to apply."
        },
        "action": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleAction",
          "description": "Action applied when the rule is triggered."
        },
        "id": {
          "type": "string",
          "description": "Output only. The ID of the conversion value rule.",
          "format": "int64"
        },
        "status": {
          "description": "The status of the conversion value rule.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Conversion Value Rule is enabled and can be applied.",
            "Conversion Value Rule is permanently deleted and can't be applied.",
            "Conversion Value Rule is paused, but can be re-enabled."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ENABLED",
            "REMOVED",
            "PAUSED"
          ]
        },
        "geoLocationCondition": {
          "description": "Condition for Geo location that must be satisfied for the value rule to apply.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleGeoLocationCondition"
        },
        "deviceCondition": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_ConversionValueRule_ValueRuleDeviceCondition",
          "description": "Condition for device type that must be satisfied for the value rule to apply."
        },
        "resourceName": {
          "description": "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}`",
          "type": "string"
        },
        "ownerCustomer": {
          "description": "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 **",
          "type": "string"
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__ConversionValueRuleOperation": {
      "description": "A single operation (create, update, remove) on a conversion value rule.",
      "type": "object",
      "properties": {
        "update": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__ConversionValueRule",
          "description": "Update operation: The conversion value rule is expected to have a valid resource name."
        },
        "updateMask": {
          "description": "FieldMask that determines which resource fields are modified in an update.",
          "type": "string",
          "format": "google-fieldmask"
        },
        "create": {
          "description": "Create operation: No resource name is expected for the new conversion value rule.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__ConversionValueRule"
        },
        "remove": {
          "description": "Remove operation: A resource name for the removed conversion value rule is expected, in this format: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}`",
          "type": "string"
        }
      }
    }
  }
}