Stok kaynağı
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:
|
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.
|
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.
|
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:
|
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ı. |