Selling Partner APIによる商品出品の管理
SP-APIを使用して商品リストのライフサイクルを管理します。
このガイドでは、Amazonの出品のライフサイクルと、その管理に使用できる販売パートナーAPIについて説明します。
商品リストのライフサイクル
Amazonでの出品情報の作成と管理のライフサイクルには、通常、以下が含まれます。
- ディスカバリー
- Amazonのカタログには、販売したい商品がすでにありますか?
- 私の商品はAmazonのカタログ階層のどこに当てはまりますか?
- Amazonカタログに商品を作成するには何が必要ですか?
- Amazonカタログに商品を出品する資格はありますか?
- 作成
- 新しい商品を作成したり、既存の商品を出品したりするためのデータ要件を満たしていますか?
- 私の投稿は受理されましたか?
- メンテナンス
- 私のリスティングの状態はどうなっていますか?購入可能ですか?見つけられますか?
- リスティングに関連して何か問題はありますか?
- 私のリストは引き続きAmazonのデータ要件を満たしていますか?
商品リスト用の販売パートナーAPI
次の販売パートナーAPIは、商品リストの管理に役立ちます。
- 製品タイプ定義 API: 商品を出品するための要件を取得します。
- リスティング API: リストの作成と管理。
- カタログアイテム API: カタログの内容をご覧ください。
- 通知 API: リスティングに関する最新情報を受け取る。
これらのAPIは、出品の作成と管理のための以下のコア機能を提供します。
- Amazonカタログ(ASIN)のデータのクエリ。
- Amazonのカタログ階層(分類、ブラウズノード)のクエリとトラバース。
- 商品タイプ別にAmazonのデータ要件を記述したスキーマの取得。
- ASINまたは商品タイプ別の出品資格の詳細の取得。
- 出品(SKU)の作成、検索、更新、および削除。
これらのAPIはプログラムによる通知も提供し、サードパーティの開発者や出品者向けのイベント駆動型ワークフローを可能にします。
商品タイプ定義API
ザ・ 商品タイプ定義用の販売パートナー API Amazon カタログの商品タイプの属性とデータ要件にプログラムでアクセスできます。この API を使用すると、特定のマーケットプレイスにおける商品タイプの要件をリクエストすると、すべての要件、属性、要件の条件を記述した JSON スキーマを含む応答を受け取ることができます。この JSON スキーマを使用して、すでに持っているペイロードを検証したり、ERP (エンタープライズ・リソース・プランニング) にマッピングしたりすることができます。
次の例ではを使用しています getDefinitionsProductType
をリクエストするオペレーション LUGGAGE
NA マーケットプレイスの商品タイプ (アメリカ英語):
GET https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes/LUGGAGE
?marketplaceIds=ATVPDKIKX0DER
&locale=en_US
次の例は、上記のリクエストに対するレスポンスを示し、ProductTypeDefinition
(LUGGAGE
出品)を定めています。
{
"metaSchema": {
"link": {
"resource": "https://...",
"verb": "GET"
},
"checksum": "QFQDmPwMARO7vwMEyLhOtw=="
},
"schema": {
"link": {
"resource": "https://...",
"verb": "GET"
},
"checksum": "TBr8ubaxXrUyay9hmxUXUw=="
},
"requirements": "LISTING",
"requirementsEnforced": "ENFORCED",
"propertyGroups": {
"offer": {
"title": "Offer",
"description": "Product Offer",
"propertyNames": [
"fulfillment_channel_availability",
"purchasable_offer",
"condition_type",
"condition_note",
"list_price",
"product_tax_code",
"merchant_release_date",
"merchant_shipping_group",
"max_order_quantity",
"gift_options",
"main_offer_image_locator",
"other_offer_image_locator_1",
"other_offer_image_locator_2",
"other_offer_image_locator_3",
"other_offer_image_locator_4",
"other_offer_image_locator_5"
]
},
"images": {
"title": "Images",
"description": "Physical imagess or URL's",
"propertyNames": [
"main_product_image_locator",
"other_product_image_locator_1",
"other_product_image_locator_2",
"other_product_image_locator_3",
"other_product_image_locator_4",
"other_product_image_locator_5",
"other_product_image_locator_6",
"other_product_image_locator_7",
"other_product_image_locator_8",
"swatch_product_image_locator"
]
},
"shipping": {
"title": "Shipping",
"description": "Information to determine shipping and storage of your product (e.g., package dimensions, weight, volume)",
"propertyNames": [
"item_dimensions",
"item_package_dimensions",
"item_package_weight"
]
},
"variations": {
"title": "Variations",
"description": "Variations that product will use",
"propertyNames": [
"parentage_level",
"child_parent_sku_relationship",
"variation_theme"
]
},
"safety_and_compliance": {
"title": "Safety & Compliance",
"description": "Information to indicate product compliance, hazardous materials, and legal and safety warnings (e.g., lithium batteries, choking hazards, Consumer Product Safety Information Act (CPSIA))",
"propertyNames": [
"country_of_origin",
"warranty_description",
"batteries_required",
"batteries_included",
"battery",
"num_batteries",
"number_of_lithium_metal_cells",
"number_of_lithium_ion_cells",
"lithium_battery",
"supplier_declared_dg_hz_regulation",
"hazmat",
"safety_data_sheet_url",
"item_weight",
"ghs",
"supplier_declared_material_regulation",
"california_proposition_65",
"pesticide_marking"
]
},
"product_identity": {
"title": "Product Identity",
"description": "Information to uniquely identify your product (e.g., UPC, EAN, GTIN, Product Type, Brand)",
"propertyNames": [
"item_name",
"brand",
"supplier_declared_has_product_identifier_exemption",
"externally_assigned_product_identifier",
"merchant_suggested_asin",
"item_type_keyword",
"item_type_name",
"model_number",
"manufacturer"
]
},
"product_details": {
"title": "Product Details",
"description": "Information and characteristics to describe the product to support search, browse and detail page content (e.g., bullets, product features, model, style name)",
"propertyNames": [
"product_description",
"bullet_point",
"special_feature",
"style",
"department",
"target_gender",
"age_range_description",
"material",
"outer",
"fabric_type",
"lining_description",
"number_of_items",
"number_of_wheels",
"wheel",
"model_name",
"color",
"size",
"size_map",
"part_number",
"compliance_media"
]
}
},
"locale": "en_US",
"marketplaceIds": [
"ATVPDKIKX0DER"
],
"productType": "LUGGAGE",
"productTypeVersion": {
"version": "U8L4z4Ud95N16tZlR7rsmbQ==",
"latest": true,
"releaseCandidate": false
}
}
フィードのJSONスキーマ
を使う JSON スキーマをフィードします 個々の出品情報をまとめて更新できます。これらのスキーマは以下と連動します。 製品タイプ定義 API また、インテグレーターは Listings Items API で使用されるのと同じデータ形式で Amazon リスティング (SKU) を作成、編集、削除できます。出品データは、出品商品APIと出品商品APIとの間で相互運用可能です。 JSON_LISTINGS_FEED
フィードタイプ。販売パートナーは出品ワークフローに最適なメカニズムや組み合わせを使用できます。
Listings Items API
ザの 出品商品用の販売パートナー API Amazon の出品パートナーリストにプログラム経由でアクセスできます。このAPIを使用すると、出品情報を個別に作成、編集できます。次の 4 つの操作があります。
-
putListingsItem
特定の SKU を作成し、価格、在庫、またはその両方などの属性を更新できます。 -
patchListingsItem
特定の SKU の項目を更新できます。 -
deleteListingsItem
特定の SKU を削除できます。 -
getListingsItem
特定の SKU に関する情報を返します。
JSON リストフィードは新しいフィードタイプです。JSON リストフィードは、一括更新、商品タイプ定義 API を使用してスキーマを取得し、ペイロードをまとめることができるという点で Listings API に似ています。このペイロードは、出品商品 API に送信することも、JSON 出品フィードに一括送信することもできます。
次の例ではを使用しています getListingsItem
をリクエストするオペレーション Item
のついた出品者から sellerId
の AXXXXXXXXXXXX
アメリカ英語の NA マーケットプレイスで。リクエストします summaries
、 attributes
、 issues
、 offers
、および fulfillmentAvailability
その中にいること Item
レスポンスでは:
GET https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXX/example-sku
?marketplaceIds=ATVPDKIKX0DER
&issueLocale=en_US
&includedData=summaries,attributes,issues,offers,fulfillmentAvailability
このリクエストに対するレスポンスは Item
と summaries
、 attributes
、 issues
、 offers
、および fulfillmentAvailability
:
{
"sku": "example-aku",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asin": "XXXASINXXX",
"productType": "DRINKING_CUP",
"conditionType": "new_new",
"status": [
"BUYABLE",
"DISCOVERABLE"
],
"itemName": "6 Pack Coffee Mug Set, Farielyn-X 16 Ounce Ceramic Coffee Cups, Black Large Coffee mugs, Restaurant Coffee Cups for Coffee, Tea, Cappuccino, Cocoa, Cereal, Matte Black Outside and Colorful Inside",
"createdDate": "2021-07-14T19:57:02.327Z",
"lastUpdatedDate": "2021-07-14T19:57:10.637Z",
"mainImage":
{
"link": "https://m.media-amazon.com/images/I/41epVg7mZoS.jpg",
"height": 500,
"width": 500
}
}
],
"attributes":
{
"condition_type": [
{
"value": "new_new",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"merchant_shipping_group": [
{
"value": "legacy-template-id",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"merchant_suggested_asin": [
{
"value": "XXXASINXXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"purchasable_offer": [
{
"currency": "USD",
"start_at":
{
"value": "2021-07-14T19:56:57.717Z"
},
"our_price": [
{
"schedule": [
{
"value_with_tax": 30.0
}
]
}
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": 1,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"main_product_image_locator": [
{
"media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxx1.jpg",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"other_product_image_locator_1": [
{
"media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx2.jpg",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"other_product_image_locator_2": [
{
"media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx3.jpg",
"marketplace_id": "ATVPDKIKX0DER"
}
]
},
"issues": [
{
"message": "Attributes tagged as relevant_attributes are incomplete. Provide values for the following attribute(s): item_weight, theme, item_dimensions, item_diameter",
"severity": "WARNING",
"attributeName": "item_diameter",
"attributeNames": [
"item_diameter",
"item_dimensions",
"item_weight",
"theme"
]
},
{
"message": "Attributes tagged as customer_returns are incomplete. Provide values for the following attribute(s): color, item_dimensions, item_weight",
"severity": "WARNING",
"attributeName": "color",
"attributeNames": [
"color",
"item_dimensions",
"item_weight"
]
}
],
"offers": [
{
"marketplaceId": "ATVPDKIKX0DER",
"offerType": "B2C",
"price":
{
"currency": "USD",
"amount": "30.0"
}
}
],
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 1
}
]
}
Catalog Items API
The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon catalog. In other words, you can search Amazon's catalog for products, match your products to the existing product listings on Amazon, and then make sourcing and pricing decisions for listing those products.
次の例ではを使用しています getCatalogItem
ASIN を含む商品をリクエストするオペレーション XXXXXXXXXX
NA マーケットプレイスで。次のような応答をリクエストします。 Item
それには以下が含まれます attributes
、 identifiers
、 images
、 productTypes
、 salesRanks
、 summaries
、 variations
、および vendorDetails
:
GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/XXXXXXXXXX
?marketplaceIds=ATVPDKIKX0DER
&includedData=attributes,identifiers,images,productTypes,salesRanks,summaries,variations,vendorDetails
このリクエストに対するレスポンスには Item
要求された情報をすべて含めて:
{
"asin": "XXXXXXXXXX",
"attributes": {
"total_hdmi_ports": [
{
"value": 4,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"resolution": [
{
"language_tag": "en_US",
"value": "4K",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_weight": [
{
"unit": "pounds",
"value": 107.6,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_subcategory": [
{
"value": "50400150",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_dimensions": [
{
"width": {
"unit": "inches",
"value": 72.4
},
"length": {
"unit": "inches",
"value": 2.4
},
"height": {
"unit": "inches",
"value": 41.4
},
"marketplace_id": "ATVPDKIKX0DER"
}
],
"brand": [
{
"language_tag": "en_US",
"value": "Samsung Electronics",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"control_method": [
{
"value": "voice",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_package_dimensions": [
{
"length": {
"unit": "centimeters",
"value": ###
},
"width": {
"unit": "centimeters",
"value": ###
},
"height": {
"unit": "centimeters",
"value": ###
},
"marketplace_id": "ATVPDKIKX0DER"
}
],
"image_aspect_ratio": [
{
"language_tag": "en_US",
"value": "##:#",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"part_number": [
{
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"includes_remote": [
{
"value": true,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_type_name": [
{
"language_tag": "en_US",
"value": "TV",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"battery": [
{
"cell_composition": [
{
"value": "XXX"
}
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"manufacturer": [
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"number_of_boxes": [
{
"value": #,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"total_usb_ports": [
{
"value": #,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"model_number": [
{
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"num_batteries": [
{
"quantity": 2,
"type": "aaa",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"california_proposition_65": [
{
"compliance_type": "on_product_combined_cancer_reproductive",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"compliance_type": "chemical",
"chemical_names": [
"xxx"
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"display": [
{
"resolution_maximum": [
{
"unit": "pixels",
"language_tag": "en_US",
"value": "XX x XX"
}
],
"size": [
{
"unit": "inches",
"value":##
}
],
"type": [
{
"language_tag": "en_US",
"value": "****"
}
],
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_name": [
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"list_price": [
{
"currency": "USD",
"value": $$$,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"batteries_required": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"includes_rechargable_battery": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_site_launch_date": [
{
"value": "2019-03-11T08:00:01.000Z",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"product_category": [
{
"value": "50400100",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"batteries_included": [
{
"value": false,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"connectivity_technology": [
{
"language_tag": "en_US",
"value": "Bluetooth",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "USB",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Wireless",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "HDMI",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"included_components": [
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"specification_met": [
{
"language_tag": "en_US",
"value": "",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"cpsia_cautionary_statement": [
{
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_type_keyword": [
{
"value": "XXX",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"number_of_items": [
{
"value": 1,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"warranty_description": [
{
"language_tag": "en_US",
"value": "1 year manufacturer",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"max_resolution": [
{
"unit": "pixels",
"value": 8.3,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"item_package_weight": [
{
"unit": "kilograms",
"value": 62.142,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"supported_internet_services": [
{
"language_tag": "en_US",
"value": "Amazon Instant Video",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "YouTube",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Netflix",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Hulu",
"marketplace_id": "ATVPDKIKX0DER"
},
{
"language_tag": "en_US",
"value": "Browser",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"tuner_technology": [
{
"language_tag": "en_US",
"value": "Analog Tuner",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"wireless_communication_technology": [
{
"language_tag": "en_US",
"value": "Wi-Fi::Wi-Fi Direct::Bluetooth",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"model_year": [
{
"value": 2019,
"marketplace_id": "ATVPDKIKX0DER"
}
],
"power_source_type": [
{
"language_tag": "en_US",
"value": "Corded Electric",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"street_date": [
{
"value": "2019-03-21T00:00:01Z",
"marketplace_id": "ATVPDKIKX0DER"
}
],
"refresh_rate": [
{
"unit": "hertz",
"language_tag": "en_US",
"value": "120",
"marketplace_id": "ATVPDKIKX0DER"
}
]
},
"identifiers": [
{
"marketplaceId": "ATVPDKIKX0DER",
"identifiers": [
{
"identifier": "0887276302195",
"identifierType": "EAN"
},
{
"identifier": "00887276302195",
"identifierType": "GTIN"
},
{
"identifier": "887276302195",
"identifierType": "UPC"
}
]
}
],
"images": [
{
"marketplaceId": "ATVPDKIKX0DER",
"images": [
{
"variant": "MAIN",
"link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
"height": 333,
"width": 500
}
]
}
],
"productTypes": [
{
"marketplaceId": "ATVPDKIKX0DER",
"productType": "TELEVISION"
}
],
"ranks": [
{
"marketplaceId": "ATVPDKIKX0DER",
"ranks": [
{
"title": "Electronics",
"link": "http://www.amazon.com/gp/bestsellers/electronics",
"value": 61667
},
{
"title": "QLED TVs",
"link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011",
"value": 84
}
]
}
],
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Samsung Electronics",
"colorName": "Black",
"itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
"manufacturer": "Samsung",
"modelNumber": "QN82Q60RAFXZA",
"sizeName": "82-Inch",
"styleName": "TV only"
}
],
"variations": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asins": [
"B08J7TQ9FL"
],
"variationType": "CHILD"
}
],
"vendorDetails": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandCode": "SAMF9",
"categoryCode": "50400100",
"manufacturerCode": "SAMF9",
"manufacturerCodeParent": "SAMF9",
"productGroup": "Home Entertainment",
"replenishmentCategory": "OBSOLETE",
"subcategoryCode": "50400150"
}
]
}
Notifications API
ザの 通知用の販売パートナー API 販売パートナーのビジネスに関連するさまざまな通知を購読できます。次の通知は、商品の出品に役立つ情報を提供します。
ITEM_PRODUCT_TYPE_CHANGE
: 販売パートナーがブランド関係にある商品の商品タイプに変更があった場合に送信されます。LISTINGS_ITEM_STATUS_CHANGE
: 出品パートナーの出品商品のステータスが変化したときに送信されます。この通知は、出品商品が作成または削除されたとき、または購入可能性が変更されたときに発行されます。LISTINGS_ITEM_ISSUES_CHANGE
: 販売パートナーが所有している出品商品に関連する問題に変更があった場合に送信されます。問題により、出品商品に問題があり、出品が停止されたり、検索が停止されたり、その他の品質問題が発生したことが指摘されます。PRODUCT_TYPE_DEFINITIONS_CHANGE
: 新しい製品タイプまたは製品タイプバージョンがある場合に送信されます。
通知の購読の詳細については、を参照してください。 通知ユースケースガイド そして createSubscription
オペレーション。
Updated 23 days ago