Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek
Aramak için yazmaya başlayın…

Araçlar API v2024-11-01 Kullanım Örneği Kılavuzu

Araçlar API'si nasıl kullanılır.

API Sürümü: 2020-11-01

Araçlar API'si nedir?

Araçlar için Satış Ortağı API'si (Araçlar API'si) ile, benzersiz tanımlayıcıları da dahil olmak üzere araçlar hakkında bilgi alabilirsiniz. Listelenen ASIN'ler için Listeler API'si ile uyumluluk bilgileri sağlamak için bu bilgileri kullanabilirsiniz.

Araç montaj bilgisi gerektiren öğeler, araç K Tiplerinin bir listesini gerektirir. Bu API, kataloğunuzdaki her öğeyi bağımsız olarak bir KType listesine eşlemek için kullanabileceğiniz araçların ve KTYPE'lerinin bir listesini sağlar. Bu eşleme daha sonra Listeleme API'si kullanılarak Amazon'a sağlanabilir.

Bu kılavuzda neler var?

Bu kılavuzda aşağıdakilerin nasıl yapılacağı açıklanmaktadır:

  • Araçların en son listesini almak için Araçlar API'sini kullanın.
  • Listeleme API'sini kullanarak bir ASIN için montaj bilgilerini güncelleyin.

Terminoloji

  • ASIN: Amazon kataloğundaki ürünleri tanımlayan Amazon Standart Kimlik Numarası.
  • K TİPİ: Bir araç tanımıyla ilişkili (marka, model, tür, yıl) ve çeşitli markalar tarafından ürünlerini bağlamak için kullanılan sayısal bir tanımlayıcı.

Eğitim 1: ASIN'lerle ilgili donanım bilgileri sağlayın

Kataloğunuzdaki öğeler için uyumluluk bilgileri sağlayın.

Ön koşullar

Bu eğitici içeriği tamamlamak için şunlara ihtiyacınız olacak:

Adım 1. Araçların ve KTiplerinin listesini al

Araçların listesini almak için arayın getVehicles operasyon.

Sorgu parametreleri

AdAçıklamaZorunlu mu?
marketplaceIdKaynağın çalıştığı pazar yeri için bir tanımlayıcı. Bir pazar yerinin kimliğini bulmak için bkz. Pazar yeri kimlikleri.
Türü: dizi		Evet
vehicleTypeAraç tipi. Olası değerler CAR ve MOTORBIKE.
Türü: enum (VehicleType)		Evet
pageTokenBir sonraki sayfayı veya önceki sonuç sayfasını almak için kullanabileceğiniz bir belirteç. Yanıt şunları içerir: pagination sonuç sayısı sayfa boyutunu aştığında. Bir sonraki sonuç sayfasını almak için işlemi şu şekilde arayın nextToken ve belirteci üreten çağrıyla aynı argümanları ekleyin. Tam bir liste almak için, hiç olmayana kadar bu işlemi arayın nextToken cevapta. Bu işlemin boş sayfalar döndürebileceğini unutmayın.
Türü: dizi		Hayır
updatedAfterYalnızca sağladığınız tarihten sonra değiştirilmiş veya Amazon'un kataloğuna eklenen araçları almak için bu alanı ekleyin. İçinde olmalı İSO 8601 tarih-saat formatı.
Türü: dizi		Hayır

İstek örneği

GET https://sellingpartnerapi-eu.amazon.com/catalog/2024-11-01/automotive/vehicles?marketplaceId=A1F83G8C2ARO7P&updatedAfter=2024-11-01T01:00:00+01:00&vehicleType=CAR

Yanıt

Başarılı bir yanıtta aşağıdaki özellikler yer alır:

AdAçıklama
pagination nextToken ve previousToken varsa, sonuçların bir sonraki veya önceki sayfasını almak için gereken değerler.
Türü: Pagination
vehiclesAmazon'un kataloğundaki araçların listesi.
Türü: < Vehicle > sıra

Yanıt örneği

