Ürün Kaynağı

Ürünler kaynağı, Microsoft Merchant Center mağazanızdaki (MMC) ürün tekliflerini yönetmenize olanak tanır. Ürünler kaynaklarını kullanma hakkında bilgi için bkz. Ürünlerinizi Yönetme. Ürün eklemeyi, silmeyi ve almayı 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

Ürün tekliflerinizi yönetmek için kullanılan uç noktaları oluşturmak için, uygun şablonu temel URI'ye ekleyin.

Şablon	HTTP Fiili	Açıklama	Kaynak
{mmcMerchantId}/products/batch	YAYINLA	Tek bir istekte birden çok ekleme (güncelleştirme), alır ve silme gerçekleştirmek için kullanın. Toplu işlem aynı ürün için birden çok eylem içermemelidir. Örneğin, istek aynı ürünü eklemeye ve silmeye çalışmamalıdır. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .	İstek: Batch Yanıt: Batch
{mmcMerchantId}/products/{productUniqueId}	SİLMEK	Mağazadan tek bir ürün teklifini silmek için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . Tam ürün kimliğine ayarlayın {productUniqueId} (örneğin, Online:en:US:Sku123). Birden çok kataloğa aynı kimliğe sahip bir ürün eklediyseniz, hepsinden silinir. Silinen ürünlerin teslimin durdurulması 12 saat kadar sürebilir. Silmeden önce ürün kullanılabilirliğini "stokta yok" olarak güncelleştirmenizi öneririz.	İstek: Yok Yanıt: Yok
{mmcMerchantId}/products/{productUniqueId}	AL	Mağazadan tek bir ürün teklifi almak için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . Tam ürün kimliğine ayarlayın {productUniqueId} (örneğin, Online:en:US:Sku123). Birden çok kataloğa aynı kimliğe sahip bir ürün eklediyseniz, hizmet bunlardan yalnızca birini döndürür ve hangisi belirsizdir.	İstek: Yok Yanıt: Ürün
{mmcMerchantId}/products	AL	Mağazadaki ürünlerin listesini almak için kullanın. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} .	İstek: Yok Yanıt: Ürünler
{mmcMerchantId}/products	YAYINLA	Mağazaya tek bir ürün teklifi eklemek (güncelleştirmek) için kullanın. Ürün yoksa eklenir; aksi takdirde ürün güncelleştirilir. Güncelleştirmeler geçerli teklifin üzerine yazdığından, teklifi oluşturan tüm alanları eklemeniz gerekir. Teklifi belirli bir kataloğa eklemek için bmc-catalog-id sorgu parametresini belirtin; aksi takdirde, ürün mağazanın varsayılan kataloğuna eklenir. MMC deposu kimliği olarak ayarlayın {mmcMerchantId} . Get/List ve Delete istekleri belirli bir kataloğa değil depoya karşı işlem yaptığı için, birden çok kataloğa aynı kanala, contentLanguage'a, targetCountry'ye ve offerId'ye sahip bir ürün eklememelisiniz.	İstek: Ürün Yanıt: Ürün

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.
bmc-catalog-id	Isteğe bağlı. Ürün tekliflerinin ekleneceğini (güncelleştirileceğini) kataloğu belirtmek için kullanın. Mağazanızda birden çok katalog varsa bu parametreyi kullanın. Bu parametreyi belirtmezseniz, ürün mağazanın varsayılan kataloğuna eklenir. Bu parametre yalnızca ürün teklifleri eklemek için kullanılır. Bu parametre kataloglar arasında çalıştıkları için Alma, Listeleme ve Silme istekleri için yoksayılır.
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 (ürünler eklenmez veya silinmez); ancak yanıt, çağrının oluşturduğu hataları içerir. Bu parametreyi kullanırken aşağıdaki sınırlamaları göz önünde bulundurun. Ekleme işlemleri kimlik döndürmez. Hizmet veri kalitesi, düzenleme sorunları ve veritabanıyla ilgili doğrulamalar gibi ikincil hata iletileri oluşturmaz veya döndürmez. Uygulamanızı test etme hakkında daha fazla bilgi için bkz . Korumalı Alan.
maksimum sonuçlar	Isteğe bağlı. Liste isteğinde döndürülecek en fazla öğe sayısını belirtmek için kullanın. Belirtebilecek en büyük değer 250'dir. Varsayılan değer 25'tir.
başlangıç belirteci	Isteğe bağlı. Mağazanın ürün listesinde sayfalandırmak için kullanın. Belirteç, liste isteğinde döndürülecek ürünlerin sonraki sayfasını tanımlar. İlk Liste isteğinde bu parametreyi belirtmeyin. Katalogda istenen sayıdan daha fazla ürün varsa (maksimum sonuç sorgu parametresine bakın), yanıt bir sonraki Liste isteğinde kullandığınız belirteç değerini içeren alanını (bkz. Ürünler) içerirnextPageToken.

Ü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 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.
İçerik Türü	İstek ve yanıt üst bilgisi. İsteğin veya yanıtın gövdesindeki içerik türü. POST'ler için, JSON kullanıyorsanız, bu üst bilgiyi olarak application/jsonayarlayın. Aksi takdirde, XML kullanıyorsanız, bu üst bilgiyi olarak application/xmlayarlayı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. Ü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. İ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.

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
Toplu iş	Toplu istekte işlenmek üzere öğelerin listesini tanımlar.
Hata	Bir hata tanımlar.
ErrorResponse	Tek bir ürün eklemesi için en üst düzey hata nesnesini tanımlar.
BatchItemError	Toplu işlem sırasında bir öğe için oluşan hataları tanımlar.
Öğe	Toplu iş isteği veya yanıttaki bir öğeyi tanımlar.
Ürün	Bir ürünü tanımlar.
ProductCustomAttribute	Özel bir öznitelik tanımlar.
ProductCustomGroup	Özel özniteliklerden oluşan bir grubu tanımlar.
ProductDestination	Hedefi tanımlar.
Productprice	Bir ürünün fiyatını tanımlar.
ProductTax	Geçerli vergileri belirleyen coğrafi konumu tanımlar.
Ürünler	Ürünlerin listesini tanımlar.
ProductShipping	Sevkiyat maliyetini tanımlar.
ProductShippingWeight	Öğenin sevkiyat ağırlığını tanımlar.
UnitPricing	Maddenin birim fiyatını tanımlar.
Uyarı	Bir uyarı iletisi tanımlar.

