Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Satış Ortağı API'si ile Ürün Listelerini Yönetme

SP-API kullanarak ürün listeleme yaşam döngünüzü yönetin.

Bu kılavuzda Amazon'daki listelerin yaşam döngüsü ve bunları yönetmek için kullanılabilecek Satış Ortağı API'leri açıklanmaktadır.

Ürün listeleri yaşam döngüsü

Amazon'da liste oluşturma ve yönetme yaşam döngüsü genellikle aşağıdakileri içerir:

  1. Keşif
    • Amazon'un kataloğunda satmak istediğim ürün zaten var mı?
    • Öğem Amazon'un katalog hiyerarşisine nereye sığar?
    • Amazon kataloğunda öğeler oluşturmak için neler gereklidir?
    • Amazon kataloğundaki öğeleri listelemeye uygun muyum?
  2. Yaratılış
    • Yeni bir öğe oluşturmak veya mevcut bir öğeyi listelemek için veri gereksinimlerini karşıladım mı?
    • Gönderim kabul edildi mi?
  3. Bakım
    • Kaydımın durumu nedir? Satın alınabilir mi? Keşfedilebilir mi?
    • Kaydımla ilgili herhangi bir sorunum var mı?
    • Kayıtım Amazon veri gereksinimlerini karşılamaya devam ediyor mu?

Ürün Listeleri için İş Ortağı API'lerini Satmak

Aşağıdaki Satış Ortağı API'leri ürün listelerinizi yönetmenize yardımcı olabilir:

