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

На этой странице описано, как устранять неполадки, связанные с подсистемой 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 , вы увидите следующее сообщение об ошибке:

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

Для устранения этой ошибки убедитесь, что значение поля promotionDisplayTimePeriod.startTime совпадает или меньше значения поля promotionEffectiveTimePeriod.startTime . Также убедитесь, что значение поля promotionDisplayTimePeriod.endTime совпадает или меньше значения поля promotionEffectiveTimePeriod.endTime .

Значения полей startTime и endTime должны быть в формате UTC согласно RFC3339 , то есть 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 источника данных promotions , используемого в запросе accounts.promotions.insert , вы увидите следующее сообщение об ошибке:

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

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

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

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