Merchant Promotions API に関する問題のトラブルシューティング

このページでは、Merchant 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 フィールドの値と一致しない場合にも、このエラーが表示されます。

その他の情報