Toplu iş

Toplu istekte işlenmek üzere öğelerin listesini tanımlar. Bu nesnenin bir toplu iş isteğinde ve yanıtında kullanıldığını unutmayın.

Name	Değer	Tür	XML öğesi adı
Giriş	Toplu istekte işlenmek üzere bir öğe dizisi. Belirtebileceğiniz en fazla öğe sayısı 12.000'dir. Ancak, istek boyutu üst sınırı 4 MB'tır, bu nedenle gerçek öğe sayısı, eklediğiniz ürün özniteliklerinin sayısına (örneğin, boyut, renk, desen) ve verileri sıkıştırıp sıkıştırmadığınıza bağlıdır. Örneğin, verileri sıkıştırırsanız 12.000 öğe belirtebilirsiniz, ancak belirtmezseniz yalnızca 2.000 öğe belirtebilirsiniz.	Öğe[]	<Toplu iş>

BatchItemError

Toplu işlem sırasında bir öğe için oluşan hataları tanımlar.

Name	Değer	Tür	XML öğesi adı
Hata	Öğe işlenirken oluşan hataların listesi.	Hata[]	<Hata>
Kod	Hatanın HTTP durum kodu.	Dize
ileti	Hatayla ilişkilendirilmiş bir ileti.	Dize

Error

Bir hata tanımlar.

Name	Değer	Tür	XML öğesi adı
Etki alanı	Yalnızca dahili kullanım için.	Dize	<Etki alanı>
Konum	Kullanılmıyor.	Dize	<location type="string">
locationType	Kullanılmıyor.	Dize	Location> öğesinin tür özniteliğine <bakın
ileti	Hatanın açıklaması.	Dize	<internalReason>
Neden	İsteğin başarısız olmasının nedeni. Örneğin, ürün doğrulanamadı.	Dize	<Neden>

ErrorResponse

Tek bir ürün eklemesi için en üst düzey hata nesnesini tanımlar.

Name	Değer	Tür	XML öğesi adı
Hata	Öğe işlenirken oluşan hataların listesi.	Hatalar[]	<Hata>

Hata

Teklifle ilgili hataların ve uyarıların listesini tanımlar.

Name	Değer	Tür	XML öğesi adı
Hata	Öğe işlenirken oluşan hataların listesi.	Hata[]	<Hata>
Uyarı	Öğe işlenirken oluşan uyarıların listesi. Teklif kabul edildi, ancak sorunları en erken kolaylıkta çözmeniz gerekir. Örneğin, bilmeleri gerekiyorsa gtin, mpn ve marka tanımlayıcılarını belirtmezseniz MMC uyarılar döndürür.	Uyarı[]	<Uyarı>
Kod	HTTP durum kodu veya hata.	Dize
ileti	Hatayla ilişkilendirilmiş bir ileti.	Dize

Öğe

Toplu iş isteğindeki bir öğeyi tanımlar.

Name	Değer	Tür	XML öğesi adı
Batchıd	Toplu iş isteğinde bu öğeyi tanımlayan kullanıcı tanımlı kimlik. Örneğin, toplu işlem 10 öğe içeriyorsa, bunlara 1 ile 10 arasında kimlik atayabilirsiniz.	İşaretsiz Tamsayı	<entry batch_id="unsigned integer" method="string">
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.	BatchItemError	<Hata>
merchantId	Merchant Center mağaza kimliği.	İmzasız Uzun	<merchant_id>
Yöntem	Öğeye uygulanacak eylem. Olası değerler , getve deletedeğerleridirinsert. Öğe bir ürün teklifi ekliyor veya güncelleştiriyorsa yönteminiinsertolarak ayarlayın; öğe bir ürünü siliyorsa yönteminideleteolarak ayarlayın; ve öğe bir ürün alıyorsa yöntemini olarak getayarlayın. Dizeler büyük/küçük harfe duyarlı değildir.	Dize	Giriş> öğesinin method özniteliğine <bakın
Ürün	Ürün teklifi. Bu alanı bir istekte yalnızca ürün eklerken (güncelleştirirken) belirtir. Yanıt, yalnızca alır ve ekler (güncelleştirmeler) için bu alanı içerir.	Ürün	<Ürün>
Productıd	Tam ürün kimliği (örneğin, Online:en:US:Sku123). Bu alanı yalnızca bir ürün teklifini alırken veya silerken ekleyin. Toplu iş isteğine aynı ürün kimliğine sahip birden çok öğe eklemeyin.	Dize	<product_id>

Ürün

Bir ürünü tanımlar. Bu nesnedeki alanlar hakkında daha fazla bilgi için bkz . Akış dosyası nasıl düzenlenir?

