listCatalogItems

自2022年9月30日起，Selling Partner API中Catalog Items v0的listCatalogItems操作将不再可用。作为替代，searchCatalogItems可在最新版本的Catalog Items的Selling Partner API v2022-04-01中使用。依赖于listCatalogItems操作的集成应迁移到searchCatalogItems操作，以避免服务中断。
注意： listCatalogCategories操作不会被弃用，您可以继续调用它。

请求参数

Query 参数

MarketplaceId

string

必需

市场标识符。指定返回项目的市场。

Query

string

可选

在目录中搜索项目的关键词。示例：‘哈利·波特书籍’。

QueryContextId

string

可选

用于标识进行给定搜索的上下文。市场可能提供机制以限制搜索到潜在物品的子集。例如，零售市场允许将查询限制为特定类别。QueryContextId 参数指定这样的子集。如果省略该参数，将使用市场的默认上下文进行搜索，该上下文通常包含最大数量的物品。

SellerSKU

string

可选

用于识别指定市场中的商品。SellerSKU 通过卖家的 SellerId 进行确认，该 SellerId 包含在您提交的每个操作中。

UPC

string

可选

用于零售包装的12位条形码。

EAN

string

可选

一个唯一标识目录项目、制造商及其属性的欧洲文章编号。

ISBN

string

可选

用于国际识别图书的独特商业书籍标识符。

JAN

string

可选

一个独特标识产品、制造商及其属性的日本文章编号。

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

唯一请求参考ID。

可选

Body

payload

object (ListMatchingItemsResponse)

可选

Items

array[object (Item) {4}]

一份物品清单。

可选

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助来电者理解或解决问题的额外信息。

示例

