什么是列表限制API？

使用Listings Restrictions的Selling Partner API(Listings Restrictions API)，您可以检查是否存在阻止在亚马逊目录中为某个商品创建listing的限制.如果某个商品被限制，您可能会采取额外的步骤来请求批准创建listing.请参阅Listings Restrictions API Reference (opens new window)，了解有关API操作和相关数据类型和模式的详细信息.

将房源限制API与房源项目API结合起来使用. 例如，你可以首先使用房源限制API确定是否存在房源限制. 如果不存在限制，你就可以调用房源项目API来创建仅有offer-的房源. 请参阅房源项目API参考 (opens new window)，了解关于房源项目API的更多信息.

主要特点

• 列表限制API提供了关于列表限制的详细信息，如果有的话，在一个由ASIN.标识的现有目录项目上
• 你可以根据条件类型选择性地过滤限制.
• 列表限制API支持在一次调用中检查多个市场的列表限制.
• 当需要批准时，上市限制API会返回下一步的链接，这样你就可以寻求批准来创建上市.

术语

ASIN: 亚马逊标准识别码，用于识别亚马逊目录中的物品.

清单: 亚马逊清单是销售伙伴在亚马逊上列出销售的商品，并由库存单位(SKU).包含在亚马逊清单中的产品事实被调和到亚马逊目录中的商品，由亚马逊标准识别码(ASINs)识别

限制条件限制是指阻止创建清单的条件.在某些情况下，限制是由于批准要求，在这种情况下，可能有额外的步骤来申请批准.

Tutorial获取目录中某物品的列表限制

使用本教程来检索亚马逊目录中现有物品的任何上市限制.

先决条件

要完成本教程，你需要

*来自您为之调用的销售伙伴的授权.更多信息请参见销售伙伴API开发者指南 (opens new window)

• 分配给你的开发者档案的产品列表角色.
  
• 在应用程序注册页面中为您的应用程序选择的产品列表角色.
  
• 对Selling Partner API的基本了解.参见Selling Partner API Developer Guide (opens new window)了解更多信息.

步骤1 -获取亚马逊目录中某个商品的列表限制

调用getListingsRestrictions (opens new window)操作来返回任何列表限制，并传递以下参数

查询参数

Parameter	实例	Description	要求
asin	B0000ASIN1	该商品的亚马逊标准识别码(ASIN). 类型: string	是的
conditionType	used_very_good	The condition used to filter restrictions. Type: enum(ConditionType)	没有
sellerid	AXXXXXXXXXXX	一个销售伙伴的标识符，如商家账户. 类型: string	是的
marketplaceIds	ATVPDKIKX0DER	Comma-delimited list of Amazon marketplace identifiers for the request. See the Selling Partner API Developer Guide for the list of Amazon marketplace identifiers. Type: < string > array(csv)	是的
reasonLocale	en_US	A locale for reason text localization.当没有提供时，将使用第一个市场的默认语言代码.例子en_US, fr_CA, fr_FR.当指定的地区没有本地化时，本地化的信息默认为en_US. Type: string	No

示例请求

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/restrictions
   ?asin=B08XXLG119
   &conditionType=条件类型
   &sellerId=AXXXXXXXXXXX
   &marketplaceIds=ATVPDKIKX0DER

响应

一个成功的响应会返回所有适用的限制信息，如果有的话. 如果在指定的市场中没有对指定的条件类型(提供的限制)，响应中的限制列表将是空的.

如果在指定的市场中对指定的条件类型(when provided)存在限制，评估响应中的reasons数组，以确定原因并确定下一步，如果有的话. 每个原因都有一个reasonCode (opens new window)，说明为什么该列表被限制.

需要批准时

亚马逊要求销售伙伴在列出某些商品进行销售之前获得批准.批准过程可能包括各种批准要求和资格.如果响应中的reasonCode表明需要批准，销售伙伴可能会申请批准列出该商品.

在这种情况下，使用响应中链接数组中的信息，指示销售伙伴导航到所提供的URL链接，然后按照那里的指示申请批准上市.

一个成功的响应包括以下内容

Name	Example	Description
restrictions	参见响应示例	A list of restrictions for the specified Amazon catalog item. Type: < Restriction > array

示例响应 (无限制)

{
  "限制": [
    {
    }
  ]
}

示例响应(限制条件存在)

{
  "限制": [
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_like_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "new_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你需要批准才能列出."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_acceptable",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_like_new",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_very_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_very_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_acceptable",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "collectible_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "used_good",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "atvpdkikx0der",
      "conditionType": "refurbished_refurbished",
      "原因": [
        {
          "reasonCode": "approval_required",
          "消息": "你不能在这个条件下列出产品."
          "链接": [
            {
              "资源": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119"
              "verb": "GET",
              "标题": "通过卖方中心请求批准."
              "类型": "text/html"
            }
          ]
        }
      ]
    }
  ]
}