Stok kaynağı

  • Makale

Not

Envanter API'sini yalnızca kapalı pilot katılımcılar kullanabilir. API ve belgeler değiştirilebilir.

Stok kaynağı, Microsoft Merchant Center (MMC) mağazanızdaki ürünlerin fiyatlandırmasını ve kullanılabilirliğini güncelleştirmenize olanak tanır. Stok kaynaklarını kullanma hakkında bilgi için bkz . Ürün fiyatlandırmasını güncelleştirme. Fiyatlandırma ve kullanılabilirliği güncelleştirme adımlarını gösteren örnekler için bkz. Kod Örnekleri.

Temel URI

Aşağıda, şablonları eklediğiniz temel URI'dir.

https://content.api.bingads.microsoft.com/shopping/v9.1

Şablonlar

Ürün tekliflerinizi güncelleştirmek için kullanılan uç noktaları oluşturmak için, uygun şablonu temel URI'ye ekleyin.

Şablon HTTP Fiili Açıklama
/bmc/{mmcMerchantId}/inventory/batch YAYINLA Tek bir istekte birden çok ürün fiyatlandırma güncelleştirmesi gerçekleştirmek için kullanın.

MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .

İstek nesnesi: Batch
Yanıt nesnesi: Batch
/bmc/{mmcMerchantId}/inventory/{storeCode}/products/{productUniqueId} YAYINLA Tek bir ürünün fiyatlandırmasını ve kullanılabilirliğini güncelleştirmek için kullanın.

MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .

Çevrimiçi olarak ayarlayın {storeCode} .

Tam ürün kimliğine ayarlayın {productUniqueId} (örneğin, Online:en:US:Sku123).

İstek nesnesi: Ürün
Yanıt nesnesi: Ürün

Sorgu parametreleri

Uç noktalar aşağıdaki sorgu parametrelerini içerebilir.

Parametre Açıklama
kuru çalıştırma Isteğe bağlı. Çağrıları test etmek için uygulamanızda hata ayıklarken kullanın. Bu parametreyi içeren çağrılar üretim verilerini etkilemez. Bir hata oluşursa, yanıt veri kalitesi, düzenleme sorunları ve veritabanıyla ilgili doğrulamalar gibi ikincil hata iletileri dışında çağrının normalde oluşturduğu hataları içerir. Uygulamanızı test etme hakkında daha fazla bilgi için bkz . Korumalı Alan.

Üstbilgi

İstek ve yanıt üst bilgileri aşağıdadır.

Üstbilgi Açıklama
AuthenticationToken İstek üst bilgisi.

Bu üst bilgiyi bir OAuth erişim belirteci olarak ayarlayın. Erişim belirteci alma hakkında bilgi için bkz. Kimlik bilgilerinizin kimliğini doğrulama.
İçerik Türü İstek ve yanıt üst bilgisi.

İsteğin veya yanıtın gövdesindeki içerik türü. application/json olarak ayarlayın.
CustomerAccountId İstek üst bilgisi.

Üst bilgide CustomerId belirtilen müşteri adına yönettiğiniz herhangi bir hesabın hesap kimliği. Hangi hesabı belirttiğiniz önemli değildir. Bu üst bilgiyi yalnızca müşteri adına bir hesabı yönetiyorsanız belirtin.
Customerıd İstek üst bilgisi.

Mağazasını yönettiğiniz müşterinin müşteri kimliği. Bu üst bilgiyi yalnızca mağazayı müşteri adına yönetiyorsanız belirtin. Bu üst bilgiyi ayarlarsanız üst bilgiyi de ayarlamanız CustomerAccountId gerekir.
DeveloperToken İstek üst bilgisi.

İstemci uygulamasının geliştirici belirteci. Her istek bu üst bilgiyi içermelidir. Belirteç alma hakkında bilgi için bkz. Microsoft Advertising kimlik bilgileriniz ve geliştirici belirteciniz var mı?
Konum Yanıt üst bilgisi.

Güncelleştirilen ürünün URL'si.
WebRequestActivityId Yanıt üst bilgisi.

İsteğin ayrıntılarını içeren günlük girdisinin kimliği. Bir hata oluşursa her zaman bu kimliği yakalamanız gerekir. Sorunu belirleyemiyor ve çözemiyorsanız, destek ekibine sağladığınız diğer bilgilerle birlikte bu kimliği de ekleyin.

İstek ve yanıt nesneleri