Bu API'ler, liste kaydı oluşturmak ve yönetmek için kullanabileceğiniz aşağıdaki temel özellikleri sağlar:

  • Amazon kataloğundaki (ASIN'ler) verileri sorgulama.
  • Amazon'un katalog hiyerarşisini (sınıflandırmalar, ürün kategorisi arama kodları) sorgulama ve hiyerarşide dolaşma.
  • Ürün türüne göre Amazon veri gereksinimlerini açıklayan şemaları alma.
  • ASIN veya ürün türüne göre liste kayıtlarının uygunluk bilgilerini alma.
  • Liste kayıtları (SKU) oluşturma, sorgulama, güncelleme ve silme.

Bu API'ler, ayrıca üçüncü taraf geliştiricilere ve satıcılara olay odaklı iş akışlarını etkinleştiren programatik bildirimler sağlar.

Ürün Türü Tanımları API'si

Ürün Türü Tanımları için Satış Ortağı API'si Amazon kataloğundaki ürün türleri için öznitelik ve veri gereksinimlerine programlı erişim sağlar. Bu API ile, belirli bir pazardaki bir ürün türü için gereksinimler talep edersiniz ve tüm gereksinimleri, nitelikleri ve gereksinimlerin koşulluluğunu açıklayan bir JSON şeması içeren yanıtlar alırsınız. Bu JSON şemasını, halihazırda sahip olduğunuz yükü doğrulamak veya ERP'lerinizle (Kurumsal Kaynak Planlaması) eşlemek için kullanabilirsiniz.

Aşağıdaki örnek şunları kullanır: getDefinitionsProductType talep etme işlemi LUGGAGE Amerikan İngilizcesinde NA pazarındaki ürün türü:

GET https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes/LUGGAGE ?marketplaceIds=ATVPDKIKX0DER &locale=en_US

Bu örnekte ise yukarıdaki isteğe verilen yanıt ile LUGGAGE liste kaydı için sunulan ProductTypeDefinition yer alıyor:

{ "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 } }

Akışlar JSON Şemaları

Kullanma JSON Şemalarını Besler tek tek listeleri toplu olarak güncelleyebilirsiniz. Bu şemalar aşağıdakilerle çalışır Ürün Türü Tanımları API'si ve entegratörlerin, Listing Items API'si tarafından kullanılan aynı veri biçiminde Amazon listelerini (SKU'lar) oluşturmasına, düzenlemesine ve silmesine izin verin. Listeler verileri, Listeleme Öğeleri API'si ile birlikte çalışabilir JSON_LISTINGS_FEED feed türü, satış ortaklarının listeleme iş akışları için en uygun mekanizmayı veya kombinasyonu kullanmalarına olanak tanır.

Listings Items API

Listeleme Öğeleri için Satış Ortağı API'si Amazon'da satış ortağı listelerine programlı erişim sağlar. Bu API ile listelerinizi bireysel olarak oluşturabilir ve düzenleyebilirsiniz. Dört işlemi vardır:

  • putListingsItem belirli bir SKU oluşturmanıza ve fiyat, envanter veya her ikisi gibi özellikleri güncellemenize olanak tanır.

  • patchListingsItem belirli bir SKU'nun niteliklerini güncellemenizi sağlar.

  • deleteListingsItem belirli bir SKU'yu silmenizi sağlar.

  • getListingsItem belirli bir SKU hakkında bilgi döndürür.

JSON listeleri beslemesi yeni bir feed türüdür. JSON listeleri beslemesi, toplu olarak güncelleme yapmanıza, şemayı almak için Ürün Türü Tanımları API'sini kullanmanıza ve bir yük oluşturmanıza olanak sağlaması bakımından Listeleme API'sine benzer. Bu yük, Listeleme Öğeleri API'sine veya toplu olarak JSON listeleme akışına gönderilebilir.

Aşağıdaki örnek şunları kullanır: getListingsItem bir talep etme işlemi Item bir satıcıdan sellerId dan AXXXXXXXXXXXX NA pazarında Amerikan İngilizcesi. İstiyor summaries, attributes, issues, offers, ve fulfillmentAvailability içinde olmak Item cevapta:

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

Bu talebin cevabı bir Item ile summaries, attributes, issues, offers, ve 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.

Aşağıdaki örnek şunları kullanır: getCatalogItem ASIN ile bir öğe isteme işlemi XXXXXXXXXX NA pazarında. Bir cevap ile talep eder. Item İçeren attributes, identifiers, images, productTypes, salesRanks, summaries, variations, ve vendorDetails:

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/XXXXXXXXXX ?marketplaceIds=ATVPDKIKX0DER &includedData=attributes,identifiers,images,productTypes,salesRanks,summaries,variations,vendorDetails

Bu talebe verilen yanıt şunları içerir: Item istenen tüm bilgilerle:

{ "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

Bildirimler için Satış Ortağı API'si bir satış ortağının işiyle ilgili çeşitli bildirimlere abone olmanızı sağlar. Aşağıdaki bildirimler, öğeleri listelemek için yararlı bilgiler sağlar:

  • ITEM_PRODUCT_TYPE_CHANGE: Satış ortağının marka ilişkisi olduğu herhangi bir ürünün ürün türünde bir değişiklik olduğunda gönderilir.
  • LISTINGS_ITEM_STATUS_CHANGE: Bir satış ortağı için bir liste öğesinin durumu değiştiğinde gönderilir. Bu bildirim, bir liste öğesi oluşturulduğunda, silindiğinde veya satın alınabilirliği değiştiğinde yayınlanır.
  • LISTINGS_ITEM_ISSUES_CHANGE: Satış ortağının sahip olduğu bir liste öğesiyle ilişkili sorunlarda değişiklik olduğunda gönderilir. Sorunlar, liste öğesinin listelerin etkin olmamasına, arama engellemesine veya diğer kalite sorunlarına neden olan sorunlara sahip olduğunu gösterir.
  • PRODUCT_TYPE_DEFINITIONS_CHANGE: Yeni bir ürün türü veya ürün tipi sürümü olduğunda gönderilir.

Bildirimlere abone olma hakkında daha fazla bilgi için bkz. Bildirimler Kullanım Örneği Kılavuzu ve createSubscription operasyon.


Bu sayfa size yardımcı oldu mu?