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

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

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

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

詳細