【Yahoo!ショッピング】商品別ポイント倍率の期間指定機能追加に伴うAPI項目追加のお知らせ
※商品登録API、商品参照APIをご利用の出店者様が対象です。
いつもYahoo! JAPANをご利用いただきありがとうございます。
Yahoo!ショッピングでは、商品別ポイント倍率とその適用期間をあらかじめ設定できる「商品別ポイント倍率の期間指定」機能の追加を予定しています。
本機能の提供に伴い、商品登録APIおよび商品参照APIに項目を追加します。
※実施日が決まり次第、本ページでお知らせします。
※段階的に提供する場合があります。
商品参照API
アップロードフォーマット
※記載しているフィールド名、リクエストパラメーター名、レスポンス項目名、入力形式などは開発中の内容です。リリースまでに変更となる場合がありますのでご了承ください。
・期間指定を設定する場合は、商品別ポイント倍率、開始日時、終了日時の3項目をすべて指定してください。1項目または2項目のみを指定した場合はエラーとなります。
・商品登録API(editItem)は上書き更新です。設定済みの期間指定内容を維持する場合は、ほかの商品情報のみを更新するときも、追加する3項目すべてに現在の設定値を指定してください。3項目を指定しない場合、設定済みの期間指定内容が解除されます。
・既存の通常の商品別ポイント倍率に関する項目は、引き続きご利用いただけます。期間指定機能を利用しない場合、移行に伴う再設定は必要ありません。
詳しい入力条件、設定・解除方法、エラー内容は、後日各仕様書に記載いたしますのでリリースまでに更新予定の各API仕様書をご確認ください。
今後とも、Yahoo!ショッピングをどうぞよろしくお願いいたします。
いつもYahoo! JAPANをご利用いただきありがとうございます。
Yahoo!ショッピングでは、商品別ポイント倍率とその適用期間をあらかじめ設定できる「商品別ポイント倍率の期間指定」機能の追加を予定しています。
本機能の提供に伴い、商品登録APIおよび商品参照APIに項目を追加します。
実施時期
2026年12月~2027年2月(予定)※実施日が決まり次第、本ページでお知らせします。
※段階的に提供する場合があります。
対象API・機能
商品登録API商品参照API
アップロードフォーマット
変更内容
商品登録API(editItem)
以下のリクエストパラメーターを追加します。| リクエストパラメーター | 項目 |
|---|---|
| period_point_code | 期間指定ありの商品別ポイント倍率コード |
| period_point_code_start | 期間指定ありの商品別ポイント倍率の開始日時(YYYYMMDDHHMM形式) |
| period_point_code_end | 期間指定ありの商品別ポイント倍率の終了日時(YYYYMMDDHHMM形式) |
商品参照API(getItem)
以下のレスポンス項目を追加します。| レスポンス項目 | 項目 |
|---|---|
| PeriodPointCode | 期間指定ありの商品別ポイント倍率コード |
| PeriodPointCodeStart | 期間指定ありの商品別ポイント倍率の開始日時(YYYYMMDDHHMM形式) |
| PeriodPointCodeEnd | 期間指定ありの商品別ポイント倍率の終了日時(YYYYMMDDHHMM形式) |
アップロードフォーマット
アップロードフォーマットに以下のフィールドを追加します。| フィールド名 | 項目 |
|---|---|
| period-point-code | 期間指定ありの商品別ポイント倍率 |
| period-point-code-start | 期間指定ありの商品別ポイント倍率の開始日時(YYYYMMDDHHMM形式) |
| period-point-code-end | 期間指定ありの商品別ポイント倍率の終了日時(YYYYMMDDHHMM形式) |
※記載しているフィールド名、リクエストパラメーター名、レスポンス項目名、入力形式などは開発中の内容です。リリースまでに変更となる場合がありますのでご了承ください。
ご利用時の注意事項
・商品登録APIまたは商品参照APIを利用している自社システムや、他社が提供するシステムで本機能に対応する場合は、追加項目への対応など、システムの設定変更や改修が必要となる可能性があります。仕様をご確認のうえ、必要に応じてシステムの提供元または開発会社へご相談ください。・期間指定を設定する場合は、商品別ポイント倍率、開始日時、終了日時の3項目をすべて指定してください。1項目または2項目のみを指定した場合はエラーとなります。
・商品登録API(editItem)は上書き更新です。設定済みの期間指定内容を維持する場合は、ほかの商品情報のみを更新するときも、追加する3項目すべてに現在の設定値を指定してください。3項目を指定しない場合、設定済みの期間指定内容が解除されます。
・既存の通常の商品別ポイント倍率に関する項目は、引き続きご利用いただけます。期間指定機能を利用しない場合、移行に伴う再設定は必要ありません。
詳しい入力条件、設定・解除方法、エラー内容は、後日各仕様書に記載いたしますのでリリースまでに更新予定の各API仕様書をご確認ください。
今後とも、Yahoo!ショッピングをどうぞよろしくお願いいたします。