JSON ve XML Adı	Değer	Tür	Ekleme için gerekli
additionalImageLinks <additional_image_link>	Ürün reklamında kullanılabilecek ürünün ek görüntülerinin URL'leri. Birden çok görüntü belirtmek için MMC ek görüntüleri kullanmaz; bu alan Google uyumluluğuna dahildir.	Dize[]	Hayır
Yetişkin <Yetişkin>	Öğenin yetişkin ürünü olup olmadığını belirleyen boole değeri. Öğenin hedef pazarı yetişkinlerse true olarak ayarlayın. Varsayılan değer false'tur. Yetişkin ürünlerinin desteklenmediğini ve reddedileceğini unutmayın.	Boole	Hayır
adwordsGrouping <adwords_grouping>	Alım başına maliyet (CPA) teklifi için bir ürün grubu. MMC bu alanı kullanmaz; Google uyumluluğuna dahildir.	Dize	Hayır
adwordsLabels <adwords_label>	Gruplandırılmış öğeler için etiketler (bkz. adwordsGrouping). Yalnızca Tıklama başına maliyet (CPC) için geçerlidir. MMC bu alanı kullanmaz; Google uyumluluğuna dahildir.	Dize[]	Hayır
adwordsRedirect <adwords_redirect>	Ürün reklamında kullanılacak URL. Belirtilirse, bu URL bağlantıda belirtilen URL'ye yeniden yönlendirilmelidir.	Dize	Hayır
ageGroup <age_group>	Öğenin hedef yaş grubu. Olası değerler şunlardır. Yetişkin Çocuklar Bebek Bebek Yenidoğan	Dize	Hayır
Kullanılabilir -lik <Kullanılabilir -lik>	Ürünün kullanılabilirlik durumu. Olası değerler şunlardır. stokta stokta yok Preorder Varsayılan değer stoktadır.	Dize	Evet
availabilityDate <availability_date>	Ön sipariş ürününün sevkiyat için kullanılacağı UTC tarihi (alana bakın availability ). Bu alan isteğe bağlıdır, ancak önceden sipariş edilen ürünün sevkiyat için kullanılıp kullanılamayacağını biliyorsanız, bu alanı ayarlamanız gerekir. Tarihi ISO 8601 biçiminde belirtin. NOT: MMC şu anda bu alanın içeriğini yoksayar.	Dize	Hayır
Marka <Marka>	Öğenin markası, üreticisi veya yayımcısı. Dize en fazla 10 sözcük ve 1.000 karakter içerebilir. Dizenin UX'te iyi görüntü olduğundan emin olmak için marka adını en fazla 70 karakterle sınırlamanız gerekir.	Dize	Evet
Kanal <Kanal>	Ürünün satış kanalı. Aşağıdakiler olası büyük/küçük harfe duyarlı olmayan değerlerdir. Yerel Online Ürün kimliğini oluşturmak için kanal kullanıldığından, ürünü mağazaya ekledikten sonra bu alanı değiştiremezsiniz.	Dize	Evet
Renk <Renk>	Ürünün baskın rengi. Renk bir renk karışımıysa, 3 renge kadar eğik çizgiyle ayrılmış bir liste (örneğin, kırmızı/yeşil/mavi) belirtebilirsiniz. Bir elbise birden çok renkte mevcutsa, her renk için bir ürün oluşturur ve ürünün çeşitlemelerini gruplandırmak için itemGroupId kullanırsınız. Alan 100 karakterle sınırlıdır. Giyim öğeleri için önerilir.	Dize	Hayır
Durum <Durum>	Ürünün koşulu. Olası değerler şunlardır. Yeni Yenilenmiş Kullanılan Varsayılan değer yenidir.	Dize	Evet
contentLanguage <content_language>	Ürün için iki harfli ISO 639-1 dil kodu. Olası büyük/küçük harfe duyarlı olmayan değerler şunlardır: Arnavut dili (kare) Boşnakça (bs) Bulgarca (bg) Hırvat dili (sa) Çekçe (cs) Felemenkçe (nl) İngilizce (en) Estonca (et) Fransızca (fr) Almanca (de) Yunanca (el) Macarca (hu) İzlanda dili (is) İtalyanca (it) Letonca (lv) Litvanca (lt) Makedon dili (mk) Malta dili (mt) Lehçe (pl) Portekizce (pt) Rumence (ro) Sırplık (sr) Slovakça (sk) Slovence (sl) İspanyolca (es) İsveççe (sv) Türkçe (tr) Ürün kimliğini oluşturmak için dil kullanıldığından, ürünü mağazaya ekledikten sonra bu alanı değiştiremezsiniz.	Dize	Evet
Customattributes <custom_attribute>	Satıcı tarafından kullanılan özel özniteliklerin listesi.	ProductCustomAttribute[]	Hayır
customGroups<custom_group>	Satıcı tarafından kullanılan özel grupların listesi.	ProductCustomGroup[]	Hayır
customLabel0 <custom_label_0>	Microsoft Alışveriş kampanyalarına yönelik ürünleri filtrelemek için kullanılan özel etiket 0. Etiket 100 karakterle sınırlıdır.	Dize	Hayır
customLabel1 <custom_label_1>	Microsoft Alışveriş kampanyalarına yönelik ürünleri filtrelemek için kullanılan özel etiket 1. Etiket 100 karakterle sınırlıdır.	Dize	Hayır
customLabel2 <custom_label_2>	Microsoft Alışveriş kampanyalarına yönelik ürünleri filtrelemek için kullanılan özel etiket 2. Etiket 100 karakterle sınırlıdır.	Dize	Hayır
customLabel3 <custom_label_3>	Microsoft Alışveriş kampanyalarına yönelik ürünleri filtrelemek için kullanılan özel etiket 3. Etiket 100 karakterle sınırlıdır.	Dize	Hayır
customLabel4 <custom_label_4>	Microsoft Alışveriş kampanyalarına yönelik ürünleri filtrelemek için kullanılan özel etiket 4. Etiket 100 karakterle sınırlıdır.	Dize	Hayır
Açıklama <Açıklama>	Ürünün açıklaması. Açıklama tanıtım metni içermeyebilir. Açıklama en fazla 10.000 karakterle sınırlıdır ve herhangi bir Unicode karakteri içerebilir. Açıklama, editoryal incelemeden geçirilecektir.	Dize	Hayır
Hedef <Hedef>	Ürünün hedeflenen hedefleri. MMC bu alanı kullanmaz; Google uyumluluğuna dahildir.	ProductDestination[]	Hayır
energyEfficiencyClass <energy_efficiency_class>	2010/30/AB sayılı AB yönergesinde tanımlanan enerji verimliliği sınıfı. Olası değerler şunlardır. A A+ A++ A+++ B C D E F G	Dize	Hayır
expirationDate <expiration_date>	Ürünün süresinin ne zaman dolacağını belirten UTC tarihi ve saati. Son kullanma tarihi belirtmezseniz ürünün süresi, ürünü eklediğiniz veya güncelleştirdiğiniz tarih ve saatten itibaren 30 gün süreyle dolar (tarih ve saat Microsoft sunucusunun saat dilimine bağlıdır). Bugünden itibaren 30 günden daha kısa bir süre sonu tarihi belirtmek için bu alanı kullanın. Süre sonu tarihiniz her zaman saat bileşenini içermeli ve saat dilimi veya uzaklık bilgilerini belirtmelidir. Aksi takdirde API, targetCountry kullanarak saat dilimini belirlemeye çalışır. Birden çok saat dilimine sahip ülkeler veya bölgeler için KULLANıLACAK saat dilimi API'sini belirler. Örneğin, ülke ABD ise, API pasifik standart saatini (PST) kullanır. Süresi dolmak üzere olan ve süresi dolmadan önce ürünleri izlemeniz ya da ürünü güncelleştirmeniz (ürün alanlarını güncelleştirmeniz gerekmez) ve bu da son kullanma tarihini otomatik olarak 30 gün daha uzatır. Son kullanma tarihini açıkça ayarlarsanız, kendiniz yeni bir sona erme tarihi ayarlamanız gerekir; ürünün güncelleştirilmesi, bu durumda son kullanma tarihini otomatik olarak 30 gün daha uzatmaz.	Dize	Hayır
Cinsiyet <Cinsiyet>	Ürünün hedeflediğini cinsiyet. Olası değerler şunlardır. Bayan Erkek Unisex	Dize	Hayır
googleProductCategory <google_product_category>	Ürünün bulunduğu ürün kategorisi. Bir kategori dizesi (örneğin, Hayvanlar & Evcil Hayvan Malzemeleri >> Kuş Malzemeleri) veya kategori kimliği (örneğin, 3) belirtebilirsiniz. Kategori dizesi için, alt kategorilerin listesi büyüktür simgesi ('>') ile sınırlandırılır. Alan 255 karakterle sınırlıdır. Kategori dizelerinin ve kimliklerin listesi için bkz. Kategoriler.	Dize	Hayır
Gtın <Gtın>	Üretici tarafından atanan Global Ticaret Madde Numarası (GTIN). Üretici bir GTIN atarsa bunu belirtmeniz gerekir. GtIN türleri aşağıdadır. EAN (Avrupa Makale Numarası) ISBN (Uluslararası Standart Kitap Numarası) JAN (Japonca Makale Numarası) UPC (Evrensel Ürün Kodu)	Dize	Evet
Kimliği <Kimliği>	Tam ürün kimliği. Id, kanal, contentLanguage, targetCountry ve offerId değerlerinin bileşimidir. Kimlik büyük/küçük harfe duyarlıdır. Bir ürünü almak veya silmek için bu kimliği kullanın.	Dize	Hayır
identifierExists <identifier_exists>	Ürün teklifinin gtin, mpn veya marka tanımlayıcılarını belirtip belirtmeyeceğini belirleyen boole değeri. Varsayılan değer true'dur. Tanımlayıcıların üçünü de belirtmezseniz false olarak ayarlayın. Benzersiz ürün tanımlayıcıları, genel marketteki bir ürünü tanımlar. Ürünlerinizi benzersiz tanımlayıcılarla etiketlemek, müşterilerin ürünlerinizi bulmasını kolaylaştırır. Biliniyorsa üç tanımlayıcıyı da belirtmelisiniz.	Boole	Hayır
imageLink <image_link>	Ürün reklamında kullanılabilecek ürünün görüntüsünün URL'si. URL 1.000 karakterle sınırlıdır ve HTTP veya HTTPS protokollerini kullanabilir. İzin verilen görüntü türleri bmp, gif, exif, jpg, png ve tiff'tır. Önerilen görüntü boyutu 200x200 pikseldir. Görüntü 3,9 MB'ı aşamaz. Görüntüde editoryal inceleme yapılacaktır.	Dize	Evet
isBundle <is_bundle>	Ürünün satıcı tanımlı bir paket olup olmadığını belirleyen boole değeri. Ürün bir paketse değer doğrudur .	Boole	Hayır
itemGroupId <item_group_id>	Aynı ürünün tüm çeşitlemelerini gruplandırmak için kullanılabilecek bir kimlik. Örneğin, elbise 3 renkte mevcutsa, her renk için bir ürün oluşturabilir ve bunları gruplandırmak için bu kimliği kullanabilirsiniz. Genellikle, renge, malzemeye, desene veya boyuta göre değişiklik gösteren öğeleri gruplandırırsınız. Kimlik bir katalog içinde benzersiz olmalıdır ve 50 karakterle sınırlıdır.	Dize	Hayır
Tür <Tür>	Nesnenin türü. Bu alan olarak content#productayarlanır.	Dize	Hayır
Bağlantı <Bağlantı>	Web sitenizdeki ürün sayfasının URL'si. URL 2.000 karakterle sınırlıdır ve HTTP veya HTTPS protokollerini kullanabilir. Etki alanı, mağazanın etki alanıyla eşleşmelidir. Bağlantı, ürün reklamında kullanılır. URL yeniden yönlendirilmeyebilir. Ürün reklamında bu URL'ye yönlendirilebilen başka bir URL kullanmak için bkz. adwordsRedirect. Bu bağlantının işaret olduğu web sayfası, editoryal incelemeden geçirilecektir.	Dize	Evet
Malzeme <Malzeme>	Ürünün baskın malzemesi. Malzeme bir malzeme karışımıysa, en fazla 3 malzemeden oluşan eğik çizgiyle ayrılmış bir liste belirtebilirsiniz (örneğin, deri/süet/ipek). Bir elbise birden çok malzemede mevcutsa, her malzeme için bir ürün oluşturur ve ürünün çeşitlemelerini gruplandırmak için itemGroupId kullanırsınız. Alan 200 karakterle sınırlıdır. Giyim öğeleri için önerilir.	Dize	Hayır
mobileLink <mobile_link>	Web sayfasının ürünle ilgili bilgileri içeren mobil cihazlar için iyileştirilmiş sürümünün URL'si ( bağlantıya bakın).	Dize	Hayır
multipack <multipack>	Tek bir birim olarak satılan özdeş ürünlerin sayısı (örneğin, 4 el feneri). Fiyatı ayarlarken, çoklu paketin toplam fiyatı olmalıdır.	Tamsayı	Hayır
Mpn <Mpn>	Ürünün üretici parça numarası (MPN). Üretici bir MPN atarsa, bunu belirtmeniz gerekir. MPN 70 karakterle sınırlıdır.	Dize	Evet
offerId <offer_id>	Sunulan ürünün kullanıcı tanımlı kimliği. Teklif kimliği büyük/küçük harfe duyarlı değildir ve katalog içinde benzersiz olmalıdır ve en fazla 50 karakterle sınırlıdır. Ürün kimliğini oluşturmak için teklif kimliği kullanıldığından, ürünü mağazaya ekledikten sonra bu alanı değiştiremezsiniz.	Dize	Evet
onlineOnly <online_only>	Ürünün yalnızca çevrimiçi satın alınabilir olup olmadığını belirleyen boole değeri. Ürün yalnızca çevrimiçi olarak kullanılabiliyorsa değer doğrudur . Varsayılan değer false'tur.	Boole	Hayır
Desen <Desen>	Ürünün deseni veya grafik baskısı (örneğin, plaid). Desen 100 karakterle sınırlıdır. Bir elbise birden çok desende mevcutsa, her desen için bir ürün oluşturur ve ürünün çeşitlemelerini gruplandırmak için itemGroupId kullanırsınız. Giyim öğeleri için önerilir.	Dize	Hayır
Fiyat <Fiyat>	Ürünün fiyatı. Fiyatı hedef ülkenin 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şmelidir ( bağlantıya bakın) 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. 1. googleProductCategory alanı aşağıdaki kategorilerden birine ayarlanır:     - Elektronik > İletişim > Telefon > Cep Telefonları     - Elektronik > Bilgisayarlar > Tablet Bilgisayarlar 2. Başlık alanı aşağıdaki anahtar sözcüklerden birini içerir:     -Sözleşme     -Taksit     -Kira     -Ödeme Yukarıdaki anahtar sözcükler İngilizce olarak gösterilmiştir; ancak, başlık ve anahtar sözcük belirtilen pazarın dilinde olmalıdır. Genellikle başlıkta "... taksit planıyla" veya "... yalnızca sözleşme ile". Sözleşme anahtar sözcüğü tüm pazarlarda kullanılabilir; ancak, taksit, ödeme ve kiralama yalnızca ABD pazarında kullanılabilir.	Productprice	Evet
productType <product_type>	Reklamveren tarafından tanımlanan ve uygulamasından googleProductCategoryfarklı olabilecek ürün kategorisi. Örneğin, Hayvanlar & Evcil Hayvan Malzemeleri > Evcil Hayvan malzemeleri > Kuş Malzemeleri > Veteriner. Alt kategorilerin listesi büyüktür simgesi ('>') ile sınırlandırılır. Alan 750 karakterle sınırlıdır. Virgülle ayrılmış birden çok kategori dizesi belirtebilirsiniz. Örneğin, Costumes & Accessories > Wig Accessories > Wig Caps, Costumes & Accessories > Wig Accessories > Wig Glue.	Dize	Hayır
promotionId <promotion_id>	Promosyonlar akışınızdaki promosyonları tanımlayan virgülle ayrılmış kimlik listesi. En fazla 10 promosyon kimlik belirtebilirsiniz. Kimlik en az 1 karakter ve en fazla 60 karakter içermelidir. İzin verilen karakterler herhangi bir alfasayısal karakter, tire (-) ve alt çizgidir (_). Bir pazar için tüm kimlikler (bkz. contentLanguage ve targetCountry) benzersiz olmalıdır. Örneğin, bir pazar içinde PROMO1 ve promo1 kullanamazsınız, ancak PROMO1'i en-US pazarında ve promo1'i en-GB pazarında kullanabilirsiniz. Bir veya daha fazla üründe aynı benzersiz promosyon kimliğini belirtebilirsiniz. Belirttiğiniz kimlik Promosyonlar akışınızdaki (aynı hedef ülke için) bir promosyon kimliğiyle eşleşiyorsa Microsoft ürünü yükseltir. Kimlikler yalnızca büyük/küçük harf aynıysa eşleşilir. Örneğin, ürünün kimliği PROMO1 ve akışın kimliği PROMO1 ise kimlikler eşleşir, ancak akışın kimliği Promo1 ise eşleşmez. Ürünün gelecekte yanlışlıkla yükseltilmemesini sağlamak için, sona eren promosyonların kimliklerini kaldırmanız gerekir. Kimlik, promosyon sona erdikten sonra 6 ay boyunca Promosyonlar akışında yeniden kullanılamasa da, kimlik bundan sonra başka bir promosyonda yeniden kullanılırsa ürün yükseltilir.	Dize	Hayır
salePrice <sale_price>	Öğenin satış fiyatı. Satış fiyatı 0,01 (1 sent) ile 10000000,00 (10 milyon) aralığında olmalıdır. 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. Aşağıdaki koşullar karşılanırsa satış fiyatını 0,0 (sıfır) olarak ayarlayabilirsiniz. 1. googleProductCategory alanı aşağıdaki kategorilerden birine ayarlanır:     - Elektronik > İletişim > Telefon > Cep Telefonları     - Elektronik > Bilgisayarlar > Tablet Bilgisayarlar 2. Başlık alanı aşağıdaki anahtar sözcüklerden birini içerir:     -Sözleşme     -Taksit     -Kira     -Ödeme Yukarıdaki anahtar sözcükler İngilizce olarak gösterilmiştir; ancak, başlık ve anahtar sözcük belirtilen pazarın dilinde olmalıdır. Genellikle başlıkta "... taksit planıyla" veya "... yalnızca sözleşme ile". Sözleşme anahtar sözcüğü tüm pazarlarda kullanılabilir; ancak, taksit, ödeme ve kiralama yalnızca ABD pazarında kullanılabilir.	Productprice	Hayır
salePriceEffectiveDate <sale_price_effective_date>	Satışın UTC başlangıç ve bitiş tarihi. Tarihleri 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.	Dize	Hayır
sellerName <seller_name>	Ürünü satan satıcının adı. Yalnızca toplayıcılar tarafından satıcıyı tanımlamak için kullanılır. Toplayıcılar, bireysel satıcılar adına davranan üçüncü taraf sitelerdir. Bir toplayıcının satıcı adına gönderdiği ürünler, Microsoft Reklam ilkelerine ve Hizmet Koşulları'na uymalıdır. Toplayıcılar bu alanı satıcıların adına ayarlamalıdır. Çağıran bir toplayıcı değilse ve bu alan ayarlanmadıysa, varsayılan olarak mağaza adı olur. Ad 255 karakterle sınırlıdır.	Dize	Hayır
Nakliye <Nakliye>	Ürünü konuma göre gönderme fiyatı. NOT: Hedef ülke DE (Almanya) ise gönderim gereklidir; aksi takdirde isteğe bağlıdır.	ProductShipping[]	Evet
shippingLabel <shipping_label>	Sevkiyat etiketi. NOT: Hedef ülke DE (Almanya) ise gönderim bilgileri gereklidir; aksi takdirde isteğe bağlıdır.	Dize	Evet
shippingWeight <shipping_weight>	Ürünün ağırlığı. Ağırlık, gönderim amacıyla kullanılır. NOT: Hedef ülke DE (Almanya) ise gönderim bilgileri gereklidir; aksi takdirde isteğe bağlıdır.	ProductShippingWeight	Evet
Boyut <Boyutu>	Ürünün kullanılabilir boyutları. Örneğin, küçük, orta ve büyük. Boyutlandırmayı tutarlı bir şekilde uygulayın. Boyut değeri kullanıcı tanımlıdır ancak hedef ülkenize dayalı olmalıdır. Bu alan, hedefleme sırasında tüm Apparel & Donatıları ürünleri için gereklidir: Fransa, Almanya, Birleşik Krallık ve Birleşik Devletler.	Dize[]	Hayır
sizeSystem <size_system>	Ürünü boyutlandırmak için kullanılan ölçüm sistemi. Örneğin, ayakkabılar ABD sistemi veya Birleşik Krallık sistemi kullanılarak boyutlandırılabilir. Olası değerler şunlardır. AU DE FR INGİLTERE US Varsayılan olarak hedef ülke tarafından kullanılan sistem kullanılır. Giyim öğeleri için önerilir.	Dize	Hayır
Sizetype <Size_type>	Ürünün kesimi. Olası değerler şunlardır. Normal Hamile Petite Artı büyük ve uzun Varsayılan olarak Normal'i kullanır. Giyim öğeleri için önerilir.	Dize	Hayır
targetCountry <target_country>	Hedef ülkenin (ürünü tanıtmak istediğiniz ülke) iki harfli ISO 3166 ülke kodu. Ülke, katalog tarafından belirtilen pazarla eşleşmelidir. Olası büyük/küçük harfe duyarlı olmayan değerler şunlardır: AD (Andorra) AL (Arnavutluk) AR (Arjantin) AW (Aruba) AT (Avusturya) AU (Avustralya) BS (Bahamalar) BD (Bangladeş) BA (Bosna-Hersek) BE (Belçika) BO (Bolivya) BG (Bulgaristan) BR (Brezilya) BN (Brunei) CA (Kanada) KY (Cayman Adaları) CH (İsviçre) CL (Şili) CO (Kolombiya) CR (Kosta Rika) CY (Kıbrıs) CZ (Çek Cumhuriyeti) DE (Almanya) DK (Danimarka) DM (Dominika) DO (Dominik Cumhuriyeti) EC (Ekvador) SV (El Salvador) EE (Estonya) ES (İspanya) FJ (Fiji) FI (Finlandiya) FR (Fransa) GF (Fransız Guyanası) PF (Fransız Polinezyası) GB (Büyük Britanya) GR (Yunanistan) GU (Guam) GT (Guatemala) GY (Guyana) HT (Haiti) HN (Honduras) İk (Hırvatistan) HU (Macaristan) Kimlik (Endonezya) IE (İrlanda) IN (Hindistan) IS (İzlanda) BT (İtalya) LI (Liechtenstein) LT (Litvanya) LU (Lüksemburg) LV (Letonya) MV (Maldivler) MC (Monaco) ME (Karadağ) MK (Kuzey Makedonya) MT (Malta) MQ (Martinique) MY (Malezya) MX (Meksika) MN (Moğolistan) MS (Montserrat) NP (Nepal) NL (Hollanda) NC (Yeni Kaledonya) HAYIR (Norveç) NZ (Yeni Zelanda) PA (Panama) PG (Papua Yeni Gine) PH (Filipinler) PY (Paraguay) PE (Peru) PL (Polonya) PT (Portekiz) PR (Porto Riko) RO (Romanya) RS (Sırbistan) LK (Sri Lanka) SE (İsveç) SG (Singapur) SI (Slovenya) SK (Slovakya) SM (San Marino) TH (Tayland) TT (Trinidad ve Tobago) TR (Türkiye) ABD (Birleşik Devletler) UT (Uruguay) VA (Vatikan) VE (Venezuela) VN (Vietnam) ZA (Güney Afrika) Ülke ürün kimliğini oluşturmak için kullanıldığından, ürünü mağazaya ekledikten sonra bu alanı değiştiremezsiniz.	Dize	Evet
Vergi <Vergi>	Ürünün vergi bilgileri. MMC bu alanı kullanmaz; Google uyumluluğuna dahildir.	ProductTax[]	Hayır
Başlık <Başlık>	Ürünün başlığı (örneğin, Kadın Ayakkabıları). Başlık tanıtım metni içermeyebilir. Başlık en fazla 150 karakterle sınırlıdır ve herhangi bir Unicode karakteri içerebilir. Başlık, editoryal incelemeden geçirilecektir.	Dize	Evet
unitPricingBaseMeasure <unit_pricing_base_measure>	Ürünün fiyatlandırma için temel ölçüsü (örneğin, 100ml, fiyatın 100ml birimine göre hesaplanmış olduğu anlamına gelir). Ağırlık: oz, lb, mg, g, kg Hacim (ABD emperyal): floz, pt, qt, gal Hacim: ml, cl, l, cbm Uzunluk: in, ft, yd, cm, m Alan: sqft, sqm Birim başına: ct	UnitPricingBaseMeasure	Hayır
unitPricingMeasure <unit_pricing_measure>	Ürünün satıldığı ölçü ve boyutu. Ağırlık: oz, lb, mg, g, kg Hacim (ABD emperyal): floz, pt, qt, gal Hacim: ml, cl, l, cbm Uzunluk: in, ft, yd, cm, m Alan: sqft, sqm Birim başına: ct	UnitPricingMeasure	Hayır
validatedDestinations <validated_destination>	Doğrulamayı geçmiş hedeflenen hedeflerin salt okunur listesi. MMC bu alanı kullanmaz; Google uyumluluğuna dahildir.	Dize[]	Hayır
Uyarı	Ürün teklifiyle ilgili sorunlar hakkındaki uyarıların listesi. Teklif kabul edildi, ancak sorunları en erken kolaylıkta çözmeniz gerekir. Örneğin, bilmeleri gerekiyorsa gtin, mpn ve marka tanımlayıcılarını belirtmezseniz MMC uyarılar döndürür. Teklif bu alanı yalnızca ekleme/güncelleştirmenin yanıtında içerir.	Uyarı[]	Hayır

