Résoudre les problèmes liés à la sous-API Promotions

Cette page explique comment résoudre les problèmes liés à la sous-API Promotions.

Créer une promotion

Lorsque vous utilisez la requête accounts.promotions.insert pour insérer une promotion, assurez-vous d'avoir inclus tous les champs obligatoires dans le corps de votre requête. Les champs suivants sont obligatoires:

  • 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

Période de validité de la promotion non valide

Si vous fournissez des dates de début de promotion non valides dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

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

Pour résoudre cette erreur, assurez-vous que la valeur fournie pour le champ promotionDisplayTimePeriod.startTime est identique ou antérieure à celle fournie pour le champ promotionEffectiveTimePeriod.startTime. Assurez-vous également que la valeur fournie pour le champ promotionDisplayTimePeriod.endTime est identique ou antérieure à celle fournie pour le champ promotionEffectiveTimePeriod.endTime.

Les valeurs des champs startTime et endTime doivent être au format RFC3339 UTC, c'est-à-dire yyyy-mm-ddThh:mm:ssZ. Par exemple, 2024-08-15T18:20:20Z.

Quantité minimale d'achat non spécifiée

Si votre attributes.couponValueType est BUY_M_GET_N_PERCENT_OFF ou BUY_M_GET_N_MONEY_OFF, vous devez fournir une valeur pour le champ attributes.minimumPurchaseQuantity dans votre requête accounts.promotions.insert.

Si vous ne fournissez pas de valeur pour le champ attributes.minimumPurchaseQuantity dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Pour résoudre cette erreur, assurez-vous de fournir une valeur pour le champ minimumPurchaseQuantity dans votre requête.

Montant de la remise non spécifié

Si la valeur de votre champ attributes.couponValueType est MONEY_OFF, vous devez fournir une valeur pour le champ attributes.moneyOffAmount dans votre requête accounts.promotions.insert.

Si vous ne fournissez pas de valeur pour le champ attributes.moneyOffAmount dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Pour résoudre cette erreur, assurez-vous de fournir une valeur pour le champ attributes.moneyOffAmount dans votre requête. Le montant doit être exprimé en micro.

Description du cadeau sans frais non spécifiée

Si la valeur de votre champ attributes.couponValueType est FREE_GIFT, vous devez fournir une valeur pour le champ attributes.freeGiftDescription dans votre requête accounts.promotions.insert.

Si vous ne fournissez pas de valeur pour le champ attributes.freeGiftDescription dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Pour résoudre cette erreur, assurez-vous de fournir une valeur pour le champ attributes.freeGiftDescription dans votre requête.

Livraison gratuite non disponible pour les promotions en magasin

Si la valeur du champ redemptionChannel est IN_STORE et que la valeur du champ attributes.couponValueType est FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT ou FREE_SHIPPING_TWO_DAY, le message d'erreur suivant s'affiche:

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

Pour résoudre cette erreur, assurez-vous que la valeur du champ redemptionChannel est ONLINE.

Canal de distribution non spécifié

Si la valeur du champ redemptionChannel n'est pas spécifiée dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

[redemptionChannel] Required parameter: redemptionChannel

Pour résoudre cette erreur, assurez-vous de fournir une valeur pour le champ redemptionChannel dans votre requête.

Le champ contentLanguage de la promotion et de la source de données ne correspondent pas

Si la valeur du champ contentLanguage n'est pas identique à celle du champ contentLanguage de la source de données sur les promotions que vous utilisez dans votre requête accounts.promotions.insert, le message d'erreur suivant s'affiche:

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

Pour résoudre cette erreur, assurez-vous que la valeur du champ contentLanguage est identique à celle du champ contentLanguage de la source de données sur les promotions que vous utilisez.

Cette erreur s'affiche également si la valeur de targetCountry n'est pas identique à celle du champ targetCountry de la source de données des promotions que vous utilisez.

En savoir plus