Durum Kaynağı

Durum kaynağı, belirtilen kataloğa yüklediğiniz ürün tekliflerinin durumunu almanıza olanak tanır. Teklifleri kataloğa yükledikten sonra bir doğrulama ve editoryal inceleme sürecinden geçerler. Bu işlem 36 saate kadar sürebilir. Teklif, yalnızca gözden geçirme işlemi tamamlandıktan sonra rapora eklenir.

İşlemin nasıl çalıştığına genel bir bakış için bkz. Ürün Tekliflerinin Durumunu Nasıl Alabilirim?

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

Temel URI

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

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

Şablonlar

Katalogdaki ürün tekliflerinin durumunu almak için kullanılan uç noktaları oluşturmak için, temel URI'ye uygun şablonu ekleyin.

Not

{bmcMerchantId}/catalogs/{catalogId}/status kullanım dışı bırakıldı ve kullanılmasını önermiyoruz.

Şablon	HTTP Fiili	Açıklama	Kaynak
{bmcMerchantId}/catalogs/{catalogId}/status	AL	Doğrulama ve editoryal incelemeden geçen veya başarısız olan karşıya yüklenen tekliflerin sayısını almak için kullanın. MMC deposu kimliği olarak ayarlayın {bmcMerchantId} . Kataloğun kimliğine ayarlayın {catalogId} .	İstek: Yok Yanıt: Durum

Sorgu parametreleri

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

Parametre	Açıklama
alt	Isteğe bağlı. İstekte ve yanıtta kullanılan içerik türünü belirtmek için kullanın. Olası değerler ve xmldeğerleridirjson. Varsayılan değerdir json.

Üstbilgi

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

Üstbilgi	Açıklama
Kabul	İstek üst bilgisi.<p>Raporu indirirken bu üst bilgiyi ekleyin. Bu üst bilgiyi olarak application/x-zip-compressedayarlamalısınız.
AuthenticationToken	İstek üst bilgisi. Bu üst bilgiyi bir OAuth kimlik doğrulama belirteci olarak ayarlayın. Belirteç alma hakkında bilgi için bkz. Kimlik bilgilerinizin kimliğini doğrulama.
İçerik Konumu	Yanıt üst bilgisi. Ürünün eklendiği depoyu tanımlayan BIR URL. Bu üst bilgi, Ekleme isteğinin yanıtında yer alır.
CustomerAccountId	İstek üst bilgisi. Üst bilgide CustomerId belirtilen müşteri adına yönettiğiniz hesaplardan herhangi birinin 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 erişim 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. Ürünün eklendiği depoyu tanımlayan BIR URL. Bu üst bilgi, Ekleme isteğinin yanıtında yer alır.
WebRequestActivityId	Yanıt üst bilgisi. İstekle ilgili ayrıntıları 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.

Her nesne, istek için belirttiğiniz içerik türüne bağlı olarak kullandığınız JSON anahtar adını ve XML öğesi adını tanımlar.

Nesne	Açıklama
Durum	Kataloğa yüklenen ürün tekliflerinin durumunu tanımlar.

Durum

Kataloğa yüklenen ürün tekliflerinin durumunu tanımlar. Nesnenin XML adı catalogStatus'dur<>.

Name	Değer	Tür	XML öğesi adı
catalogId	Raporlanan kataloğun kimliği.	Ulong	<catalog_id>
publishedCount	Doğrulama ve editoryal incelemeden geçen teklif sayısı.	Ulong	<published_count>
rejectedCount	Doğrulama ve editoryal incelemede başarısız olan teklif sayısı. Bu sayı, raporun gövdesindeki satır sayısını gösterir (bkz. Rapor Biçimi).	Ulong	<rejected_count>
rejectionReportUrl	Raporu indirmek için kullandığınız URL. nesnesi bu alanı yalnızca sıfırdan büyük olduğunda rejectedCount içerir. Rapor sıkıştırılır ve okuyabilmeniz için önce sıkıştırması kaldırılmalıdır.	Dize	<catalog_id>

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 rapor URL'si (bkz . rejectionReportUrl) artık geçerli değil.
401	Yetki -siz. Kullanıcının kimlik bilgileri geçerli değil.
404	Bulunamadı. Belirtilen katalog için durum kullanılamıyor veya katalog veya mağaza kimliği geçerli değil.
500	Sunucu hatası.

Rapor Biçimi

İndirdiğiniz rapor dosyası Zip sıkıştırılmış bir klasörde (*.zip) bulunur. Raporu okuyabilmeniz için önce klasörün ve içeriğinin sıkıştırmasını açmanız gerekir. Rapor, MerchantCatalogReport.csv adlı virgülle ayrılmış bir dosyadır.

Rapor üst bilgi bölümüne ve rapor gövdesi bölümüne ayrılmıştır. İlk satır, üst bilgi bölümü için aşağıdaki sütun adlarını içerir.

Sütun Adı	Açıklama
Katalog Adı	Kataloğun adı.
Katalog Kimliği	Kataloğun kimliği.
Mağaza Kimliği	Kataloğu içeren deponun kimliği.
Karşıya Yükleme Zamanı	Kullanmayın. Bu alan varsa yoksayın.

İkinci satır üst bilgi verilerini içerir.

Üçüncü satır boş.

Dördüncü satır, beşinci satırda başlayan rapor gövdesi için aşağıdaki sütun adlarını içerir.

Sütun Adı	Açıklama
Öğe Kimliği	Doğrulama veya editör incelemesi başarısız olan teklifin offerId değeri. Rapor benzersiz kimlikler içerir.
İleti	Bildirilen hata.
Tür	Hata türü. Olası değerler Hata veya Uyarı'dır.
Değerler	Hatanın nedeni geçersiz bir değerse hataya neden olan veri değeri.
Teklif Parçacığı	Teklif verilerinin alt kümesinin noktalı virgülle ayrılmış listesi. Biçim başlıktır; productType; bağlantı; imageLink; fiyat; salePrice; saleStartDate; saleEndDate. Tüm hatalar tüm bileşenleri içermez.

Rapor örneği için bkz. Örnek Rapor.