ProductCustomAttribute

Özel bir öznitelik tanımlar.

Name	Değer	Tür	XML öğesi adı
Adı	Özniteliğin adını alır veya ayarlar.	Dize	<Adı>
Türü	Özniteliğin türünü alır veya ayarlar. Olası değerler şunlardır. Boolean datetimerange Float Grup Int Fiyat Metin Zaman Url	Dize	<Türü>
Birim	Özniteliğin ölçü birimini alır veya ayarlar. Yalnızca INT ve FLOAT türündeki değerler için kullanılır.	Dize	<Birim>
Değer	Özniteliğin değerini alır veya ayarlar.	Dize	<Değer>

ProductCustomGroup

Bir grup müşteri özniteliği tanımlar.

Name	Değer	Tür	XML öğesi adı
Öznitelik	Grubun özniteliklerini alır veya ayarlar.	ProductCustomAttribute	<Öznitelik>
Adı	Grubun adını alır veya ayarlar.	Dize	<Adı>

ProductDestination

Hedefi tanımlar.

Name	Değer	Tür	XML öğesi adı
Niyet	Olası değerler şunlardır. Varsayılan Dış -lanan Isteğe bağlı Gerekli	Dize	<Niyet>
destinationName	Hedefin adını alır veya ayarlar.	Dize	<destination_name>

