入札単価調整比で入札単価を調整する

Google Ads API を使用して、ホテル広告の入札単価調整(入札単価調整比とも呼ばれます)を設定できます。入札単価調整の仕組みについて詳しくは、ホテル広告の入札単価調整についてをご覧ください。

キャンペーン単位の入札単価調整

Google Ads API を使用してキャンペーン単位で入札単価調整を設定するには、入札単価調整比を管理するをご覧ください。

広告グループ単位の入札単価調整

v26 以降、AdGroupBidModifier の 5 つのホテル固有の条件は、業種に依存しない名前(利用開始日の曜日や予約期間など)に変更され、以前のバージョンのホテル固有の条件に置き換えられます。これらの入札単価調整は、ホテル広告(ホテル キャンペーンと旅行向け検索キャンペーンの両方)でのみ引き続きサポートされます。v25 以前で作成された既存の入札単価調整比は、同じ条件 ID とリソース名で自動的に引き継がれます。v26 の互換性を破る変更の概要については、リリースノートをご覧ください。

広告グループ単位で入札単価調整を設定するには、ターゲットとするディメンションの条件オブジェクトを作成し、そのフィールドに適切な値を設定します。v26 以降では、業種に依存しない条件オブジェクト(AdvanceBookingWindowInfo、UserSetDatesInfo、StartDayOfWeekInfo、LengthOfBookingInfo、StartDateRangeInfo)を使用します。v25 以前では、ホテル固有の条件オブジェクト(HotelAdvanceBookingWindowInfo、HotelDateSelectionTypeInfo、HotelCheckInDayInfo、HotelLengthOfStayInfo、HotelCheckInDateRangeInfo)を使用します。

次の表に、AdGroupBidModifier 条件フィールド、メッセージ タイプ、サブフィールド、API バージョン全体で有効な bid_modifier 範囲をまとめます。

v25 以前 v26 以降 サブフィールドと型 説明と有効な範囲
hotel_date_selection_type(HotelDateSelectionTypeInfo) user_set_dates(UserSetDatesInfo) type: v26 では DateSelectionType(v25 では HotelDateSelectionType)。値: DEFAULT_SELECTION(条件 ID 50)、USER_SELECTED(条件 ID 51)。IMMUTABLE。 デフォルトの日付とユーザーが選択した日付。有効な bid_modifier の範囲: 0.5~2.0(0 のオプトアウトはサポートされていません)。
hotel_advance_booking_window(HotelAdvanceBookingWindowInfo) advance_booking_window(AdvanceBookingWindowInfo) min_days、max_days(int64、0~330)。IMMUTABLE、必須。 予約の開始日までの日数。有効な bid_modifier の範囲: 0.1~10.0。オプトアウトする場合は 0。
hotel_length_of_stay(HotelLengthOfStayInfo) length_of_booking(LengthOfBookingInfo) min_days、max_days(v26 の場合。v25 の場合は min_nights、max_nights)(int64、1~30)。IMMUTABLE、必須。 予約期間。有効な bid_modifier の範囲: 0.1~10.0。オプトアウトする場合は 0。
hotel_check_in_day(HotelCheckInDayInfo) start_day_of_week(StartDayOfWeekInfo) day_of_week(DayOfWeek、MONDAY~SUNDAY の条件 ID 60~66)。IMMUTABLE。 予約開始日の曜日。有効な bid_modifier の範囲: 0.1~10.0。オプトアウトする場合は 0。
hotel_check_in_date_range(HotelCheckInDateRangeInfo) start_date_range(StartDateRangeInfo) start_date、end_date(string、YYYY-MM-DD)。IMMUTABLE、必須。 予約開始日の期間。有効な bid_modifier の範囲: 0.1~10.0。オプトアウトする場合は 0。

たとえば、v26 以降で 30 ~ 60 日の予約可能期間を使用して広告グループの入札単価調整比を作成するには、AdvanceBookingWindowInfo オブジェクト(v25 以前では HotelAdvanceBookingWindowInfo)を作成し、min_days を 30 に、max_days を 60 に設定します。

