getDefinitionsProductType

检索亚马逊产品类型定义。

使用计划：

计划类型	速率（每秒请求次数）	突发
默认	5	10
特定于销售合作伙伴	可变	可变

x-amzn-RateLimit-Limit 响应头返回应用于请求操作的使用计划速率限制。一些销售合作伙伴的速率限制将与上述表格中的默认速率和突发次数不同。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

productType

string

必需

亚马逊产品类型名称。

示例值:

LUGGAGE

Query 参数

sellerId

string

可选

销售合作伙伴标识符。当提供时，卖家特定的要求和值会在产品类型定义模式中填充，例如与销售合作伙伴相关的品牌名称。

marketplaceIds

array[string]

必需

请求的亚马逊市场标识符的以逗号分隔的列表。注意：此参数目前仅限于一个 marketplaceId。

示例值:

ATVPDKIKX0DER

productTypeVersion

string

可选

要检索的亚马逊产品类型的版本。默认为“LATEST”。可以通过“RELEASE_CANDIDATE”检索产品类型定义的预发布版本。如果当前没有可用的预发布版本，将提供“LATEST”实时版本。

默认值:

LATEST

示例值:

LATEST

requirements

enum<string>

可选

检索要求的要求集的名称。

枚举值:

LISTINGLISTING_PRODUCT_ONLYLISTING_OFFER_ONLY

默认值:

LISTING

示例值:

LISTING

requirementsEnforced

enum<string>

可选

确定产品类型定义模式是否强制执行需求集所需的属性。未强制执行的要求允许在没有所有所需属性存在的情况下对单个属性进行结构验证（例如，对于部分更新）。

枚举值:

ENFORCEDNOT_ENFORCED

默认值:

ENFORCED

示例值:

ENFORCED

locale

enum<string>

可选

用于检索显示标签和其他呈现细节的语言环境。默认为请求中第一个市场的默认语言。

枚举值:

DEFAULTarar_AEdede_DEenen_AEen_AUen_CAen_GBen_INen_SGen_USeses_ESes_MXes_USfrfr_CAfr_FRitit_ITjaja_JPnlnl_NLplpl_PLptpt_BRpt_PTsvsv_SEtrtr_TRzhzh_CNzh_TW

默认值:

DEFAULT

示例值:

DEFAULT

返回响应

🟢200成功

application/json

成功获取了亚马逊产品类型定义。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

产品类型定义表示亚马逊目录中产品类型的属性和数据要求。产品类型定义在销货合作伙伴API的商品列表、销货合作伙伴API的目录商品和销货合作伙伴API的列表数据的JSON基础供给之间互换使用。

metaSchema

object (SchemaLink)

可选

link

object

获取模式的链接。

必需

checksum

string

必需

模式的校验和哈希值（Base64 MD5）。可用于验证模式内容、识别模式版本之间的变化以及进行缓存。

schema

object (SchemaLink)

必需

requirements

enum<string>

必需

该产品类型定义中表示的需求集名称。

枚举值:

LISTINGLISTING_PRODUCT_ONLYLISTING_OFFER_ONLY

requirementsEnforced

enum<string>

必需

识别产品类型定义架构是否强制所需属性集的要求。非强制要求允许在不需要所有必需属性的情况下对单个属性进行结构验证（例如，对于部分更新）。

枚举值:

ENFORCEDNOT_ENFORCED

propertyGroups

object

必需

属性组名称与属性组的映射。属性组表示可以用于显示或信息目的的模式属性的逻辑分组。

额外字段

object (PropertyGroup)

可选

属性组表示架构属性的逻辑分组，可以用于显示或信息目的。

locale

string

必需

产品类型定义中包含的显示元素的区域设置。

marketplaceIds

array[string]

必需

适用于产品类型定义的亚马逊市场标识符。

productType

string

必需

此产品类型定义适用于的亚马逊产品类型名称。

displayName

string

必需

易于理解且本地化的亚马逊产品类型描述。

productTypeVersion

object (ProductTypeVersion)

必需

Amazon 产品类型的版本详细信息。

version

string

版本标识符。

必需

latest

boolean

必需

当为真时，由版本标识符指示的版本是适用于亚马逊产品类型的最新版本。

releaseCandidate

boolean

可选

当为真时，由版本标识符指示的版本是亚马逊产品类型的预发布版本（候选版本）。

示例

{
  "metaSchema": {
    "link": {
      "resource": "https://meta-schema-url",
      "verb": "GET"
    },
    "checksum": "c7af9479ca7261645cea9db56c5f720d"
  },
  "schema": {
    "link": {
      "resource": "https://schema-url",
      "verb": "GET"
    },
    "checksum": "c7af9479ca7261645cea9db56c5f720d"
  },
  "requirements": "LISTING",
  "requirementsEnforced": "ENFORCED",
  "propertyGroups": {
    "product_identity": {
      "title": "Product Identity",
      "description": "唯一识别您产品的信息（例如，UPC、EAN、GTIN、产品类型、品牌）",
      "propertyNames": [
        "item_name",
        "brand",
        "external_product_id",
        "gtin_exemption_reason",
        "merchant_suggested_asin",
        "product_type",
        "product_category",
        "product_subcategory",
        "item_type_keyword"
      ]
    }
  },
  "locale": "en_US",
  "marketplaceIds": [
    "ATVPDKIKX0DER"
  ],
  "productType": "LUGGAGE",
  "displayName": "Luggage",
  "productTypeVersion": {
    "version": "UHqSqmb4FNUk=",
    "latest": true,
    "releaseCandidate": false
  }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应