Productprice

Bir ürünün fiyatını veya satış fiyatını tanımlar.

Name	Değer	Tür	XML öğesi adı
Para birimi	Fiyatın belirtildiği para birimini alır veya ayarlar. ISO 4217 para birimi kodlarını kullanarak para birimini belirtin. Olası değerler şunlardır. AUD (Avustralya doları) CHF (İsviçre frangı) CAD (Kanada doları) EUR (Euro) GBP (Büyük Britanya poundu) IDR (Endonezya rupisi) INR (Hint rupisi) MYR (Malezya ringgiti) NZD (Yeni Zelanda doları) PHP (Filipinler pesosu) SEK (İsveç kronu) SGD (Singapur doları) THB (Tay bahtı) ABD Doları (Birleşik Devletler dolar) VND (Vietnam dong)	Dize	currency Öznitelik. Örneğin, <fiyat para birimi="USD">.
Değer	Öğenin fiyatını alır veya ayarlar. '$' gibi para birimi simgeleri eklemeyin.	Çift	Metin değeri. Örneğin, <price currency="USD">38.0<\price>.

Ürünler

Ürünlerin listesini tanımlar. Bunun Liste isteğinin döndürdüğü en üst düzey nesne olduğunu unutmayın.

Name	Değer	Tür	XML öğesi adı
Tür	Nesnenin türünü alır. Bu alan content#productsListResponse olarak ayarlanır.	Dize	<Tür>
nextPageToken	Sonuçların sonraki sayfasını almak için kullanılan belirteci alır. Nesne bu alanı içermiyorsa, alınacak başka sayfa yoktur. Bkz. başlangıç belirteci.	Dize	<next_page_token>
Kaynak	Ürün listesini alır. Katalog herhangi bir teklif içermiyorsa, dizi boş olur.	Ürün[]	<Ürünler>