対応する条件フィールド(advance_booking_window、user_set_dates、start_day_of_week、length_of_booking、start_date_range)を使用して、条件オブジェクトを AdGroupBidModifier オブジェクトに関連付けます。ad_group を使用して、ターゲット広告グループのリソース名を指定し、bid_modifier フィールドを乗数に設定します。

  • advance_booking_window、length_of_booking、start_day_of_week、start_date_range、device: 0.1~10.0 の調整比を指定します(例: +50% の調整の場合は 1.5、-50% の調整の場合は 0.5)。または、bid_modifier を 0(0.0)に設定して、条件をオプトアウト(-100%)します。
  • user_set_dates: 0.5~2.0 の乗数を指定します。bid_modifier を 0 に設定することは user_set_dates ではサポートされておらず、RangeError.TOO_LOW が返されます。

各調整タイプの仕組みの詳細については、ホテル広告の入札単価調整についてをご覧ください。

v26 では、次のレポート セグメントとリソースの上限に関する詳細も適用されます。

  • segments.user_set_dates: v26 以降では、segments.user_set_dates の列挙型は DateSelectionType です(v25 以前の HotelDateSelectionType から更新。segments.hotel_date_selection_type を使用するホテル キャンペーン レポートでは引き続き HotelDateSelectionType が使用されます)。他の旅行プラン セグメント(segments.advance_booking_window、segments.length_of_booking、segments.start_date、segments.start_day_of_week)は変更されていません。
  • リソースの上限: ResourceLimitType.HOTEL_ADVANCE_BOOKING_WINDOW_BID_MODIFIERS_PER_AD_GROUP と ResourceLimitType.HOTEL_CHECK_IN_DATE_RANGE_BID_MODIFIERS_PER_AD_GROUP は、v26 で既存の名前を保持します。

Java

private void runExample(GoogleAdsClient googleAdsClient, long customerId, long adGroupId) {
  List<AdGroupBidModifierOperation> operations = new ArrayList<>();

  // Constructs the ad group resource name to use for each bid modifier.
  String adGroupResourceName = ResourceNames.adGroup(customerId, adGroupId);

  // 1) Creates an ad group bid modifier based on the hotel check-in day.
  AdGroupBidModifier checkInDayAdGroupBidModifier =
      AdGroupBidModifier.newBuilder()
          // Sets the resource name to the ad group resource name joined with the criterion ID
          // whose value corresponds to the desired check-in day.
          .setAdGroup(adGroupResourceName)
          .setStartDayOfWeek(StartDayOfWeekInfo.newBuilder().setDayOfWeek(DayOfWeek.MONDAY))
          // Sets the bid modifier value to 150%.
          .setBidModifier(1.5d)
          .build();
  operations.add(
      AdGroupBidModifierOperation.newBuilder().setCreate(checkInDayAdGroupBidModifier).build());

  // 2) Creates an ad group bid modifier based on the hotel length of stay.
  AdGroupBidModifier lengthOfStayAdGroupBidModifier =
      AdGroupBidModifier.newBuilder()
          // Sets the ad group.
          .setAdGroup(adGroupResourceName)
          // Creates the length of booking info.
          .setLengthOfBooking(
              LengthOfBookingInfo.newBuilder().setMinDays(3L).setMaxDays(7L).build())
          // Sets the bid modifier value to 170%.
          .setBidModifier(1.7d)
          .build();
  operations.add(
      AdGroupBidModifierOperation.newBuilder().setCreate(lengthOfStayAdGroupBidModifier).build());

  // Issues a mutate request to add the ad group bid modifiers.
  try (AdGroupBidModifierServiceClient adGroupBidModifierServiceClient =
      googleAdsClient.getLatestVersion().createAdGroupBidModifierServiceClient()) {
    MutateAdGroupBidModifiersResponse response =
        adGroupBidModifierServiceClient.mutateAdGroupBidModifiers(
            Long.toString(customerId), operations);

    // Prints the resource names of the added ad group bid modifiers.
    System.out.printf("Added %d hotel ad group bid modifiers:%n", response.getResultsCount());
    for (MutateAdGroupBidModifierResult mutateAdGroupBidModifierResult :
        response.getResultsList()) {
      System.out.printf("  %s%n", mutateAdGroupBidModifierResult.getResourceName());
    }
  }
}
      

C#

