Merchant Promotions API 관련 문제 해결

이 페이지에서는 Merchant Promotions API와 관련된 문제를 해결하는 방법을 설명합니다.

프로모션 만들기

accounts.promotions.insert 요청을 사용하여 프로모션을 삽입할 때는 요청 본문에 모든 필수 입력란을 포함해야 합니다. 다음 입력란은 필수입니다.

  • promotion.promotionId
  • promotion.contentLanguage
  • promotion.redemptionChannel
  • promotion.targetCountry
  • promotion.attributes.longTitle
  • promotion.attributes.promotionEffectiveTimePeriod.startTime
  • promotion.attributes.promotionEffectiveTimePeriod.endTime
  • promotion.attributes.promotionDestinations
  • promotion.attributes.couponValueType
  • promotion.attributes.offerType
  • promotion.attributes.productApplicability
  • promotion.attributes.promotionUrl

프로모션 기간이 잘못됨

accounts.promotions.insert 요청에 잘못된 프로모션 효력 날짜를 입력하면 다음과 같은 오류 메시지가 표시됩니다.

Invalid value at 'promotion.attributes.promotion_effective_time_period.start_time'

이 오류를 해결하려면 promotionDisplayTimePeriod.startTime 필드에 제공된 값이 promotionEffectiveTimePeriod.startTime 필드에 제공된 값과 동일하거나 그보다 이전인지 확인합니다. 또한 promotionDisplayTimePeriod.endTime 필드에 제공된 값이 promotionEffectiveTimePeriod.endTime 필드에 제공된 값과 동일하거나 그보다 이전인지 확인합니다.

startTime 및 endTime 필드의 값은 RFC3339 UTC 형식(yyyy-mm-ddThh:mm:ssZ)이어야 합니다. 예: 2024-08-15T18:20:20Z

최소 구매 수량이 지정되지 않음

attributes.couponValueType가 BUY_M_GET_N_PERCENT_OFF 또는 BUY_M_GET_N_MONEY_OFF인 경우 accounts.promotions.insert 요청에 attributes.minimumPurchaseQuantity 필드의 값을 제공해야 합니다.

accounts.promotions.insert 요청에서 attributes.minimumPurchaseQuantity 필드의 값을 제공하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

이 오류를 해결하려면 요청에 minimumPurchaseQuantity 필드의 값을 제공해야 합니다.

할인 금액이 지정되지 않음

attributes.couponValueType 필드의 값이 MONEY_OFF인 경우 accounts.promotions.insert 요청에 attributes.moneyOffAmount 필드의 값을 제공해야 합니다.

accounts.promotions.insert 요청에서 attributes.moneyOffAmount 필드의 값을 제공하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

[moneyOffAmount] Missing benefit or restriction attributes for its type

이 오류를 해결하려면 요청에 attributes.moneyOffAmount 필드의 값을 제공해야 합니다. 금액은 마이크로 단위여야 합니다.

사은품 설명이 지정되지 않음

attributes.couponValueType 필드의 값이 FREE_GIFT인 경우 accounts.promotions.insert 요청에 attributes.freeGiftDescription 필드의 값을 제공해야 합니다.

accounts.promotions.insert 요청에서 attributes.freeGiftDescription 필드의 값을 제공하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

[freeGiftDescription] Missing benefit or restriction attributes for its type

이 오류를 해결하려면 요청에 attributes.freeGiftDescription 필드의 값을 제공해야 합니다.

오프라인 프로모션에는 무료 배송이 지원되지 않음

redemptionChannel 필드의 값이 IN_STORE이고 attributes.couponValueType 필드의 값이 FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT 또는 FREE_SHIPPING_TWO_DAY인 경우 다음과 같은 오류 메시지가 표시됩니다.

[shippingServiceNames] Free shipping types are not supported for local promotions

이 오류를 해결하려면 redemptionChannel 필드의 값이 ONLINE인지 확인합니다.

사용 채널이 지정되지 않음

accounts.promotions.insert 요청에 redemptionChannel 필드의 값이 지정되지 않으면 다음 오류 메시지가 표시됩니다.

[redemptionChannel] Required parameter: redemptionChannel

이 오류를 해결하려면 요청에 redemptionChannel 필드의 값을 제공해야 합니다.

프로모션과 데이터 소스의 contentLanguage 필드가 일치하지 않음

contentLanguage 필드의 값이 accounts.promotions.insert 요청에서 사용 중인 프로모션 데이터 소스의 contentLanguage 필드 값과 동일하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage

이 오류를 해결하려면 contentLanguage 필드의 값이 사용 중인 프로모션 데이터 소스의 contentLanguage 필드 값과 동일한지 확인합니다.

targetCountry 값이 사용 중인 프로모션 데이터 소스의 targetCountry 필드 값과 동일하지 않은 경우에도 이 오류가 표시됩니다.

자세히 알아보기