{
  "pagination": {
    "nextToken": "AQICAHhviiXpt-KG7DcOWDoXPW4_B4xAKk9r-8oi43dEh_cI4QF"
  },
  "vehicles": [
    {
      "bodyStyle": "MPV",
      "driveType": "Front-Wheel Drive",
      "energy": "Petrol/Liquified Petroleum Gas (LPG)",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 61.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 83.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "100408"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Dacia",
      "manufacturingStartDate": {
        "month": 11,
        "year": 2013
      },
      "manufacturingStopDate": {
        "month": 12,
        "year": 2015
      },
      "model": "Dokker",
      "status": "ACTIVE",
      "variantName": "1.6 LPG"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Petrol",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 100.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 136.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10232"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 10,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "2.2 I"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Petrol",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 151.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 205.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10233"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 10,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "3.2 I"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Diesel",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 85.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 116.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10234"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 9,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "2.2 DTI"
    }
  ]
}

Adım 2. Öğelerinizi KTypes ile eşleyin

Eşyalarınızın uyduğu araçları seçmek için önceki adımdan gelen yanıtı kullanın. Her öğe için, ona uyan araçların KTYPE'sini kaydedin. Bir sonraki adımda bu KTypes listesini sağlarsınız.

Adım 3. Listeler API'si ile donanımı güncelleyin

Bir ASIN"deki montaj bilgilerini güncellemek için, arayın patchListingsItem operasyon. patches istek gövdesindeki parametrenin şunlara sahip olması gerekir path eşit /attributes/vehicle_fitment ve içindeki KTypes listesini içerir value.

Yol parametreleri

AdAçıklamaZorunlu mu?
sellerIdSatıcı hesabı veya satıcı kodu gibi bir satış ortağı tanımlayıcısı.
Türü: dizi		Evet
skuBir satış ortağı, bir Amazon listesi için tanımlayıcı sağladı.
Türü: dizi		Evet

Sorgu parametreleri

AdAçıklamaZorunlu mu?
marketplaceIdsİstek için Amazon pazar yeri tanımlayıcılarının virgülle ayrılmış bir listesi.
Türü: sıra		Evet
includedDataYanıta dahil edilecek veri kümelerinin virgülle ayrılmış bir listesi.
Türü: < enum (IncludedData) > sıra		Hayır
modeTalep için çalışma modu.
Türü: enum (Mode)		Hayır
issueLocaleSorunların yerelleştirilmesi için bir yer. Sağlanmadığında, ilk pazar yerinin varsayılan dil kodu kullanılır.
Türü: dizi		Hayır

Gövde parametreleri

AdAçıklamaZorunlu mu?
productTypeListeleme öğesinin Amazon ürün türü.
Türü: dizi		Evet
patchesListeler öğesinde gerçekleştirilecek bir veya daha fazla JSON Yama işlemi.
Türü: < PatchOperation > sıra		Evet

İstek örneği

PATCH https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/XXXXXXXXXX/SKU_XXXXXX?includedData=issues&marketplaceIds=A1PA6795UKMFR9
{
  "productType": "AUTO_OIL",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/vehicle_fitment",
      "value": [
        {
          "standard": [
            {
              "value": "ktype",
              "language_tag": "de_DE"
            }
          ],
          "code": [
            {
              "value": "10232, 10234, 10233",
              "language_tag": "de_DE"
            }
          ],
          "note": [
            {
              "value": "{\"10232,10234\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"]]],\"10233\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"],[\"Motorcode\",\"N47 D20 C\"]]]}",
              "language_tag": "de_DE"
            }
          ],
          "marketplace_id": "A1PA6795UKMFR9"
        }
      ]
    }
  ]
}

Yanıt

Başarılı bir yanıtta aşağıdaki özellikler yer alır:

AdAçıklama
skuBir satış ortağı, bir Amazon listesi için tanımlayıcı sağladı.
Türü: dizi
statusListe öğesi gönderiminin durumu.
Türü: enum (Status)
submissionIdListe öğesi gönderiminin benzersiz tanımlayıcısı.
Türü: dizi
issuesListeler öğesi gönderimi ile ilgili liste öğesi sorunları.
Türü: < Issue > sıra
identifiersASIN gibi Amazon kataloğundaki öğeyle ilişkili kimlik nitelikleri.
Türü: ItemIdentifiers

Yanıt örneği

{
  "sku": "SKU-XXXX-XXXX",
  "status": "ACCEPTED",
  "submissionId": "xxxxxxxxxxxxxxxxx",
  "issues": []
}

❗️

Kullanım Koşulları

Bu API tarafından sağlanan verileri indirirken ve kullanırken, burada bulunan kullanım şartları Uygulanır ve kullanıcılar tarafından kabul edilir.

Updated 5 days ago

Bu sayfa size yardımcı oldu mu?