Katalog Kaynağı
Kataloglar kaynağı, Microsoft Merchant Center mağazanızdaki (MMC) katalogları yönetmenize olanak tanır. Katalog kaynaklarını kullanma hakkında bilgi için bkz. Kataloglarınızı yönetme. Katalogların nasıl ekleneceğini, silineceğini ve alındığı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/bmc/
Şablonlar
Kataloglarınızı yönetmek için kullandığınız uç noktaları oluşturmak için, uygun şablonu temel URI'ye ekleyin.
| Şablon | HTTP Fiili | Açıklama | Kaynak |
|---|---|---|---|
| {mmcMerchantId}/catalogs | YAYINLA | Mağazaya katalog eklemek için kullanın. Katalog eklemek için adı benzersiz olmalıdır. Bir mağazaya en fazla 100 katalog ekleyebilirsiniz. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . |
İstek: Katalog Yanıt: Katalog |
| {mmcMerchantId}/catalogs/{catalogId} | KOYMAK | Mağazadaki bir kataloğu güncelleştirmek için kullanın. Güncelleştireceğiniz tek alanlar ve isPublishingEnabled alanlarıdır name ve her ikisini de belirtmeniz gerekir.MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . |
İstek: Katalog Yanıt: Katalog |
| {mmcMerchantId}/catalogs/{catalogId} | SİLMEK | Bir kataloğu mağazadan silmek için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .Kataloğun kimliğine ayarlayın {catalogId} . |
İstek: Yok Yanıt: Yok |
| {mmcMerchantId}/catalogs/{catalogId} | AL | Mağazadan katalog almak için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .Kataloğun kimliğine ayarlayın {catalogId} . |
İstek: Yok Yanıt: Katalog |
| {mmcMerchantId}/catalogs | AL | Mağazadan katalog listesini almak için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . |
İstek: Yok Yanıt: Kataloglar |
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 |
|---|---|
| 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. Kataloğun eklendiği depoyu tanımlayan 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. Kataloğun eklendiği depoyu tanımlayan 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 |
|---|---|
| Katalog | Bir katalog tanımlar. |
| Katalog | Katalog listesini tanımlar. |
Katalog
Bir katalog tanımlar.
| Name | Değer | Tür | XML öğesi adı |
|---|---|---|---|
| Kimliği | Mağazadaki kataloğu benzersiz olarak tanımlayan bir kimlik. Bu alan salt okunurdur; bu alanı ayarlamayın. |
İmzasız Uzun | <Kimliği> |
| ısdefault | Kataloğun mağazanın varsayılan kataloğu olup olmadığını belirleyen boole değeri. Katalog, mağazanın varsayılan kataloğuysa doğrudur ; aksi takdirde false. Bir mağaza oluşturduğunuzda, başka bir katalog belirtmezseniz ürünlerin yazacağı varsayılan bir katalog elde edersiniz. Bu alan salt okunurdur; bu alanı ayarlamayın. |
Boole | <is_default> |
| isPublishingEnabled | Microsoft'un katalogdan ürün yayımlayıp yayımlamayacağını belirleyen boole değeri. Microsoft katalogdan ürün yayımlayabilirse true olarak ayarlayın; aksi takdirde false olarak ayarlayın. Bu alanı güncelleştirebilirsiniz. Bu alanı, uygulamanızı üretim ortamına dağıtmadan önce test etmek için de kullanabilirsiniz. Bu alanı false olarak ayarlayarak, üretim verilerinizi değiştirmeden veya yayımlamadan Ürün Kaynağı çağrıları yapabilirsiniz. |
Boole | <is_publishing_enabled> |
| Pazar | Katalogdaki ürünlerin yayımlandığı pazar. NOT: Henüz herkesin bu özelliği yok. Bunu yapmazsanız endişelenmeyin; çok yakında! Aşağıda, belirteceğiniz olası pazarlar yer alır.
Kataloğu mağazaya ekledikten sonra bu alanı güncelleştiremeyebilirsiniz. Yukarıdaki listede de-DE, belirttiğiniz pazar değeridir; pazar dizenize (Almanca-Almanya) eklemeyin. |
Dize | <Pazar> |
| Adı | Kataloğun adı. Ad en fazla 70 karakter içerebilir. Bu alanı güncelleştirebilirsiniz. |
Dize | <Adı> |
Katalog
Katalog listesini tanımlar.
| Name | Değer | Tür | XML öğesi adı |
|---|---|---|---|
| Katalog | Mağazadaki katalogların listesi. | Katalog[] | <Katalog> |
HTTP durum kodları
İstekler aşağıdaki HTTP durum kodlarını döndürebilir.
| Durum kodu | Açıklama |
|---|---|
| 200 | Başarı. |
| 201 | Katalog başarıyla eklendi. |
| 204 | Katalog başarıyla silindi. |
| 400 | Hatalı istek. Sorgu parametresi değeri geçerli değil veya istek gövdesindeki bir şey geçerli değil. |
| 401 | Yetki -siz. Kullanıcının kimlik bilgileri geçerli değil. |
| 404 | Bulunamadı. |
| 500 | Sunucu hatası. |