public void Run(GoogleAdsClient client, long customerId, long adGroupId)
{
    // Get the AdGroupBidModifierService.
    AdGroupBidModifierServiceClient service = client.GetService(
        Services.V26.AdGroupBidModifierService);

    // Constructs the ad group resource name to use for each bid modifier.
    string adGroupResourceName = ResourceNames.AdGroup(customerId, adGroupId);

    // 1) Create an ad group bid modifier based on the hotel check-in day.
    AdGroupBidModifier checkInDayAdGroupBidModifier = new AdGroupBidModifier()
    {
        // Sets the resource name to the ad group resource name joined with the criterion
        // ID whose value corresponds to the desired check-in day.
        AdGroup = adGroupResourceName,
        StartDayOfWeek = new StartDayOfWeekInfo()
        {
            DayOfWeek = DayOfWeek.Monday
        },

        // Set the bid modifier value to 150%.
        BidModifier = 1.5,
    };

    // Creates an ad group bid modifier operation.
    var checkInDayAdGroupBidModifierOperation = new AdGroupBidModifierOperation()
    {
        Create = checkInDayAdGroupBidModifier
    };

    // 2) Create an ad group bid modifier based on the hotel length of stay.
    AdGroupBidModifier lengthOfStayAdGroupBidModifier = new AdGroupBidModifier()
    {
        // Set the ad group.
        AdGroup = ResourceNames.AdGroup(customerId, adGroupId),

        // Set the length of booking info.
        LengthOfBooking = new LengthOfBookingInfo()
        {
            MinDays = 3,
            MaxDays = 7
        },

        // Set the bid modifier value to 170%.
        BidModifier = 1.7
    };

    // Create an ad group bid modifier operation.
    var lengthOfStayAdGroupBidModifierOperation = new AdGroupBidModifierOperation()
    {
        Create = lengthOfStayAdGroupBidModifier
    };

    try
    {
        // Issue a mutate request to add an ad group bid modifiers.
        MutateAdGroupBidModifiersResponse response = service.MutateAdGroupBidModifiers(
            customerId.ToString(),
            new AdGroupBidModifierOperation[] {
      checkInDayAdGroupBidModifierOperation,
      lengthOfStayAdGroupBidModifierOperation
            }
        );

        // Display the resource names of the added ad group bid modifiers.
        Console.WriteLine($"Added {response.Results.Count} hotel ad group bid modifiers:");

        foreach (MutateAdGroupBidModifierResult result in response.Results)
        {
            Console.WriteLine($"- {result.ResourceName}");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
      

PHP

    public static function runExample(
        GoogleAdsClient $googleAdsClient,
        int $customerId,
        int $adGroupId
    ) {
        $operations = [];

        // 1) Creates an ad group bid modifier based on the hotel check-in day.
        $checkInDayAdGroupBidModifier = new AdGroupBidModifier(
            [
            // Sets the ad group.
            'ad_group' => ResourceNames::forAdGroup($customerId, $adGroupId),
            'hotel_check_in_day' => new HotelCheckInDayInfo(
                [
                'day_of_week' => DayOfWeek::MONDAY
                ]
            ),
            // Sets the bid modifier value to 150%.
            'bid_modifier' => 1.5
            ]
        );

        // Creates an ad group bid modifier operation.
        $checkInDayAdGroupBidModifierOperation = new AdGroupBidModifierOperation();
        $checkInDayAdGroupBidModifierOperation->setCreate($checkInDayAdGroupBidModifier);
        $operations[] = $checkInDayAdGroupBidModifierOperation;

        // 2) Creates an ad group bid modifier based on the hotel length of stay.
        $lengthOfStayAdGroupBidModifier = new AdGroupBidModifier(
            [
            // Sets the ad group.
            'ad_group' => ResourceNames::forAdGroup($customerId, $adGroupId),
            // Creates the hotel length of stay info.
            'hotel_length_of_stay' => new HotelLengthOfStayInfo(
                [
                'min_nights' => 3,
                'max_nights' => 7,
                ]
            ),
            // Sets the bid modifier value to 170%.
            'bid_modifier' => 1.7
            ]
        );

        // Creates an ad group bid modifier operation.
        $lengthOfStayAdGroupBidModifierOperation = new AdGroupBidModifierOperation();
        $lengthOfStayAdGroupBidModifierOperation->setCreate(
            $lengthOfStayAdGroupBidModifier
        );
        $operations[] = $lengthOfStayAdGroupBidModifierOperation;

        // Issues a mutate request to add an ad group bid modifiers.
        $adGroupBidModifierServiceClient = $googleAdsClient->getAdGroupBidModifierServiceClient();
        $response = $adGroupBidModifierServiceClient->mutateAdGroupBidModifiers(
            MutateAdGroupBidModifiersRequest::build($customerId, $operations)
        );

        // Print out resource names of the added ad group bid modifiers.
        printf(
            "Added %d hotel ad group bid modifiers:%s",
            $response->getResults()->count(),
            PHP_EOL
        );
        foreach ($response->getResults() as $addedAdGroupBidModifier) {
            /**
 * @var AdGroupBidModifier $addedAdGroupBidModifier
*/
            print $addedAdGroupBidModifier->getResourceName() . PHP_EOL;
        }
    }
      

Python

def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str) -> None:
    ad_group_service: AdGroupServiceClient = client.get_service(
        "AdGroupService"
    )
    ag_bm_service: AdGroupBidModifierServiceClient = client.get_service(
        "AdGroupBidModifierService"
    )

    # Create ad group bid modifier based on hotel check-in day.
    check_in_ag_bm_operation: AdGroupBidModifierOperation = client.get_type(
        "AdGroupBidModifierOperation"
    )
    check_in_ag_bid_modifier: AdGroupBidModifier = (
        check_in_ag_bm_operation.create
    )
    check_in_ag_bid_modifier.hotel_check_in_day.day_of_week = (
        client.enums.DayOfWeekEnum.MONDAY
    )
    check_in_ag_bid_modifier.ad_group = ad_group_service.ad_group_path(
        customer_id, ad_group_id
    )
    # Sets the bid modifier value to 150%.
    check_in_ag_bid_modifier.bid_modifier = 1.5

    # Create ad group bid modifier based on hotel length of stay info.
    los_ag_bm_operation: AdGroupBidModifierOperation = client.get_type(
        "AdGroupBidModifierOperation"
    )
    los_ag_bid_modifier: AdGroupBidModifier = los_ag_bm_operation.create
    los_ag_bid_modifier.ad_group = ad_group_service.ad_group_path(
        customer_id, ad_group_id
    )
    # Creates the hotel length of stay info.
    hotel_length_of_stay_info: HotelLengthOfStayInfo = (
        los_ag_bid_modifier.hotel_length_of_stay
    )
    hotel_length_of_stay_info.min_nights = 3
    hotel_length_of_stay_info.max_nights = 7
    # Sets the bid modifier value to 170%.
    los_ag_bid_modifier.bid_modifier = 1.7

    # Add the bid modifiers
    ag_bm_response: MutateAdGroupBidModifiersResponse = (
        ag_bm_service.mutate_ad_group_bid_modifiers(
            customer_id=customer_id,
            operations=[check_in_ag_bm_operation, los_ag_bm_operation],
        )
    )

    # Print out resource names of the added ad group bid modifiers.
    print(f"Added {len(ag_bm_response.results)} hotel ad group bid modifiers:")

    result: MutateAdGroupBidModifierResult
    for result in ag_bm_response.results:
        print(result.resource_name)
      

Ruby

def add_hotel_ad_group_bid_modifiers(customer_id, ad_group_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new
  operations = []
  ad_group_resource = client.path.ad_group(customer_id, ad_group_id)

  # 1) Creates an ad group bid modifier based on the check-in day.
  operations << client.operation.create_resource.ad_group_bid_modifier do |bm|
    # Sets the ad group.
    bm.ad_group = ad_group_resource

    # Sets the check-in day to Monday.
    bm.start_day_of_week = client.resource.start_day_of_week_info do |info|
      info.day_of_week = :MONDAY
    end

    # Sets the bid modifier value to 150%.
    bm.bid_modifier = 1.5
  end

  # 2) Creates an ad group bid modifier based on the length of booking.
  operations << client.operation.create_resource.ad_group_bid_modifier do |bm|
    # Sets the ad group.
    bm.ad_group = ad_group_resource

    # Creates the length of booking info.
    bm.length_of_booking = client.resource.length_of_booking_info do |info|
      info.min_days = 3
      info.max_days = 7
    end

    # Sets the bid modifier value to 170%.
    bm.bid_modifier = 1.7
  end

  # 3) Issues a mutate request to add an ad group bid modifiers.
  ad_group_bid_modifier_service = client.service.ad_group_bid_modifier
  response = ad_group_bid_modifier_service.mutate_ad_group_bid_modifiers(
    customer_id: customer_id,
    operations: operations,
  )

  # Print out resource names of the added ad group bid modifiers.
  puts "Added #{response.results.size} hotel ad group bid modifiers:"
  response.results.each do |added_ad_group_bid_modifier|
    puts "\t#{added_ad_group_bid_modifier.resource_name}"
  end
end
      

Perl

sub add_hotel_ad_group_bid_modifiers {
  my ($api_client, $customer_id, $ad_group_id) = @_;

  # 1) Create an ad group bid modifier based on the hotel check-in day.
  my $check_in_day_ad_group_bid_modifier =
    Google::Ads::GoogleAds::V26::Resources::AdGroupBidModifier->new({
      # Set the ad group.
      adGroup => Google::Ads::GoogleAds::V26::Utils::ResourceNames::ad_group(
        $customer_id, $ad_group_id
      ),
      hotelCheckInDay =>
        Google::Ads::GoogleAds::V26::Common::HotelCheckInDayInfo->new({
          dayOfWeek => MONDAY
        }
        ),
      # Set the bid modifier value to 150%.
      bidModifier => 1.5
    });

  # Create an ad group bid modifier operation.
  my $check_in_day_ad_group_bid_modifier_operation =
    Google::Ads::GoogleAds::V26::Services::AdGroupBidModifierService::AdGroupBidModifierOperation
    ->new({
      create => $check_in_day_ad_group_bid_modifier
    });

  # 2) Create an ad group bid modifier based on the hotel length of stay.
  my $length_of_stay_ad_group_bid_modifier =
    Google::Ads::GoogleAds::V26::Resources::AdGroupBidModifier->new({
      # Set the ad group.
      adGroup => Google::Ads::GoogleAds::V26::Utils::ResourceNames::ad_group(
        $customer_id, $ad_group_id
      ),
      # Create the hotel length of stay info.
      hotelLengthOfStay =>
        Google::Ads::GoogleAds::V26::Common::HotelLengthOfStayInfo->new({
          minNights => 3,
          maxNights => 7
        }
        ),
      # Set the bid modifier value to 170%.
      bidModifier => 1.7
    });

  # Create an ad group bid modifier operation.
  my $length_of_stay_ad_group_bid_modifier_operation =
    Google::Ads::GoogleAds::V26::Services::AdGroupBidModifierService::AdGroupBidModifierOperation
    ->new({
      create => $length_of_stay_ad_group_bid_modifier
    });

  # 3) Add the ad group bid modifiers.
  my $ad_group_bid_modifiers_response =
    $api_client->AdGroupBidModifierService()->mutate({
      customerId => $customer_id,
      operations => [
        $check_in_day_ad_group_bid_modifier_operation,
        $length_of_stay_ad_group_bid_modifier_operation
      ]});

  # Print out resource names of the added ad group bid modifiers.
  my $ad_group_bid_modifier_results =
    $ad_group_bid_modifiers_response->{results};
  printf "Added %d hotel ad group bid modifiers:\n",
    scalar @$ad_group_bid_modifier_results;

  foreach my $ad_group_bid_modifier_result (@$ad_group_bid_modifier_results) {
    printf "\t%s\n", $ad_group_bid_modifier_result->{resourceName};
  }

  return 1;
}
      

curl

例

次の例は、GAQL と REST JSON ペイロードを使用して、広告グループの単価調整比をクエリ、作成、更新、削除する方法を示しています。

GAQL を使用した入札単価調整比の読み取り

次のクエリは、v25 以前と v26 以降で、予約期間の入札単価調整比を取得する方法を示しています。

v25 以前:

SELECT
  ad_group_bid_modifier.resource_name,
  ad_group_bid_modifier.bid_modifier,
  ad_group_bid_modifier.hotel_length_of_stay.min_nights,
  ad_group_bid_modifier.hotel_length_of_stay.max_nights
FROM ad_group_bid_modifier
WHERE ad_group_bid_modifier.hotel_length_of_stay.min_nights = 5

v26 以降:

SELECT
  ad_group_bid_modifier.resource_name,
  ad_group_bid_modifier.bid_modifier,
  ad_group_bid_modifier.length_of_booking.min_days,
  ad_group_bid_modifier.length_of_booking.max_days
FROM ad_group_bid_modifier
WHERE ad_group_bid_modifier.length_of_booking.min_days = 5

入札単価調整比の作成(JSON ペイロード)

次の JSON ペイロードは、v26 以降で広告グループの入札単価調整比を作成する方法を示しています。

v26 で宿泊日数に応じた入札単価調整比を作成する:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "bidModifier": 1.2,
        "lengthOfBooking": {
          "minDays": "3",
          "maxDays": "5"
        }
      }
    }
  ]
}

