Aracılığıyla paylaş


Ürün Tekliflerinin Durumunu Nasıl Alabilirim?

Bir katalog veya mağazaya ürün teklifi eklediğinizde veya güncelleştirdiğinizde, teklif editoryal incelemeye geçmeden önce ilk doğrulamadan geçer. Bu işlem 36 saate kadar sürebilir. Teklifin gözden geçirme işleminden geçip geçmediğini görmek için Durum kaynağını kullanın.

Not

Durumları Onaylanmadı veya Uyarı olarak ayarlanmış ürünlerin listesini almak için bkz. Ürün tekliflerinizin durumunu alma.

Aşağıda, kaynağı almak için kullandığınız temel URI'dir Status .

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

Ürün tekliflerinin durumunu almak için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs/{catalogId}/status

{bmcMerchantId} BMC mağaza kimliğinize ayarlayın ve durumunu almak istediğiniz ürün tekliflerini içeren kataloğun kimliğine ayarlayın{catalogId}.

Her HTTP isteği kullanıcının OAuth erişim belirtecini ve geliştirici belirtecinizi içermelidir. Kullanıcının erişim belirtecini belirtmek için AuthenticationToken üst bilgisini ayarlayın. Geliştirici belirtecinizi belirtmek için DeveloperToken üst bilgisini ayarlayın.

Katalogları diğer müşteriler adına yönetiyorsanız şunları ayarlamanız gerekir:

  • Mağazasını yönettiğiniz müşterinin müşteri kimliğinin CustomerId üst bilgisi.
  • Yönettiğiniz müşteri hesaplarından herhangi birinin hesap kimliğinin CustomerAccountId üst bilgisi (yönetilen hesabın hangisi olduğu önemli değildir).

Raporu indirmek için erişim belirtecini veya geliştirici belirtecini belirtmeniz gerekmez; yalnızca durumu almak için bunları belirtmeniz gerekir.

Varsayılan olarak, İçerik API'sinde durumu temsil etmek için JSON nesneleri kullanılır. XML kullanmak için alternatif sorgu parametresini XML olarak ayarlayın.

Sonuçta elde edilen URL'ye bir HTTP GET isteği gönderin. Yanıt, son 30 gün içinde gözden geçirme işlemini geçen veya başarısız olan teklif sayısını içeren bir Status nesnesi içerir. Bir teklif gözden geçirmeyi başarısız olduysa kaynak, Status teklifin neden başarısız olduğunu açıklayan bir rapor indirmek için kullanabileceğiniz bir URL içerir.

Aşağıda örnek Status bir nesne gösterilmektedir.

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

Rapor, başarısız olan teklifi tanımlar ancak raporun hangi güncelleştirmelere başvurduğunu belirlemek için kullanabileceğiniz zaman damgası veya sürüm denetimi bilgilerini sağlamaz. Örneğin, bir teklifi 2 gün önce karşıya yüklediyseniz ve sonra dün güncelleştirdiyseniz, sorunun 2 gün önce yüklenen sürümle mi yoksa dün yüklenen sürümle mi ilgili olduğunu bilmezsiniz. Ancak, öğenin hangi sürümünün bildirildiğini çıkarsamak için raporun Teklif Parçacığı sütunundaki öğenin özniteliklerini kullanabilirsiniz.

Rapor dosyası ZIP sıkıştırılmış olduğundan, raporu okumak için dosyanın sıkıştırmasını açmanız gerekir. Sistemin depolayabileceğiniz rapor sayısıyla ilgili bir sınır yoktur; ancak raporların depolandığı süre tanımlanmamıştır. Raporun içeriği hakkında bilgi için bkz. Rapor Biçimi.

Katalogla ilişkili etkinliğe bağlı olarak rapor büyük olabilir. Gerekli olandan daha sık rapor istememelisiniz. Önerilen aralık saat başına en fazla bir kezdir.

Kataloğun durumunu alma ve raporu indirme işlemini gösteren bir kod örneği için bkz. Katalog Durum Raporunu İndirme.

Aşağıda örnek bir rapor gösterilmektedir.

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"