---
title: "POST /v23/customers/{+customerId}/adGroupBidModifiers:mutate"
method: POST
path: "/v23/customers/{+customerId}/adGroupBidModifiers:mutate"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}/adGroupBidModifiers:mutate

`POST /v23/customers/{+customerId}/adGroupBidModifiers:mutate`

Creates, updates, or removes ad group bid modifiers. Operation statuses are returned. List of thrown errors: [AdGroupBidModifierError]() [AuthenticationError]() [AuthorizationError]() [ContextError]() [CriterionError]() [DatabaseError]() [DistinctError]() [FieldError]() [FieldMaskError]() [HeaderError]() [IdError]() [InternalError]() [MutateError]() [NewResourceCreationError]() [NotEmptyError]() [OperatorError]() [QuotaError]() [RangeError]() [RequestError]() [ResourceCountLimitExceededError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateAdGroupBidModifiersRequest — Request message for AdGroupBidModifierService.MutateAdGroupBidModifiers.
  - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results.
  - `operations` GoogleAdsSearchads360V23ServicesAdGroupBidModifierOperation[] — Required. The list of operations to perform on individual ad group bid modifiers.
    - `remove` string — Remove operation: A resource name for the removed ad group bid modifier is expected, in this format: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`
    - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update.
    - `create` GoogleAdsSearchads360V23ResourcesAdGroupBidModifier — Represents an ad group bid modifier.
      - `hotelCheckInDateRange` GoogleAdsSearchads360V23CommonHotelCheckInDateRangeInfo — Criterion for a check-in date range.
        - `startDate` string — Start date in the YYYY-MM-DD format.
        - `endDate` string — End date in the YYYY-MM-DD format.
      - `criterionId` string, int64 — Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
      - `hotelAdvanceBookingWindow` GoogleAdsSearchads360V23CommonHotelAdvanceBookingWindowInfo — Criterion for number of days prior to the stay the booking is being made.
        - `minDays` string, int64 — Low end of the number of days prior to the stay.
        - `maxDays` string, int64 — High end of the number of days prior to the stay.
      - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion.
        - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device.
      - `baseAdGroup` string — 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.
      - `bidModifierSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN' | 'AD_GROUP' — Output only. Bid modifier source.
      - `hotelLengthOfStay` GoogleAdsSearchads360V23CommonHotelLengthOfStayInfo — Criterion for length of hotel stay in nights.
        - `minNights` string, int64 — Low end of the number of nights in the stay.
        - `maxNights` string, int64 — High end of the number of nights in the stay.
      - `resourceName` string — 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}`
      - `hotelDateSelectionType` GoogleAdsSearchads360V23CommonHotelDateSelectionTypeInfo — Criterion for hotel date selection (default dates versus user selected).
        - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT_SELECTION' | 'USER_SELECTED' — Type of the hotel date selection
      - `hotelCheckInDay` GoogleAdsSearchads360V23CommonHotelCheckInDayInfo — Criterion for day of the week the booking is for.
        - `dayOfWeek` 'UNSPECIFIED' | 'UNKNOWN' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week.
      - `adGroup` string — Immutable. The ad group to which this criterion belongs.
      - `bidModifier` number, double — 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.
    - `update` GoogleAdsSearchads360V23ResourcesAdGroupBidModifier — Represents an ad group bid modifier.
      - `hotelCheckInDateRange` GoogleAdsSearchads360V23CommonHotelCheckInDateRangeInfo — Criterion for a check-in date range.
        - `startDate` string — Start date in the YYYY-MM-DD format.
        - `endDate` string — End date in the YYYY-MM-DD format.
      - `criterionId` string, int64 — Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
      - `hotelAdvanceBookingWindow` GoogleAdsSearchads360V23CommonHotelAdvanceBookingWindowInfo — Criterion for number of days prior to the stay the booking is being made.
        - `minDays` string, int64 — Low end of the number of days prior to the stay.
        - `maxDays` string, int64 — High end of the number of days prior to the stay.
      - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion.
        - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device.
      - `baseAdGroup` string — 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.
      - `bidModifierSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN' | 'AD_GROUP' — Output only. Bid modifier source.
      - `hotelLengthOfStay` GoogleAdsSearchads360V23CommonHotelLengthOfStayInfo — Criterion for length of hotel stay in nights.
        - `minNights` string, int64 — Low end of the number of nights in the stay.
        - `maxNights` string, int64 — High end of the number of nights in the stay.
      - `resourceName` string — 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}`
      - `hotelDateSelectionType` GoogleAdsSearchads360V23CommonHotelDateSelectionTypeInfo — Criterion for hotel date selection (default dates versus user selected).
        - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT_SELECTION' | 'USER_SELECTED' — Type of the hotel date selection
      - `hotelCheckInDay` GoogleAdsSearchads360V23CommonHotelCheckInDayInfo — Criterion for day of the week the booking is for.
        - `dayOfWeek` 'UNSPECIFIED' | 'UNKNOWN' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week.
      - `adGroup` string — Immutable. The ad group to which this criterion belongs.
      - `bidModifier` number, double — 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.
  - `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.
  - `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.

## 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)