Promosyonlar alt API'si ile ilgili sorunları giderme

Bu sayfada, Promosyonlar alt API'si ile ilgili sorunların nasıl giderileceği açıklanmaktadır.

Tanıtım oluşturma

Promosyon eklemek için accounts.promotions.insert isteğini kullanırken istek gövdesine tüm zorunlu alanları eklediğinizden emin olun. Şu alanlar gereklidir:

  • 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

Promosyonun geçerli olduğu dönem geçersiz

accounts.promotions.insert isteğinizde geçersiz promosyon geçerlilik tarihleri sağlarsanız aşağıdaki hata mesajını görürsünüz:

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

Bu hatayı düzeltmek için promotionDisplayTimePeriod.startTime alanı için sağlanan değerin, promotionEffectiveTimePeriod.startTime alanı için sağlanan değerle aynı veya bu değerden önce olduğundan emin olun. Ayrıca, promotionDisplayTimePeriod.endTime alanı için sağlanan değerin, promotionEffectiveTimePeriod.endTime alanı için sağlanan değerle aynı veya bu değerden önce olduğundan emin olun.

startTime ve endTime alanlarının değerleri RFC3339 UTC biçiminde (yyyy-mm-ddThh:mm:ssZ) olmalıdır. Örneğin, 2024-08-15T18:20:20Z.

Minimum satın alma miktarı belirtilmemiş

attributes.couponValueType değeriniz BUY_M_GET_N_PERCENT_OFF veya BUY_M_GET_N_MONEY_OFF ise accounts.promotions.insert isteğinizdeki attributes.minimumPurchaseQuantity alanı için bir değer sağlamanız gerekir.

accounts.promotions.insert isteğinizde attributes.minimumPurchaseQuantity alanı için bir değer sağlamazsanız aşağıdaki hata mesajını görürsünüz:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Bu hatayı düzeltmek için isteğinizdeki minimumPurchaseQuantity alanı için bir değer girdiğinizden emin olun.

İndirim tutarı belirtilmedi

attributes.couponValueType alanınızın değeri MONEY_OFF ise accounts.promotions.insert isteğinizde attributes.moneyOffAmount alanı için bir değer sağlamanız gerekir.

accounts.promotions.insert isteğinizde attributes.moneyOffAmount alanı için bir değer sağlamazsanız aşağıdaki hata mesajını görürsünüz:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Bu hatayı düzeltmek için isteğinizdeki attributes.moneyOffAmount alanı için bir değer girdiğinizden emin olun. Tutar, mikro biriminde olmalıdır.

Ücretsiz hediyenin açıklaması belirtilmemiş

attributes.couponValueType alanınızın değeri FREE_GIFT ise accounts.promotions.insert isteğinizde attributes.freeGiftDescription alanı için bir değer sağlamanız gerekir.

accounts.promotions.insert isteğinizde attributes.freeGiftDescription alanı için bir değer sağlamazsanız aşağıdaki hata mesajını görürsünüz:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Bu hatayı düzeltmek için isteğinizdeki attributes.freeGiftDescription alanı için bir değer girdiğinizden emin olun.

Ücretsiz kargo, yerel promosyonlar için desteklenmiyor

redemptionChannel alanının değeri IN_STORE ve attributes.couponValueType alanının değeri FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT veya FREE_SHIPPING_TWO_DAY ise aşağıdaki hata mesajını görürsünüz:

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

Bu hatayı çözmek için redemptionChannel alanının değerinin ONLINE olduğundan emin olun.

Kullanım kanalı belirtilmedi

accounts.promotions.insert isteğinizde redemptionChannel alanının değeri belirtilmezse aşağıdaki hata mesajını görürsünüz:

[redemptionChannel] Required parameter: redemptionChannel

Bu hatayı düzeltmek için isteğinizdeki redemptionChannel alanı için bir değer girdiğinizden emin olun.

Promosyonun contentLanguage alanı ile veri kaynağı eşleşmiyor

contentLanguage alanının değeri, accounts.promotions.insert isteğinizde kullandığınız promosyon veri kaynağının contentLanguage alanının değeriyle aynı değilse aşağıdaki hata mesajını görürsünüz:

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

Bu hatayı düzeltmek için contentLanguage alanının değerinin, kullandığınız promosyon veri kaynağının contentLanguage alanının değeriyle aynı olduğundan emin olun.

targetCountry değeri, kullandığınız promosyon veri kaynağının targetCountry alanının değeriyle aynı değilse de bu hatayı görürsünüz.

Daha fazla bilgi

Önceki
Overview