Promosyonlar alt API'si ile ilgili sorunları giderme

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

Tanıtım oluşturma

Bir 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 tanıtım geçerlilik dönemi

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 ondan ö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 olmalıdır. Örneğin: yyyy-mm-ddThh:mm:ssZ. Örneğin, 2024-08-15T18:20:20Z.

Minimum satın alma miktarı belirtilmemiş

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

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

Ücretsiz kargo, yerel promosyonlarda 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ş

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

[redemptionChannel] Required parameter: redemptionChannel

Bu hatayı düzeltmek için isteğinizde redemptionChannel alanı için bir değer sağladığınızdan emin olun.

Promosyonun ve veri kaynağının contentLanguage alanı 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ı çözmek için contentLanguage alanının değerinin, kullandığınız promosyon verileri 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