車両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に関する適合情報の提供
カタログ内の商品の互換性情報を提供してください。
前提条件
このチュートリアルを完了するには、以下の前提条件を満たす必要があります。
- 呼び出し先の出品パートナーからの承認。詳細については、Selling Partner APIアプリケーションの認証をご覧ください。
- の承認 製品リスト 開発者プロフィールにおける役割。
- アプリケーションのアプリ登録ページで商品出品ロールが選択されている。
ステップ 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 > アレイ |
identifiers | ASINなど、Amazonカタログ内の商品に関連する識別属性。 タイプ: ItemIdentifiers |
レスポンスの例
{
"sku": "SKU-XXXX-XXXX",
"status": "ACCEPTED",
"submissionId": "xxxxxxxxxxxxxxxxx",
"issues": []
}
利用規約
本APIが提供するデータをダウンロードして利用する場合、 利用規約はこちら 申請し、ユーザーに承認される。
Updated 7 days ago