{
  "payload": {
    "Items": [
      {
        "Identifiers": {
          "MarketplaceASIN": {
            "MarketplaceId": "string",
            "ASIN": "string"
          },
          "SKUIdentifier": {
            "MarketplaceId": "string",
            "SellerId": "string",
            "SellerSKU": "string"
          }
        },
        "AttributeSets": [
          {
            "Actor": [
              "string"
            ],
            "Artist": [
              "string"
            ],
            "AspectRatio": "string",
            "AudienceRating": "string",
            "Author": [
              "string"
            ],
            "BackFinding": "string",
            "BandMaterialType": "string",
            "Binding": "string",
            "BlurayRegion": "string",
            "Brand": "string",
            "CeroAgeRating": "string",
            "ChainType": "string",
            "ClaspType": "string",
            "Color": "string",
            "CpuManufacturer": "string",
            "CpuSpeed": {
              "value": 0,
              "Units": "string"
            },
            "CpuType": "string",
            "Creator": [
              {
                "value": "string",
                "Role": "string"
              }
            ],
            "Department": "string",
            "Director": [
              "string"
            ],
            "DisplaySize": {
              "value": 0,
              "Units": "string"
            },
            "Edition": "string",
            "EpisodeSequence": "string",
            "EsrbAgeRating": "string",
            "Feature": [
              "string"
            ],
            "Flavor": "string",
            "Format": [
              "string"
            ],
            "GemType": [
              "string"
            ],
            "Genre": "string",
            "GolfClubFlex": "string",
            "GolfClubLoft": {
              "value": 0,
              "Units": "string"
            },
            "HandOrientation": "string",
            "HardDiskInterface": "string",
            "HardDiskSize": {
              "value": 0,
              "Units": "string"
            },
            "HardwarePlatform": "string",
            "HazardousMaterialType": "string",
            "ItemDimensions": {
              "Height": {
                "value": 0,
                "Units": "string"
              },
              "Length": {
                "value": 0,
                "Units": "string"
              },
              "Width": {
                "value": 0,
                "Units": "string"
              },
              "Weight": {
                "value": 0,
                "Units": "string"
              }
            },
            "IsAdultProduct": true,
            "IsAutographed": true,
            "IsEligibleForTradeIn": true,
            "IsMemorabilia": true,
            "IssuesPerYear": "string",
            "ItemPartNumber": "string",
            "Label": "string",
            "Languages": [
              {
                "Name": "string",
                "Type": "string",
                "AudioFormat": "string"
              }
            ],
            "LegalDisclaimer": "string",
            "ListPrice": {
              "Amount": 0,
              "CurrencyCode": "string"
            },
            "Manufacturer": "string",
            "ManufacturerMaximumAge": {
              "value": 0,
              "Units": "string"
            },
            "ManufacturerMinimumAge": {
              "value": 0,
              "Units": "string"
            },
            "ManufacturerPartsWarrantyDescription": "string",
            "MaterialType": [
              "string"
            ],
            "MaximumResolution": {
              "value": 0,
              "Units": "string"
            },
            "MediaType": [
              "string"
            ],
            "MetalStamp": "string",
            "MetalType": "string",
            "Model": "string",
            "NumberOfDiscs": 0,
            "NumberOfIssues": 0,
            "NumberOfItems": 0,
            "NumberOfPages": 0,
            "NumberOfTracks": 0,
            "OperatingSystem": [
              "string"
            ],
            "OpticalZoom": {
              "value": 0,
              "Units": "string"
            },
            "PackageDimensions": {
              "Height": {
                "value": 0,
                "Units": "string"
              },
              "Length": {
                "value": 0,
                "Units": "string"
              },
              "Width": {
                "value": 0,
                "Units": "string"
              },
              "Weight": {
                "value": 0,
                "Units": "string"
              }
            },
            "PackageQuantity": 0,
            "PartNumber": "string",
            "PegiRating": "string",
            "Platform": [
              "string"
            ],
            "ProcessorCount": 0,
            "ProductGroup": "string",
            "ProductTypeName": "string",
            "ProductTypeSubcategory": "string",
            "PublicationDate": "string",
            "Publisher": "string",
            "RegionCode": "string",
            "ReleaseDate": "string",
            "RingSize": "string",
            "RunningTime": {
              "value": 0,
              "Units": "string"
            },
            "ShaftMaterial": "string",
            "Scent": "string",
            "SeasonSequence": "string",
            "SeikodoProductCode": "string",
            "Size": "string",
            "SizePerPearl": "string",
            "SmallImage": {
              "URL": "string",
              "Height": {
                "value": 0,
                "Units": "string"
              },
              "Width": {
                "value": 0,
                "Units": "string"
              }
            },
            "Studio": "string",
            "SubscriptionLength": {
              "value": 0,
              "Units": "string"
            },
            "SystemMemorySize": {
              "value": 0,
              "Units": "string"
            },
            "SystemMemoryType": "string",
            "TheatricalReleaseDate": "string",
            "Title": "string",
            "TotalDiamondWeight": {
              "value": 0,
              "Units": "string"
            },
            "TotalGemWeight": {
              "value": 0,
              "Units": "string"
            },
            "Warranty": "string",
            "WeeeTaxValue": {
              "Amount": 0,
              "CurrencyCode": "string"
            }
          }
        ],
        "Relationships": [
          {
            "Identifiers": {
              "MarketplaceASIN": {
                "MarketplaceId": "string",
                "ASIN": "string"
              },
              "SKUIdentifier": {
                "MarketplaceId": "string",
                "SellerId": "string",
                "SellerSKU": "string"
              }
            },
            "Color": "string",
            "Edition": "string",
            "Flavor": "string",
            "GemType": [
              "string"
            ],
            "GolfClubFlex": "string",
            "HandOrientation": "string",
            "HardwarePlatform": "string",
            "MaterialType": [
              "string"
            ],
            "MetalType": "string",
            "Model": "string",
            "OperatingSystem": [
              "string"
            ],
            "ProductTypeSubcategory": "string",
            "RingSize": "string",
            "ShaftMaterial": "string",
            "Scent": "string",
            "Size": "string",
            "SizePerPearl": "string",
            "GolfClubLoft": {
              "value": 0,
              "Units": "string"
            },
            "TotalDiamondWeight": {
              "value": 0,
              "Units": "string"
            },
            "TotalGemWeight": {
              "value": 0,
              "Units": "string"
            },
            "PackageQuantity": 0,
            "ItemDimensions": {
              "Height": {
                "value": 0,
                "Units": "string"
              },
              "Length": {
                "value": 0,
                "Units": "string"
              },
              "Width": {
                "value": 0,
                "Units": "string"
              },
              "Weight": {
                "value": 0,
                "Units": "string"
              }
            }
          }
        ],
        "SalesRankings": [
          {
            "ProductCategoryId": "string",
            "Rank": 0
          }
        ]
      }
    ]
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string"
    }
  ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应