ProductShipping

Sevkiyat maliyetini tanımlar.

Name	Değer	Tür	XML öğesi adı
Ülke	Öğenin sevk edildiği ülkenin iki harfli ISO 3166 ülke kodunu alır veya ayarlar.	Dize	<Ülke>
locationGroupName	Konum grubu adını alır veya ayarlar.	Dize	<location_group_name>
Locationıd	Öğenin sevk edildiği coğrafi konumun kimliğini alır veya ayarlar. Kimliklerin listesi için bkz . Coğrafi Konum Kodları.	Dize	<location_id>
Postakodu	Öğenin sevk edildiği konumun posta kodunu veya posta kodu aralığını alır veya ayarlar. Posta kodunu aşağıdaki gibi belirtebilirsiniz: Tam bir posta kodu: 94114 Joker karakter içeren bir posta kodu (yalnızca sonek): 94* Kod aralığı: 94002-95460 Joker karakterler içeren bir kod aralığı (posta kodu ön ekleri eşit uzunlukta olmalıdır: 94*-95*	Dize	<postal_code>
Fiyat	Öğeyi belirtilen konuma göndermek için sabit fiyatı alır veya ayarlar.	Productprice	<Fiyat>
Bölge	Öğenin gönderildiği coğrafi bölgeyi (örneğin, posta kodu) alır veya ayarlar.	Dize	<Bölge>
Hizmet	Hizmet sınıfını veya teslim hızını açıklayan bir metin açıklaması alır veya ayarlar.	Dize	<Hizmet>

ProductShippingWeight

Öğenin sevkiyat ağırlığını tanımlar.

Name	Değer	Tür	XML öğesi adı
Birim	Ölçü birimini alır veya ayarlar.	Dize	unit Öznitelik. Örneğin shipping_weight <unit="oz">.
Değer	Öğenin sevkiyat maliyetini hesaplamak için kullanılan öğenin ağırlığını alır veya ayarlar.	Dize	Metin değeri. Örneğin shipping_weight <unit="oz">20,3<shipping_weight>.

ProductTax

Geçerli vergileri belirleyen coğrafi konumu tanımlar.

Name	Değer	Tür	XML öğesi adı
Ülke	Vergi oranı geçerli olan ülkeyi alır veya ayarlar. İki harfli ISO 3166 ülke kodunu kullanır.	Dize	<Ülke>
Locationıd	Vergi oranı geçerli olan coğrafi konumun kimliğini alır veya ayarlar. Kimliklerin listesi için bkz . Coğrafi Konum Kodları.	Uzun	<location_id>
Postakodu	Vergi oranı geçerli olan posta kodunu veya posta kodu aralığını alır veya ayarlar. Posta kodunu aşağıdaki gibi belirtebilirsiniz: Tam bir posta kodu: 94114 Joker karakter içeren bir posta kodu (yalnızca sonek): 94* Kod aralığı: 94002-95460 Joker karakterler içeren bir kod aralığı (posta kodu ön ekleri eşit uzunlukta olmalıdır: 94*-95*	Dize	<postal_code>
Oranı	Öğenin fiyatına uygulanacak vergi yüzdesi oranını alır veya ayarlar. %5 oranı belirtmek için bu alanı 5 olarak ayarlayın. %9,8 oranı belirtmek için bu alanı 9,8 olarak ayarlayın.	Çift	<Oranı>
Bölge	Vergi oranı geçerli olan bir coğrafi bölgeyi alır veya ayarlar.	Dize	<Bölge>
taxShip	Verginin sevkiyat maliyetine uygulanıp uygulanmayacağını belirleyen bir Boole değeri alır veya ayarlar. Sevkiyatta vergi tahsil edilirse true olarak ayarlayın.	Boole	<Gemi>

UnitPricing

Maddenin birim fiyatını tanımlar.

Name	Değer	Tür	XML öğesi adı
Birim	Ölçü birimini alır veya ayarlar. Örneğin, fiyat ons başına ise oz .	Dize	unit Öznitelik. Örneğin, <unit_pricing_measure unit="oz">
Değer	Birim başına fiyatı alır veya ayarlar.	Çift	Metin değeri. Örneğin, <unit_pricing_measure unit="oz">34.5<\unit_pricing_measure>

Uyarı

Bir uyarı iletisi tanımlar.

Name	Değer	Tür	XML öğesi adı
Etki alanı	Yalnızca dahili kullanım için.	Dize	<Etki alanı>
ileti	Uyarının açıklaması.	Dize	<internalReason>
Neden	Teklifin bir uyarı oluşturmasının nedeni. Örneğin, üreticinin atadığı biliniyorsa bir tanımlayıcı (gtin, mpn veya marka) sağlamazsınız.	Dize	<Neden>

HTTP durum kodları

İstekler aşağıdaki HTTP durum kodlarını döndürebilir.

Durum kodu	Açıklama
200	Başarı.
204	Ürün 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. Batch: Hata oluşursa, başarısız olan toplu iş öğesi hataları içerir.
401	Yetki -siz. Kullanıcının kimlik bilgileri geçerli değil.
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ı.