v25 以前では、minNights と maxNights を指定した hotelLengthOfStay が使用されていました。

v26 で開始日範囲の入札単価調整比を作成する:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "bidModifier": 1.5,
        "startDateRange": {
          "startDate": "2026-12-20",
          "endDate": "2026-12-31"
        }
      }
    }
  ]
}

v26 でユーザー設定の日付の入札単価調整比を作成する:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "bidModifier": 1.3,
        "userSetDates": {
          "type": "USER_SELECTED"
        }
      }
    }
  ]
}

入札単価調整比の更新と削除

既存の入札単価調整比の乗数を更新するか、入札単価調整比を完全に削除できます。

  • 更新: 基準フィールドは IMMUTABLE です。入札単価調整比を変更するには、updateMask(protobuf では update_mask)を "bidModifier"("bid_modifier")に設定し、bidModifier(bid_modifier)を有効な値(advance_booking_window、length_of_booking、start_day_of_week、start_date_range、device の場合は 0.1~10.0、またはオプトアウトする場合は 0、user_set_dates の場合は 0.5~2.0)に設定して、update オペレーションを送信します。ターゲティング条件を変更するには、入札単価調整比を削除して、新しい入札単価調整比を作成します。
  • 削除: リソース名を指定して remove オペレーションを送信します。
{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupBidModifiers/987654321~555444333"
    }
  ]
}

