車両API v2024-11-01ユースケースガイド

ビークル API の使用方法。

APIバージョン:2020-11-01

ビークル API とは何ですか?

車両用販売パートナーAPI (Vehicles API) を使用すると、固有の識別子を含む車両に関する情報を取得できます。この情報を使用して、出品されているASINの互換性情報をListings APIで提供できます。

車両適合情報が必要なアイテムには、車両Kタイプのリストが必要です。この API は車両とその KTYPE のリストを提供します。これを使用して、カタログ内の各アイテムを KType のリストに個別に対応付けることができます。このマッピングはその後、Listings API を使用して Amazon に提供できます。

このガイドの内容は?

このガイドでは、次の方法について説明します。

  • Vehicles API を使用して最新の車両リストを入手してください。
  • 出品APIを使用してASINの適合情報を更新します。

用語

  • ASIN:Amazonカタログ内の商品を識別するAmazon標準識別番号。
  • Kタイプ: 車両の定義 (ブランド、モデル、タイプ、年式) に関連付けられた数値識別子で、さまざまなブランドが製品をリンクする際に使用されます。

チュートリアル 1: ASINに関する適合情報の提供

カタログ内の商品の互換性情報を提供してください。

前提条件

このチュートリアルを完了するには、以下の前提条件を満たす必要があります。

ステップ 1:ビークルとその K タイプのリストを取得します。

車両のリストを入手するには、 getVehicles オペレーション。

クエリーパラメーター

名前説明必須
marketplaceIdリソースが運営されているマーケットプレイスの識別子。マーケットプレイスの ID を見つけるには、を参照してください。 マーケットプレイス ID
タイプ: ひも
はい
vehicleType車両のタイプ。指定できる値は次のとおりです。 CAR そして MOTORBIKE
タイプ: 列挙型 (VehicleType)
はい
pageToken結果の次のページまたは前のページを取得するために使用できるトークン。レスポンスには以下が含まれます。 pagination 結果の数がページサイズを超える場合。次のページの結果を取得するには、以下のコマンドを使用してオペレーションを呼び出します。 nextToken トークンを生成した呼び出しと同じ引数を含めてください。完全なリストを取得するには、何も表示されなくなるまでこの操作を呼び出します。 nextToken レスポンスで。この操作では空のページが返される場合があることに注意してください。
タイプ: ひも
いいえ
updatedAfterこのフィールドを含めると、指定した日付以降に変更またはAmazonのカタログに追加された車両のみを取得できます。必ず入っている必要があります。 ISO 8601 日付/時間形式。
タイプ: ひも
いいえ

リクエストの例

GET https://sellingpartnerapi-eu.amazon.com/catalog/2024-11-01/automotive/vehicles?marketplaceId=A1F83G8C2ARO7P&updatedAfter=2024-11-01T01:00:00+01:00&vehicleType=CAR

レスポンス

成功レスポンスには、以下のプロパティが含まれます。

名前説明
paginationザ・ nextToken そして previousToken 結果の次ページまたは前のページを取得するために必要な値 (ある場合)。
タイプ: Pagination
vehiclesアマゾンのカタログにある車両のリスト。
タイプ: < Vehicle > アレイ

レスポンスの例

{ "pagination": { "nextToken": "AQICAHhviiXpt-KG7DcOWDoXPW4_B4xAKk9r-8oi43dEh_cI4QF" }, "vehicles": [ { "bodyStyle": "MPV", "driveType": "Front-Wheel Drive", "energy": "Petrol/Liquified Petroleum Gas (LPG)", "engineOutput": [ { "unit": "KILOWATT", "value": 61.0 }, { "unit": "HORSEPOWER", "value": 83.0 } ], "identifiers": [ { "standard": "KTYPE", "value": "100408" } ], "lastProcessedDate": "2024-11-01T01:00:00+01:00", "make": "Dacia", "manufacturingStartDate": { "month": 11, "year": 2013 }, "manufacturingStopDate": { "month": 12, "year": 2015 }, "model": "Dokker", "status": "ACTIVE", "variantName": "1.6 LPG" }, { "bodyStyle": "Closed Off-Road Vehicle", "driveType": "All-wheel Drive", "energy": "Petrol", "engineOutput": [ { "unit": "KILOWATT", "value": 100.0 }, { "unit": "HORSEPOWER", "value": 136.0 } ], "identifiers": [ { "standard": "KTYPE", "value": "10232" } ], "lastProcessedDate": "2024-11-01T01:00:00+01:00", "make": "Vauxhall", "manufacturingStartDate": { "month": 10, "year": 1998 }, "manufacturingStopDate": { "month": 10, "year": 2004 }, "model": "Frontera", "status": "ACTIVE", "variantName": "2.2 I" }, { "bodyStyle": "Closed Off-Road Vehicle", "driveType": "All-wheel Drive", "energy": "Petrol", "engineOutput": [ { "unit": "KILOWATT", "value": 151.0 }, { "unit": "HORSEPOWER", "value": 205.0 } ], "identifiers": [ { "standard": "KTYPE", "value": "10233" } ], "lastProcessedDate": "2024-11-01T01:00:00+01:00", "make": "Vauxhall", "manufacturingStartDate": { "month": 10, "year": 1998 }, "manufacturingStopDate": { "month": 10, "year": 2004 }, "model": "Frontera", "status": "ACTIVE", "variantName": "3.2 I" }, { "bodyStyle": "Closed Off-Road Vehicle", "driveType": "All-wheel Drive", "energy": "Diesel", "engineOutput": [ { "unit": "KILOWATT", "value": 85.0 }, { "unit": "HORSEPOWER", "value": 116.0 } ], "identifiers": [ { "standard": "KTYPE", "value": "10234" } ], "lastProcessedDate": "2024-11-01T01:00:00+01:00", "make": "Vauxhall", "manufacturingStartDate": { "month": 10, "year": 1998 }, "manufacturingStopDate": { "month": 9, "year": 2004 }, "model": "Frontera", "status": "ACTIVE", "variantName": "2.2 DTI" } ] }

