2023年12月のSP-APIリリースのお知らせ
・2023年12月のSP-APIリリースのお知らせ
パブリックベータ版の新しいApplication Management API v2023-11-30
2023年2月6日にお知らせしたように、180日ごとにすべてのアプリケーションについて、LWA(Amazonでログイン)の認証情報(クライアントシークレット)をローテーションする必要があります。アプリケーション管理用の新しいSelling Partner APIでは、登録済みアプリケーションのローテーションをプログラムで実行できます。詳しくは、SP-APIパブリックベータサイトのアプリケーション管理API v2023-11-30ユースケースガイドをご覧ください。
・Shipping API v2がAmazon出荷危険物のサポートを開始
Amazon配送において、米国と英国の市場で危険物(DG)の出荷をサポートするようになりました。出品者や配送業者は、リチウム電池が含まれる美容品や電子機器について、Shipping API v2でDGの詳細を提供するか、配送業者セントラルを使用して配送ラベルを生成できます。
出品者は適用されるすべての法律と規制に従って、DGパッケージの安全な取り扱いと輸送を行う必要があります。詳しくは、以下のドキュメントをご覧ください。
・Listings Items API v2021-08-01の更新情報
Listings Items API v2021-08-01がインド(IN)のマーケットプレイスで利用可能に
2023年12月4日、Listings Items APIのインド(IN)マーケットプレイスでの対応が開始しました。
インドマーケットプレイスの開発者は、出品アイテムAPIを使用して、Amazonの出品情報を作成して管理するプログラム統合を構築できます。開発者はまた、ローンチした全商品タイプのリストを検索したり、出品情報をすべて送信して新しいASINに情報を提供したり、商品情報の部分変更を送信したり、画像をアップロードしたりできます。
SP-APIと統合した出品ワークフローの構築と管理について詳しくは、出品管理ワークフロー作成ガイドをご覧ください。既存の出品管理ワークフローをXMLベースや一括アップロードファイルのフィードから出品アイテムAPIに移行するには、Migrating Listings Management Workflows Guide(出品管理ワークフロー移行ガイド)で詳細をご覧ください。
・出品属性と列挙値の更新
複数のマーケットプレイスでさまざまな商品タイプの属性と列挙値が更新され、重複する属性がなくなり、対応する商品タイプに関連する属性と列挙値が整理されました。この変更は以下のマーケットプレイスに適用されます。
- 日本(JP)
- 米国(US)
- フランス(FR)
- ドイツ(DE)
- イタリア(IT
- オランダ(NL)
- ポーランド(PL)
- スペイン(ES)
- スウェーデン(SE)
- インド(IN)
- トルコ(TR)
- カナダ(CA)
- ブラジル(BR)
- メキシコ(MX)
- オーストラリア(AU)
- シンガポール(SG)
- サウジアラビア(SA)
- アラブ首長国連邦(AE)
- エジプト(EG)
- 英国(UK)
Listings Items API v2021-08-01やJSON_LISTINGS_FEEDフィードタイプを使用して商品情報の作成や編集をしている開発者は、この変更の影響を受けます。商品のみの出品情報やXSD/XMLフィードのアップロードの場合、この変更の影響はありません。
影響を受ける商品タイプと変更の詳細なリストについては、2023年12月のListings Items API商品タイプの変更を参照してください。
・新しい出品サンプルアプリケーション
新しい出品サンプルアプリケーションでは、出品情報管理ワークフローの構築ガイドに記載されているAPIを使用して、一般的な出品管理ワークフローをユーザーインターフェイスから構築する方法を示しています。
・Listings Items API v2021-08-01の新しい問題オブジェクトフィールド
「Issue」オブジェクトにある以下の新しい2つのフィールドが、出品に伴う問題に関する詳細情報を提供します。
- Enforcements(強制措置)は、当該問題に関してAmazonが出品情報に対してとった措置に関する情報を提供します。たとえば、LISTING_SUPPRESSEDは、この問題が原因でAmazonが出品を取り下げたことを意味します。
- Categories(カテゴリー)は、問題に関するカテゴリー分類の概要を提供します。
さらに、LISTINGS_ITEM_ISSUE_CHANGE通知で追加のEnforcementsを報告できるようになります。新しいバージョンのLISTINGS_ITEM_ISSUE_CHANGEのサブスクリプションには、2023-12-13のpayloadVersionを使用してください。
・Vendor Retail Procurement API v1
Vendor Retail Procurement API v1ユースケースガイドが更新され、SubmitShipmentsとGetShipmentDetailsオペレーションの使用に関する情報が追加されています。
SubmitShipmentsオペレーションは、CollectやWePayのベンダーがAmazonによる貨物の集荷リクエストを送信できるようになっています。
GetShipmentDetailsオペレーションを使用して、集荷予定情報と配送業者の割当情報を取得できます。
・Vendor Direct Fulfillment Orders API v1とv2021-12-28
Vendor Direct Fulfillment Orders API v1ユースケースガイドが更新され、出品者出荷の顧客データ転送に関するセクションが追加されました。ベンダーはgetOrderとgetOrdersオペレーションで処理された特定の出荷に関する名前、住所、電話番号などの顧客データを受け取りません。Amazonラベルのみのベンダーの場合、特定のフィールドが架空の値XXXXXに置き換えられます。
・Product Type Definitions API v2020-09-01
Product Type Definitions API v2020-09-01モデルが更新され、searchDefinitionsProductTypesオペレーションのレスポンスで、productTypeVersion属性の既知の問題が解決しました。
・Notifications API v1の更新
Notifications APIが更新され、payloadVersionオプションパラメーターが追加されました。このパラメーターを使用して、通知に使用するペイロードオブジェクトのバージョンを返すことができます。
新しい出品アイテムのListings Item Issues Change Notification version 2023-12-13では、以下の3つの新しい強制措置があります: LISTING_SUPPRESSED、ATTRIBUTE_SUPPRESSED、CATALOG_ITEM_REMOVED。これらは、Amazonが出品問題に対して取った強制措置です。
・FBAレポートの更新
GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATAには、更新された列名が含まれるようになりました。フルフィルメントby Amazon(FBA)レポートタイプの値ページのFBA長期在庫保管手数料レポートに、レポートの適切な生成方法を説明する注記が追加されました。
フルフィルメントby Amazon(FBA)の一括請求書レポート(FBA_BULK_INVOICE)では、所定の日付範囲内で出品者の請求書が共有されます。この請求書には、出品者が処理した顧客注文が含まれます。
・廃止
廃止が発表されたSP-APIリソースは、廃止日を過ぎるとサポートされなくなります。廃止日以降、廃止されたリソースへの呼び出しはエラーとなります。SP-APIの廃止日に関する詳細は、『廃止表』をご覧ください。
・API
- フルフィルメント納品API v0のgetInboundGuidanceオペレーションは2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。このAPIは現在静的データが返されるため、使用しないでください。
- 出品者出荷API v0のgetEligibleShipmentServicesOld、cancelShipmentOld、getAdditionalSellerInputsOldの各オペレーションは、2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。
- 認可API v1は2023年9月20日に廃止が発表され、廃止日は2024年3月20日の予定です。
・フィード
- POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLANは2023年5月17日に廃止が発表され、廃止日は2023年11月8日の予定です。
- POST_FLAT_FILE_FBA_CREATE_INBOUND_PLANは2023年5月7日に廃止が発表され、廃止日は2023年11月8日の予定です。
- RFQ_UPLOAD_FEED(FEとEU)は廃止され、2023年12月13日に終了しました。
・レポート
- GET_PRODUCT_EXCHANGE_DATA は2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。
- GET_FBA_UNO_INVENTORY_DATAは2023年9月20日に廃止が発表され、廃止日は2024年3月31日の予定です。
・通知
- ORDER_STATUS_CHANGEは2023年6月21日に廃止が発表され、廃止日は2023年12月31日の予定です。
よろしくお願いいたします。
Selling Partner APIチーム
2023年12月のSP-APIリリースのお知らせ
・2023年12月のSP-APIリリースのお知らせ
パブリックベータ版の新しいApplication Management API v2023-11-30
2023年2月6日にお知らせしたように、180日ごとにすべてのアプリケーションについて、LWA(Amazonでログイン)の認証情報(クライアントシークレット)をローテーションする必要があります。アプリケーション管理用の新しいSelling Partner APIでは、登録済みアプリケーションのローテーションをプログラムで実行できます。詳しくは、SP-APIパブリックベータサイトのアプリケーション管理API v2023-11-30ユースケースガイドをご覧ください。
・Shipping API v2がAmazon出荷危険物のサポートを開始
Amazon配送において、米国と英国の市場で危険物(DG)の出荷をサポートするようになりました。出品者や配送業者は、リチウム電池が含まれる美容品や電子機器について、Shipping API v2でDGの詳細を提供するか、配送業者セントラルを使用して配送ラベルを生成できます。
出品者は適用されるすべての法律と規制に従って、DGパッケージの安全な取り扱いと輸送を行う必要があります。詳しくは、以下のドキュメントをご覧ください。
・Listings Items API v2021-08-01の更新情報
Listings Items API v2021-08-01がインド(IN)のマーケットプレイスで利用可能に
2023年12月4日、Listings Items APIのインド(IN)マーケットプレイスでの対応が開始しました。
インドマーケットプレイスの開発者は、出品アイテムAPIを使用して、Amazonの出品情報を作成して管理するプログラム統合を構築できます。開発者はまた、ローンチした全商品タイプのリストを検索したり、出品情報をすべて送信して新しいASINに情報を提供したり、商品情報の部分変更を送信したり、画像をアップロードしたりできます。
SP-APIと統合した出品ワークフローの構築と管理について詳しくは、出品管理ワークフロー作成ガイドをご覧ください。既存の出品管理ワークフローをXMLベースや一括アップロードファイルのフィードから出品アイテムAPIに移行するには、Migrating Listings Management Workflows Guide(出品管理ワークフロー移行ガイド)で詳細をご覧ください。
・出品属性と列挙値の更新
複数のマーケットプレイスでさまざまな商品タイプの属性と列挙値が更新され、重複する属性がなくなり、対応する商品タイプに関連する属性と列挙値が整理されました。この変更は以下のマーケットプレイスに適用されます。
- 日本(JP)
- 米国(US)
- フランス(FR)
- ドイツ(DE)
- イタリア(IT
- オランダ(NL)
- ポーランド(PL)
- スペイン(ES)
- スウェーデン(SE)
- インド(IN)
- トルコ(TR)
- カナダ(CA)
- ブラジル(BR)
- メキシコ(MX)
- オーストラリア(AU)
- シンガポール(SG)
- サウジアラビア(SA)
- アラブ首長国連邦(AE)
- エジプト(EG)
- 英国(UK)
Listings Items API v2021-08-01やJSON_LISTINGS_FEEDフィードタイプを使用して商品情報の作成や編集をしている開発者は、この変更の影響を受けます。商品のみの出品情報やXSD/XMLフィードのアップロードの場合、この変更の影響はありません。
影響を受ける商品タイプと変更の詳細なリストについては、2023年12月のListings Items API商品タイプの変更を参照してください。
・新しい出品サンプルアプリケーション
新しい出品サンプルアプリケーションでは、出品情報管理ワークフローの構築ガイドに記載されているAPIを使用して、一般的な出品管理ワークフローをユーザーインターフェイスから構築する方法を示しています。
・Listings Items API v2021-08-01の新しい問題オブジェクトフィールド
「Issue」オブジェクトにある以下の新しい2つのフィールドが、出品に伴う問題に関する詳細情報を提供します。
- Enforcements(強制措置)は、当該問題に関してAmazonが出品情報に対してとった措置に関する情報を提供します。たとえば、LISTING_SUPPRESSEDは、この問題が原因でAmazonが出品を取り下げたことを意味します。
- Categories(カテゴリー)は、問題に関するカテゴリー分類の概要を提供します。
さらに、LISTINGS_ITEM_ISSUE_CHANGE通知で追加のEnforcementsを報告できるようになります。新しいバージョンのLISTINGS_ITEM_ISSUE_CHANGEのサブスクリプションには、2023-12-13のpayloadVersionを使用してください。
・Vendor Retail Procurement API v1
Vendor Retail Procurement API v1ユースケースガイドが更新され、SubmitShipmentsとGetShipmentDetailsオペレーションの使用に関する情報が追加されています。
SubmitShipmentsオペレーションは、CollectやWePayのベンダーがAmazonによる貨物の集荷リクエストを送信できるようになっています。
GetShipmentDetailsオペレーションを使用して、集荷予定情報と配送業者の割当情報を取得できます。
・Vendor Direct Fulfillment Orders API v1とv2021-12-28
Vendor Direct Fulfillment Orders API v1ユースケースガイドが更新され、出品者出荷の顧客データ転送に関するセクションが追加されました。ベンダーはgetOrderとgetOrdersオペレーションで処理された特定の出荷に関する名前、住所、電話番号などの顧客データを受け取りません。Amazonラベルのみのベンダーの場合、特定のフィールドが架空の値XXXXXに置き換えられます。
・Product Type Definitions API v2020-09-01
Product Type Definitions API v2020-09-01モデルが更新され、searchDefinitionsProductTypesオペレーションのレスポンスで、productTypeVersion属性の既知の問題が解決しました。
・Notifications API v1の更新
Notifications APIが更新され、payloadVersionオプションパラメーターが追加されました。このパラメーターを使用して、通知に使用するペイロードオブジェクトのバージョンを返すことができます。
新しい出品アイテムのListings Item Issues Change Notification version 2023-12-13では、以下の3つの新しい強制措置があります: LISTING_SUPPRESSED、ATTRIBUTE_SUPPRESSED、CATALOG_ITEM_REMOVED。これらは、Amazonが出品問題に対して取った強制措置です。
・FBAレポートの更新
GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATAには、更新された列名が含まれるようになりました。フルフィルメントby Amazon(FBA)レポートタイプの値ページのFBA長期在庫保管手数料レポートに、レポートの適切な生成方法を説明する注記が追加されました。
フルフィルメントby Amazon(FBA)の一括請求書レポート(FBA_BULK_INVOICE)では、所定の日付範囲内で出品者の請求書が共有されます。この請求書には、出品者が処理した顧客注文が含まれます。
・廃止
廃止が発表されたSP-APIリソースは、廃止日を過ぎるとサポートされなくなります。廃止日以降、廃止されたリソースへの呼び出しはエラーとなります。SP-APIの廃止日に関する詳細は、『廃止表』をご覧ください。
・API
- フルフィルメント納品API v0のgetInboundGuidanceオペレーションは2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。このAPIは現在静的データが返されるため、使用しないでください。
- 出品者出荷API v0のgetEligibleShipmentServicesOld、cancelShipmentOld、getAdditionalSellerInputsOldの各オペレーションは、2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。
- 認可API v1は2023年9月20日に廃止が発表され、廃止日は2024年3月20日の予定です。
・フィード
- POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLANは2023年5月17日に廃止が発表され、廃止日は2023年11月8日の予定です。
- POST_FLAT_FILE_FBA_CREATE_INBOUND_PLANは2023年5月7日に廃止が発表され、廃止日は2023年11月8日の予定です。
- RFQ_UPLOAD_FEED(FEとEU)は廃止され、2023年12月13日に終了しました。
・レポート
- GET_PRODUCT_EXCHANGE_DATA は2023年9月20日に廃止が発表され、廃止日は2023年12月28日の予定です。
- GET_FBA_UNO_INVENTORY_DATAは2023年9月20日に廃止が発表され、廃止日は2024年3月31日の予定です。
・通知
- ORDER_STATUS_CHANGEは2023年6月21日に廃止が発表され、廃止日は2023年12月31日の予定です。
よろしくお願いいたします。
Selling Partner APIチーム