検証ルールとエラー処理

検証ルールはバージョン間で同じですが、次の表に示すように、v26 では 6 つの CriterionError 列挙値の名前が変更されています。

シナリオ v25 以前 v26 以降
予約期間の範囲が既存の条件と重複しています HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION
予約可能期間の範囲が既存の条件と重複しています HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
開始日の範囲が既存の条件と重複しています HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
昨日より start_date 早い(UTC) HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_START_DATE_TOO_EARLY
end_date が 330 日以上先(UTC) HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_END_DATE_TOO_LATE
start_date end_date 出発 HOTEL_CHECK_IN_DATE_RANGE_REVERSED START_DATE_RANGE_REVERSED

次の検証エラーは、すべての API バージョンに適用されます。

  • FieldError.REQUIRED: 必要な範囲境界がありません(min_days または max_days のない advance_booking_window など)。
  • RangeError.TOO_HIGH / RangeError.TOO_LOW: 値が範囲外です。たとえば、advance_booking_window.max_days が 330 より大きい、min_days が advance_booking_window または length_of_booking の max_days より大きい、bid_modifier が advance_booking_window、length_of_booking、start_day_of_week、start_date_range の 0.1~10.0 の範囲外、bid_modifier が user_set_dates の 0.5~2.0(0 を含む)の範囲外です。
  • ResourceCountLimitExceededError.RESOURCE_LIMIT: 広告グループの入札単価調整比が、広告グループあたりの上限を超えています。
  • MutateError.INCONSISTENT_FIELD_VALUES: 固定 ID 列挙型サブフィールド(user_set_dates.type、start_day_of_week.day_of_week、device.type など)が、resource_name で指定された条件 ID と一致しません。
  • ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT: サポートされていないキャンペーン タイプまたは対象外の検索キャンペーンに旅行の入札単価調整比を追加しようとしています。