车辆 API v2024-11-01 用例指南

如何使用车辆 API。

API 版本：2020-11-01

什么是车辆 API？

使用销售合作伙伴车辆API（车辆 API），您可以检索有关车辆的信息，包括其唯一标识符。您可以使用此信息通过清单 API 为上架的 ASIN 提供兼容性信息。

需要车辆装配信息的物品需要车辆 KTypes 列表。此 API 提供车辆及其 KTYPE 列表，您可以使用该列表将目录中的每件物品独立映射到 KTypes 列表。然后，可以使用清单 API 将此映射提供给亚马逊。

本指南中有什么？

本指南介绍如何：

使用车辆 API 获取最新的车辆清单。
使用清单 API 更新 ASIN 的配件信息。

术语

ASIN：用于标识亚马逊目录中商品的亚马逊商品编码。
KTYPE：与车辆定义（品牌、型号、类型、年份）相关的数字标识符，供各种品牌用来关联其产品。

教程 1：提供有关 ASIN 的配件信息

为您的目录中的商品提供兼容性信息。

先决条件

要完成本教程，您必须具备：

您正在为其进行调用的销售伙伴的授权。请参阅授权销售伙伴 API 应用程序了解更多信息。
批准产品清单在您的开发者个人资料中扮演的角色。
在应用程序注册页面中为您的应用程序选择的商品信息职权。

第 1 步。检索车辆及其 KType 列表

要获取车辆清单，请致电 getVehicles 操作。

查询参数

名称	描述	必填项
`marketplaceId`	资源所在商城的标识符。要查找商城的 ID，请参阅商城 ID。类型：串	有帮助
`vehicleType`	车辆的类型。可能的值是 `CAR` 和 `MOTORBIKE`。类型：枚举 (`VehicleType`)	有帮助
`pageToken`	可用于检索下一页或上一页结果的令牌。回应包括 `pagination` 当结果数量超过页面大小时。要获取下一页结果，请使用以下命令调用该操作 `nextToken` 并包含与生成令牌的调用相同的参数。要获得完整列表，请调用此操作直到没有 `nextToken` 在回应中。请注意，此操作可能会返回空页面。类型：串	没有帮助
`updatedAfter`	添加此字段以仅检索在您提供的日期之后经过修改或添加到亚马逊目录中的车辆。必须进去 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 步。将您的物品映射到 KTypes

使用上一步中的响应来选择适合您的物品的车辆。对于每件物品，记录适合该物品的车辆的 KTYPE。您在下一步中提供这个 KTypes 列表。

第 3 步。使用 Listings API 更新配件

要更新 ASIN 的配件信息，请致电 patchListingsItem 操作。这个 patches 请求正文中的参数应为 path 等于 /attributes/vehicle_fitment 并包含 KTypes 列表 value。

路径参数

名称	描述	必填项
`sellerId`	销售合作伙伴标识符，例如商家账户或供应商代码。类型：串	有帮助
`sku`	卖家合作伙伴为亚马逊清单提供了标识符。类型：串	有帮助

查询参数

名称	描述	必填项
`marketplaceIds`	以逗号分隔的请求的亚马逊商城编号列表。类型：排列	有帮助
`includedData`	要包含在响应中的以逗号分隔的数据集列表。类型： < 枚举 (`IncludedData`) > 排列	没有帮助
`mode`	请求的操作模式。类型：枚举 (`Mode`)	没有帮助
`issueLocale`	用于本地化问题的场所。如果未提供，则使用第一个商城的默认语言代码。类型：串	没有帮助

主体参数

名称	描述	必填项
`productType`	上架商品的亚马逊商品类型。类型：串	有帮助
`patches`	对清单项目执行一项或多个 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`	卖家合作伙伴为亚马逊清单提供了标识符。类型：串
`status`	清单商品的提交状态。类型：枚举 (`Status`)
`submissionId`	提交的清单商品的唯一标识符。类型：串
`issues`	与清单商品提交相关的清单商品问题。类型： < `Issue` > 排列
`identifiers`	与亚马逊目录中商品相关的身份属性，例如 ASIN。类型： `ItemIdentifiers`

响应示例

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

❗️
使用条款
下载和使用此 API 提供的数据时，这里的使用条款申请并被用户接受。

Updated 5 days ago

此页面对您有帮助吗？

什么是车辆 API？

本指南中有什么？

术语

教程 1：提供有关 ASIN 的配件信息

先决条件

第 1 步。检索车辆及其 KType 列表

查询参数

请求示例

响应

响应示例

第 2 步。将您的物品映射到 KTypes

第 3 步。使用 Listings API 更新配件

路径参数

查询参数

主体参数

请求示例

响应

响应示例

❗️使用条款

❗️
使用条款