Aracılığıyla paylaş

Kataloglarınızı yönetme

  • Makale

İçerik API'si, Microsoft Merchant Center (MMC) mağazanızdaki katalogları yönetmek için Kataloglar kaynağını kullanan bir RESTful API'dir.

aşağıda, İçerik API'sini çağırmak için kullandığınız temel URI'dir.

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

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).

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

Kataloglar kaynağını kullanma hakkında ayrıntılı bilgi için aşağıdaki bölümlere bakın.

Katalogların nasıl alındığını, ekleneceğini, güncelleştirildiğini ve silindiğini gösteren bir kod örneği için bkz. Katalogları Yönetme Kod Örneği.

Mağazadan katalog alma

Mağazadan bir katalog almak için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs/{catalogId}

{bmcMerchantId} MMC mağaza kimliğiniz olarak ayarlayın ve kataloğun kimliğine ayarlayın{catalogId}.

Sonuçta elde edilen URL'ye bir HTTP GET isteği gönderin. Katalog bulunduysa, yanıt kataloğun ayrıntılarını içeren bir Katalog nesnesi içerir.

Mağazadan katalog listesi alma

Mağazadan katalog listesini almak için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs

MMC mağaza kimliğiniz olarak ayarlayın {bmcMerchantId} .

Sonuçta elde edilen URL'ye bir HTTP GET isteği gönderin. Depoda kataloglar varsa, yanıt katalog listesini içeren bir Catalogs nesnesi içerir.

Mağazadan katalog silme

Bir kataloğu mağazadan silmek için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs/{catalogId}

{bmcMerchantId} MMC mağaza kimliğiniz olarak ayarlayın ve kataloğun kimliğine ayarlayın{catalogId}.

Sonuçta elde edilen URL'ye bir HTTP DELETE isteği gönderin. Katalog bulunduysa silinir.

Mağazaya katalog ekleme

Ürünlerinizi mantıksal olarak gruplandırmak için katalogları kullanırsınız. Depoya katalog eklemek için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs

MMC mağaza kimliğiniz olarak ayarlayın {bmcMerchantId} .

Sonuçta elde edilen URL'ye bir HTTP POST isteği gönderin. Katalog eklenirse, yanıt bir Katalog nesnesi içerir. Catalog nesnesi kataloğun kimliğini içerir. Kataloğu almak ve silmek için kimliği kullanın.

İsteğin gövdesi bir Katalog nesnesidir. Aşağıdaki alanları belirtmeniz gerekir.

Belirttiğiniz ad mağaza içinde benzersiz olmalıdır ve en fazla 70 karakterle sınırlıdır. Pazar, ürünlerin nerede sunulduğunun belirlenmesini sağlar. Desteklenen pazarların listesi için bkz. pazar. Ürünler yalnızca doğruysaisPublishingEnabled sunulur. Uygulamanızı test için nasıl kullanabileceğiniz isPublishingEnabled hakkında ayrıntılı bilgi için bkz. Korumalı Alanda Kodunuzu Test Etme.

Mağazadaki kataloğu güncelleştirme

Depodaki bir kataloğu güncelleştirmek için aşağıdaki şablonu temel URI'ye ekleyin.

{bmcMerchantId}/catalogs/{catalogId}

{bmcMerchantId} MMC mağaza kimliğiniz olarak ayarlayın ve kataloğun kimliğine ayarlayın{catalogId}.

İsteğin gövdesi bir Katalog nesnesidir. Aşağıdaki alanları belirtmeniz gerekir.

Sonuçta elde edilen URL'ye bir HTTP PUT isteği gönderin. Katalog güncelleştirildiyse, yanıt güncelleştirilmiş Katalog nesnesini içerir.