Устранение неполадок, связанных с API Merchant Promotions API

На этой странице описано, как устранить проблемы, связанные с API Merchant Promotions.

Создать продвижение

При использовании запроса 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 , вы должны указать значение для поля attributes.minimumPurchaseQuantity в вашем запросе accounts.promotions.insert .

Если вы не укажете значение для поля attributes.minimumPurchaseQuantity в запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Чтобы устранить эту ошибку, убедитесь, что вы указали значение поля minimumPurchaseQuantity в своем запросе.

Сумма скидки не указана

Если значение вашего поля attributes.couponValueType равно MONEY_OFF , вы должны указать значение для поля attributes.moneyOffAmount в вашем запросе accounts.promotions.insert .

Если вы не укажете значение для поля attributes.moneyOffAmount в запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Чтобы устранить эту ошибку, убедитесь, что вы указали значение поля attributes.moneyOffAmount в своем запросе. Сумма должна быть в микро.

Описание бесплатного подарка не указано

Если значение вашего поля attributes.couponValueType равно FREE_GIFT , вы должны указать значение для поля attributes.freeGiftDescription в вашем запросе accounts.promotions.insert .

Если вы не укажете значение для поля attributes.freeGiftDescription в запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

[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 .

Канал погашения не указан

Если значение поля redemptionChannel не указано в вашем запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

[redemptionChannel] Required parameter: redemptionChannel

Чтобы устранить эту ошибку, убедитесь, что вы указали значение поля redemptionChannel в своем запросе.

Поле contentLanguage промоакции и источник данных не совпадают.

Если значение поля contentLanguage не совпадает со значением поля contentLanguage источника данных о рекламных акциях, который вы используете в своем запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

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

Чтобы устранить эту ошибку, убедитесь, что значение поля contentLanguage совпадает со значением поля contentLanguage используемого вами источника данных о рекламных акциях.

Вы также увидите эту ошибку, если значение targetCountry не совпадает со значением поля targetCountry используемого вами источника данных о рекламных акциях.

Узнать больше