API tarafından kullanılan istek ve yanıt nesneleri aşağıda verilmiştır.

Nesne Açıklama
Toplu iş Toplu istekte güncelleştirilecek ürünlerin listesini tanımlar.
Hata Bir hata tanımlar.
ErrorResponse Toplu güncelleştirme olmayan bir güncelleştirme için en üst düzey hata nesnesini tanımlar.
BatchEntryError Toplu işlem sırasında bir öğe için oluşan hataları tanımlar.
Giriş Toplu iş isteğinde veya yanıtta bir girdi tanımlar.
Ürün Bir ürünü tanımlar.
Productprice Bir ürünün fiyatını tanımlar.

Toplu iş

Toplu iş olarak güncelleştirilecek ürünlerin listesini tanımlar.

Name Değer Tür
Giriş Toplu olarak güncelleştirilecek ürünlerin listesi. Belirtebileceğiniz en fazla ürün sayısı 400'dür. Girdi[]

BatchEntryError

Toplu işlem sırasında bir giriş için oluşan hataları tanımlar.

Name Değer Tür
Hata Girdi işlenirken oluşan hataların listesi. Hata[]
Kod Hatanın HTTP durum kodu. Dize
ileti Hatayla ilişkili ileti. Dize

Error

Bir hata tanımlar.

Name Değer Tür
Etki alanı Yalnızca dahili kullanım için. Dize
ileti Hatanın açıklaması. Dize
Neden İsteğin başarısız olmasının nedeni. Örneğin, ürün doğrulanamadı. Dize

ErrorResponse

Tek bir ürün güncelleştirmesi için en üst düzey hata nesnesini tanımlar.

Name Değer Tür
Hata Öğe işlenirken oluşan hataların listesi. Hatalar[]

Hata

Bir ürünün hata listesini tanımlar.

Name Değer Tür
Hata Girdi işlenirken oluşan hataların listesi. Hata[]
Kod Hatanın HTTP durum kodu. Dize
ileti Hatayla ilişkilendirilmiş bir ileti. Dize

Giriş

Toplu iş isteğindeki bir girdiyi tanımlar.

Name Değer Tür
Batchıd Toplu iş isteğinde bu girdiyi benzersiz olarak tanımlayan kullanıcı tanımlı kimlik. Örneğin, toplu işlem 10 giriş içeriyorsa, onlara 1 ile 10 arasında kimlik atayabilirsiniz. İşaretsiz Tamsayı
Hata Oluşan doğrulama hatalarının listesini içeren bir hata nesnesi. Yanıt bu alanı yalnızca bir hata oluştuğunda içerir. BatchEntryError
Stok Güncelleştirilmiş fiyat ve kullanılabilirlik. Ürün
merchantId Merchant Center mağaza kimliği. URL mağaza kimliğini içerdiğinden, bu alan yoksayılır. İmzasız Uzun
Productıd Güncelleştirilecek ürünün tam ürün kimliği (örneğin, Online:en:US:Sku123). Aynı ürün kimliğine sahip birden çok giriş eklemeyin. Dize
storeCode Güncelleştirilecek depoyu tanımlayan kod. Çevrimiçi mağazada ürünlerin fiyatını ve kullanılabilirliğini güncelleştirmek için çevrimiçi olarak ayarlayın. Dize

Ürün

Bir ürünü tanımlar.

Özellik Açıklama Tür Gerekli
Kullanılabilir -lik Ürünün kullanılabilirliği. Olası değerler:
  • stokta
  • stokta yok
  • Preorder
 Dize Evet
Tür Nesnenin türü. content#inventory olarak ayarlayın. Dize Hayır
Fiyat Ürünün yeni fiyatı. Fiyatı hedef ülkenin veya bölgenin para birimi cinsinden belirtin. Fiyata vergi eklenip eklenmeyeceği hakkında bilgi için bkz. Microsoft Merchant Center katalog vergi ilkesi.