ステップ 2:アイテムを KType にマップします。

前のステップの回答を使用して、アイテムが適合する車両を選択してください。各アイテムについて、そのアイテムに適合する車両の KTYPE を記録します。この KType のリストは次のステップで提供します。

ステップ 3:リスティングAPIを使用してフィットメントを更新する

ASINの適合情報を更新するには、 patchListingsItem オペレーション。ザ・ patches リクエスト本文のパラメータには、 path と等しい /attributes/vehicle_fitment そして、KType のリストが格納されています value

パスのパラメーター

名前説明必須
sellerId販売パートナー識別子 (マーチャントアカウントやベンダーコードなど)。
タイプ: ひも
はい
sku販売パートナーが提供したAmazonリスティングの識別子。
タイプ: ひも
はい

クエリーパラメーター

名前説明必須
marketplaceIdsリクエストの Amazon マーケットプレイス ID をカンマで区切ったリスト。
タイプ: アレイ
はい
includedData応答に含めるデータセットのコンマ区切りリスト。
タイプ: < 列挙 ()IncludedData) > アレイ
いいえ
modeリクエストの操作モード。
タイプ: 列挙型 (Mode)
いいえ
issueLocale課題をローカライズするためのロケール。指定しない場合は、最初のマーケットプレイスのデフォルト言語コードが使用されます。
タイプ: ひも
いいえ

ボディのパラメーター

名前説明必須
productType出品商品のAmazon商品タイプ。
タイプ: ひも
はい
patchesリスト項目に対して実行する 1 つ以上の JSON パッチ操作。
タイプ: < PatchOperation > アレイ
はい

リクエストの例

PATCH https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/XXXXXXXXXX/SKU_XXXXXX?includedData=issues&marketplaceIds=A1PA6795UKMFR9 { "productType": "AUTO_OIL", "patches": [ { "op": "replace", "path": "/attributes/vehicle_fitment", "value": [ { "standard": [ { "value": "ktype", "language_tag": "de_DE" } ], "code": [ { "value": "10232, 10234, 10233", "language_tag": "de_DE" } ], "note": [ { "value": "{\"10232,10234\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"]]],\"10233\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"],[\"Motorcode\",\"N47 D20 C\"]]]}", "language_tag": "de_DE" } ], "marketplace_id": "A1PA6795UKMFR9" } ] } ] }

レスポンス

成功レスポンスには、以下のプロパティが含まれます。

名前説明
sku販売パートナーが提供したAmazonリスティングの識別子。
タイプ: ひも
status出品商品の送信ステータス。
タイプ: 列挙 (Status)
submissionId送信された出品商品の一意の識別子。
タイプ: ひも
issues出品商品の提出に関連する出品商品の問題。
タイプ: < Issue > アレイ
identifiersASINなど、Amazonカタログ内の商品に関連する識別属性。
タイプ: ItemIdentifiers

レスポンスの例

{ "sku": "SKU-XXXX-XXXX", "status": "ACCEPTED", "submissionId": "xxxxxxxxxxxxxxxxx", "issues": [] }

❗️

利用規約

本APIが提供するデータをダウンロードして利用する場合、 利用規約はこちら 申請し、ユーザーに承認される。


このページは役に立ちましたか?