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 フィールドの値は、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 の場合は、accounts.promotions.insert リクエストで attributes.minimumPurchaseQuantity フィールドの値を指定する必要があります。

accounts.promotions.insert リクエストの attributes.minimumPurchaseQuantity フィールドに値を指定しないと、次のエラー メッセージが表示されます。

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

このエラーを解決するには、リクエストで minimumPurchaseQuantity フィールドに値を指定してください。

割引額が指定されていません

attributes.couponValueType フィールドの値が MONEY_OFF の場合は、accounts.promotions.insert リクエストで attributes.moneyOffAmount フィールドの値を指定する必要があります。

accounts.promotions.insert リクエストで attributes.moneyOffAmount フィールドの値を指定しないと、次のエラー メッセージが表示されます。

[moneyOffAmount] Missing benefit or restriction attributes for its type

このエラーを解決するには、リクエストで attributes.moneyOffAmount フィールドに値を指定してください。金額はマイクロ単位で指定する必要があります。

プレゼントの説明が指定されていない

attributes.couponValueType フィールドの値が FREE_GIFT の場合は、accounts.promotions.insert リクエストで attributes.freeGiftDescription フィールドの値を指定する必要があります。

accounts.promotions.insert リクエストで attributes.freeGiftDescription フィールドの値を指定しないと、次のエラー メッセージが表示されます。

[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 であることを確認します。

クーポン利用チャネルが指定されていない

accounts.promotions.insert リクエストで redemptionChannel フィールドの値が指定されていない場合、次のエラー メッセージが表示されます。

[redemptionChannel] Required parameter: redemptionChannel

このエラーを解決するには、リクエストで redemptionChannel フィールドに値を指定してください。

プロモーションとデータソースの contentLanguage フィールドが一致していない

contentLanguage リクエストで使用しているプロモーション データソースの contentLanguage フィールドの値と contentLanguage フィールドの値が一致しない場合は、次のエラー メッセージが表示されます。accounts.promotions.insert

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

このエラーを解決するには、contentLanguage フィールドの値が、使用しているプロモーション データソースの contentLanguage フィールドの値と同じであることを確認してください。

また、使用しているプロモーション データソースの targetCountry フィールドの値と targetCountry の値が一致しない場合にも、このエラーが表示されます。

詳細