Fiyat, ürünün web sayfasında gösterilen fiyatla eşleşmeli ve 0,01 (1 sent) ile 10000000,00 (10 milyon) aralığında olmalıdır. Ancak aşağıdaki koşullar karşılanırsa fiyatı 0,0 (sıfır) olarak ayarlayabilirsiniz.
  1. googleProductCategory Ürünün alanı aşağıdaki kategorilerden birine ayarlanır:
    • Elektronik > İletişim > Telefon > Cep Telefonları
    • Elektronik > Bilgisayarlar > Tablet Bilgisayarlar
  2. Ürünün title alanı aşağıdaki anahtar sözcüklerden birini içerir:
    • Sözleşme
    • Taksit
    • Kira
    • Ödeme
    Yukarıdaki anahtar sözcükler İngilizce olarak gösterilmiştir; ancak, başlık ve anahtar sözcük belirtilen pazarın dilinde olmalıdır.

    Genellikle başlıkta "... taksit planıyla" veya "... yalnızca sözleşme ile". Sözleşme anahtar sözcüğü tüm pazarlarda kullanılabilir; ancak, taksit, ödeme ve kiralama yalnızca ABD pazarında kullanılabilir.
 Productprice Evet
salePrice Ürünün satış fiyatı. Satış ürünleri için hem satış fiyatını hem de satış geçerlilik tarihini ayarlayın (bkz salePriceEffectiveDate. ). Satış fiyatını ayarlar ancak satış fiyatının geçerlilik tarihini ayarlamazsanız, satış fiyatı ürünün süresi dolana veya geçerlilik tarihi belirleyene kadar kullanılmaya devam eder.

Satış fiyatı 0,01 (1 sent) ile 10000000,00 (10 milyon) aralığında olmalıdır. Ancak aşağıdaki koşullar karşılanırsa satış fiyatını 0,0 (sıfır) olarak ayarlayabilirsiniz.
  1. googleProductCategory alanı aşağıdaki kategorilerden birine ayarlanır:
    • Elektronik > İletişim > Telefon > Cep Telefonları
    • Elektronik > Bilgisayarlar > Tablet Bilgisayarlar
  2. Başlık alanı aşağıdaki anahtar sözcüklerden birini içerir:
    • Sözleşme
    • Taksit
    • Kira
    • Ödeme
    Yukarıdaki anahtar sözcükler İngilizce olarak gösterilmiştir; ancak, başlık ve anahtar sözcük belirtilen pazarın dilinde olmalıdır.

    Genellikle başlıkta "... taksit planıyla" veya "... yalnızca sözleşme ile". Sözleşme anahtar sözcüğü tüm pazarlarda kullanılabilir; ancak, taksit, ödeme ve kiralama yalnızca ABD pazarında kullanılabilir.
Belirtilmezse, geçerli satışın fiyatı tekliften kaldırılır. Null geçirmeyin.		 Productprice Hayır
salePriceEffectiveDate Satışın UTC başlangıç ve bitiş tarihi. Yalnızca değerini ayarlarsanız salePricebir tarih belirtin.

Başlangıç ve bitiş tarihlerini ISO 8601 biçiminde belirtin. Örneğin, 2016-04-05T08:00-08:00/2016-04-10T19:30-08:00 (başlangıç ve bitiş tarihlerini ayırmak için eğik çizgi ('/') kullanın). Daha fazla bilgi için bkz. salePrice.

Belirtilmezse, geçerli satışın tarihi tekliften kaldırılır. Null geçirmeyin.		 Dize Hayır

Productprice

Bir ürünün fiyatını veya satış fiyatını tanımlar.

Name Değer Tür
Para birimi Fiyatın belirtildiği para birimi. Olası değerler:
  • AUD (Avustralya doları)
  • CAD (Kanada doları)
  • CHF (İsviçre frangı)
  • EUR (Euro)
  • GBP (Büyük Britanya poundu)
  • INR (Hint rupisi)
  • SEK (İsveç kronu)
  • ABD Doları (Birleşik Devletler dolar)
 Dize
Değer Ürünün fiyatı. Çift

HTTP durum kodları

İstekler aşağıdaki HTTP durum kodlarını döndürebilir.

Durum kodu Açıklama
200 Başarı.
400 Hatalı istek. Sorgu parametresi değeri geçerli değil veya istek gövdesindeki bir şey geçerli değil.

Bir hata oluşursa, başarısız olan toplu iş girdisi hataları içerir.
401 Yetki -siz. Kullanıcının kimlik bilgileri geçerli değil.
403 Yasak. Kullanıcının kaynağı kullanma izinleri yok.
404 Bulunamadı.
409 Çakışma. Kaynağın geçerli durumuyla çakışma nedeniyle işlem tamamlanamadı.
413 İstek varlığı çok büyük. İsteğin boyutu izin verilen maksimum değeri aşıyor.
500 Sunucu hatası.