프로모션 하위 API 관련 문제 해결

이 페이지에서는 프로모션 하위 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` 요청에 잘못된 프로모션 유효 기간을 제공하면 다음과 같은 오류 메시지가 표시됩니다.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 필드 값과 같지 않은 경우에도 이 오류가 표시됩니다.

자세히 알아보기