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övdenize gerekli tüm alanları eklediğinizden emin olun. Aşağıdaki alanlar zorunludur:

  • 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

Geçersiz promosyon geçerlilik süresi

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ı olduğundan 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ı olduğundan veya bu değerden önce olduğundan emin olun.

startTime ve endTime alanlarının değerleri RFC3339 UTC biçiminde olmalıdır. Yani yyyy-mm-ddThh:mm:ssZ. Ö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ğinizde 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ı çözmek için isteğinizde minimumPurchaseQuantity alanı için bir değer sağladığınızdan emin olun.

İndirim tutarı belirtilmemiş

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ı çözmek için isteğinizde attributes.moneyOffAmount alanı için bir değer sağladığınızdan emin olun. Tutar mikro cinsinden olmalıdır.

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ı çözmek için isteğinizde attributes.freeGiftDescription alanı için bir değer sağladığınızdan emin olun.

Yerel promosyonlarda ücretsiz kargo desteklenmez

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ı belirtilmemiş

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ı çözmek için isteğinizde redemptionChannel alanı için bir değer sağladığınızdan 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 promosyonlar 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ı çözmek için contentLanguage alanının değerinin, kullandığınız promosyonlar veri kaynağının contentLanguage alanının değeriyle aynı olduğundan emin olun.

targetCountry değerinin, kullandığınız promosyonlar veri kaynağının targetCountry alanının değeriyle aynı olmaması durumunda da bu hatayı görürsünüz.

Daha fazla bilgi