GoogleAdsGoogleadsV25Services__MutateAdGroupBidModifiersResponse

{
  "$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-ad-group-bid-modifiers-response-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateAdGroupBidModifiersResponse",
  "description": "Response message for ad group bid modifiers mutate.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-adgroupbidmodifiers-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateAdGroupBidModifiersResponse",
  "type": "object",
  "properties": {
    "partialFailureError": {
      "$ref": "#/$defs/GoogleRpc__Status",
      "description": "Errors that pertain to operation failures in the partial failure mode. Returned only when partial_failure = true and all errors occur inside the operations. If any errors occur outside the operations (for example, auth errors), we return an RPC level error."
    },
    "results": {
      "type": "array",
      "description": "All results for the mutate.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__MutateAdGroupBidModifierResult"
      }
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Common__DeviceInfo": {
      "description": "A device criterion.",
      "type": "object",
      "properties": {
        "type": {
          "x-enumDescriptions": [
            "Not specified.",
            "The value is unknown in this version.",
            "Mobile devices with full browsers.",
            "Tablets with full browsers.",
            "Computers.",
            "Smart TVs and game consoles.",
            "Other device types."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "MOBILE",
            "TABLET",
            "DESKTOP",
            "CONNECTED_TV",
            "OTHER"
          ],
          "description": "Type of the device.",
          "type": "string"
        }
      }
    },
    "GoogleAdsGoogleadsV25Common__HotelAdvanceBookingWindowInfo": {
      "description": "Criterion for number of days prior to the stay the booking is being made.",
      "type": "object",
      "properties": {
        "minDays": {
          "format": "int64",
          "type": "string",
          "description": "Low end of the number of days prior to the stay."
        },
        "maxDays": {
          "description": "High end of the number of days prior to the stay.",
          "type": "string",
          "format": "int64"
        }
      }
    },
    "GoogleAdsGoogleadsV25Common__HotelCheckInDateRangeInfo": {
      "type": "object",
      "properties": {
        "startDate": {
          "description": "Start date in the YYYY-MM-DD format.",
          "type": "string"
        },
        "endDate": {
          "description": "End date in the YYYY-MM-DD format.",
          "type": "string"
        }
      },
      "description": "Criterion for a check-in date range."
    },
    "GoogleAdsGoogleadsV25Common__HotelCheckInDayInfo": {
      "description": "Criterion for day of the week the booking is for.",
      "type": "object",
      "properties": {
        "dayOfWeek": {
          "type": "string",
          "description": "The day of the week.",
          "x-enumDescriptions": [
            "Not specified.",
            "The value is unknown in this version.",
            "Monday.",
            "Tuesday.",
            "Wednesday.",
            "Thursday.",
            "Friday.",
            "Saturday.",
            "Sunday."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY",
            "SATURDAY",
            "SUNDAY"
          ]
        }
      }
    },
    "GoogleAdsGoogleadsV25Common__HotelDateSelectionTypeInfo": {
      "type": "object",
      "properties": {
        "type": {
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Dates selected by default.",
            "Dates selected by the user."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "DEFAULT_SELECTION",
            "USER_SELECTED"
          ],
          "description": "Type of the hotel date selection",
          "type": "string"
        }
      },
      "description": "Criterion for hotel date selection (default dates versus user selected)."
    },
    "GoogleAdsGoogleadsV25Common__HotelLengthOfStayInfo": {
      "description": "Criterion for length of hotel stay in nights.",
      "type": "object",
      "properties": {
        "minNights": {
          "type": "string",
          "description": "Low end of the number of nights in the stay.",
          "format": "int64"
        },
        "maxNights": {
          "type": "string",
          "description": "High end of the number of nights in the stay.",
          "format": "int64"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources__AdGroupBidModifier": {
      "type": "object",
      "properties": {
        "bidModifierSource": {
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "The bid modifier is specified at the campaign level, on the campaign level criterion.",
            "The bid modifier is specified (overridden) at the ad group level."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "CAMPAIGN",
            "AD_GROUP"
          ],
          "description": "Output only. Bid modifier source.",
          "type": "string"
        },
        "adGroup": {
          "description": "Immutable. The ad group to which this criterion belongs.",
          "type": "string"
        },
        "resourceName": {
          "description": "Immutable. The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`",
          "type": "string"
        },
        "hotelDateSelectionType": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__HotelDateSelectionTypeInfo",
          "description": "Immutable. Criterion for hotel date selection (default dates versus user selected)."
        },
        "bidModifier": {
          "description": "The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Use 0 to opt out of a Device type.",
          "type": "number",
          "format": "double"
        },
        "baseAdGroup": {
          "description": "Output only. The base ad group from which this draft/trial adgroup bid modifier was created. If ad_group is a base ad group then this field will be equal to ad_group. If the ad group was created in the draft or trial and has no corresponding base ad group, then this field will be null. This field is readonly.",
          "type": "string"
        },
        "hotelCheckInDateRange": {
          "description": "Immutable. Criterion for a hotel check-in date range.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__HotelCheckInDateRangeInfo"
        },
        "hotelCheckInDay": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__HotelCheckInDayInfo",
          "description": "Immutable. Criterion for day of the week the booking is for."
        },
        "criterionId": {
          "description": "Output only. The ID of the criterion to bid modify. This field is ignored for mutates.",
          "type": "string",
          "format": "int64"
        },
        "hotelAdvanceBookingWindow": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__HotelAdvanceBookingWindowInfo",
          "description": "Immutable. Criterion for number of days prior to the stay the booking is being made."
        },
        "hotelLengthOfStay": {
          "description": "Immutable. Criterion for length of hotel stay in nights.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__HotelLengthOfStayInfo"
        },
        "device": {
          "description": "Immutable. A device criterion.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__DeviceInfo"
        }
      },
      "description": "Represents an ad group bid modifier."
    },
    "GoogleAdsGoogleadsV25Services__MutateAdGroupBidModifierResult": {
      "description": "The result for the criterion mutate.",
      "type": "object",
      "properties": {
        "resourceName": {
          "description": "Returned for successful operations.",
          "type": "string"
        },
        "adGroupBidModifier": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__AdGroupBidModifier",
          "description": "The mutated ad group bid modifier with only mutable fields after mutate. The field will only be returned when response_content_type is set to \"MUTABLE_RESOURCE\"."
        }
      }
    },
    "GoogleRpc__Status": {
      "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).",
      "type": "object",
      "properties": {
        "message": {
          "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.",
          "type": "string"
        },
        "code": {
          "type": "integer",
          "description": "The status code, which should be an enum value of google.rpc.Code.",
          "format": "int32"
        },
        "details": {
          "type": "array",
          "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.",
          "items": {
            "type": "object",
            "additionalProperties": {
              "description": "Properties of the object. Contains field @type with type URL."
            }
          }
        }
      }
    }
  }
}