ドキュメント
開発者ハブAPIステータスサポート
入力を開始して検索...

車両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が提供するデータをダウンロードして利用する場合、 利用規約はこちら 申請し、ユーザーに承認される。

Updated 7 days ago

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