ürün kaynak çağrıları

products kaynağı, 60'tan fazla ürün özelliği üzerinde büyük ölçüde esneklik ve kontrol sağlar.Google Alışveriş'te gösterilmek üzere onaylanmak için zorunlu olan ve eklenmesi gereken bir dizi alan vardır. Konum, ürün türü, ürün varyantları ve ürün paketleri gibi çeşitli koşullara bağlı olarak zorunlu hale gelebilecek bir dizi isteğe bağlı alan vardır. Ürünler için yapılandırılabilen 60'tan fazla isteğe bağlı parametre hakkında daha fazla bilgi için Ürün Verileri Spesifikasyonları'na bakın.

products kaynağı, tek seferde bir ürün insert, get, update ve delete etmenize, ayrıca Merchant Center veritabanındaki tüm ürünleri list etmenize olanak tanır.

productstatuses kaynağı, belirli bir ürünün hedef için onaylanma veya onaylanmama durumunu kontrol etmek amacıyla kullanılabilir. Hangi ürünlerde veri kalitesi sorunları olabileceği ve bu sorunların neler olabileceği hakkında daha fazla bilgi için ürün durumu kılavuzuna bakın.

API örneklerimizde üç ürün kullanıyoruz: iki Google tişörtü ve bir Google şapkası. Tek tek ürünleri ve ürün gruplarını eklemek, almak, güncellemek, listelemek ve silmek için products kaynak çağrıları yapmak üzere aşağıdaki tabloda gösterilen minimum ürün verisi grubunu kullanıyoruz.

Kargo ve vergi bilgilerinin ürün düzeyinde değil, hesap düzeyinde yapılandırılması önerilir.

Pazar yerlerinin çok satıcılı alt hesaplarında tüm ürünler external_seller_id alanını içermelidir. Daha fazla bilgi için Ürün kimlikleri bölümüne bakın.

id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
title	The Black Google Tee	Google Tee Green	Google Twill Şapka
açıklama	The Black Google Tee	%100 pamuk Google tişörtü	Klasik Google şapkası
öğe grubu kodu	google_tee	google_tee
bağlantı	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
koşul	Yeni	Yeni	Yeni
fiyat	21.99 TRY	21.99 TRY	10,99 ABD doları
hazır bulunma oranı	Stokta	Stokta	Stokta
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin	9504000059422	9504000059446	9504000059452
mpn	00638NIC	00638ANG	00638ABC
marka	Google	Google	Google
Google ürün kategorisi	Giyim ve Aksesuar > Kıyafet	Giyim ve Aksesuar > Kıyafet	Giyim ve Aksesuar > Giyim Aksesuarları > Şapkalar
renk	siyah	yeşil	siyah
beden	L	A	A
age_group	adult	adult	adult
gender	erkek	erkek	üniseks
included_destination	Shopping Actions, Alışveriş reklamları	Shopping Actions, Alışveriş reklamları	Shopping Actions

products.insert

Tek bir ürün eklemek için aşağıdaki istek URL'sini kullanın ve satıcı kimliğinizi ile örnek bir JSON gövdesi belirtin. Ekleme işlemiyle yeni ürün oluşturulur. Belirli bir ürün için channel, contentLanguage, offerId ve feedLabel özelliklerinin değerleri varsa bu yöntem, söz konusu girişi günceller ve belirli ürün için önceki API çağrılarındaki tüm verileri değiştirir.

7 günden uzun süredir tüm hedeflerden hariç tutulan ürünler otomatik olarak silinir.

Gösterilen örnekte, mevcut ürünlere yeni bir "Siyah Google Tişörtü" ekleniyor.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert için örnek istek gövdesi çağrısı:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

Bir ürünün JSON gövdesinde özel özellikleri de ayarlanabilir. Örneğin, bir müşterinin sipariş edebileceği öğe sayısını sınırlamak için tek bir ürün için purchase_quantity_limit belirleyebiliriz:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

purchase_quantity_limit özel özelliğinin, ürün tanımı için müşteri siparişi başına bir satın alma sınırı belirlediğini ve feed'ler tarafından da desteklendiğini unutmayın. Bu özellik, API tarafından tam olarak desteklenene kadar beta sürümündedir. Satıcılar, ek özel özellikler ekleyebilir ancak bu özellikler API'ler tarafından özel bir işleme tabi tutulmaz.

Başarılı bir çağrı, HTTP 200 kodu ve yalnızca id, offerId, contentLanguage, feedLabel ve channel özelliklerinin doldurulduğu, eklenen ürün kaynağını içeren bir yanıt gövdesi döndürür:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Merchant Center veritabanındaki belirli bir ürün hakkında bilgi edinmek için products.get kullanın. Yeni eklenen bir ürünün bu çağrı üzerinden kullanılabilir olması birkaç dakika sürebilir.

Aşağıdaki HTTP isteği URL'sini ve parametrelerini, satıcı kimliğinizi ve almak istediğiniz ürünün ürün kimliğini (REST kimliği biçimi) kullanın:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Başarılı bir çağrı, yanıt gövdesinde bir HTTP 200 ve "ürün kaynağı" döndürür. Kimliği online:en:US:1111111111 olan bir üründen alınan örnek ürün verilerini aşağıda bulabilirsiniz:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

Tek bir ürünü güncellemek için aşağıdaki istek URL'sini PATCH yöntemiyle kullanın. Satıcı kimliğinizi, ürün kimliğinizi ve ürün için güncellemek istediğiniz verileri içeren bir JSON gövdesi belirtin. Tüm geçerli alanların sağlanmasını gerektiren products.insert'dan farklı olarak products.update, yalnızca değiştirmek istediğiniz alanları belirtmenizi gerektirir.

Bir özellik eklemek veya değiştirmek için JSON gövdesinde yeni değerle alanı belirtin. Gösterilen örnek, mevcut bir "Siyah Google Tişörtü"nün title ve description özelliklerini istek gövdesinde sağlanan ürün verileriyle güncelleyerek diğer tüm alanları olduğu gibi bırakır.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update için örnek istek gövdesi çağrısı:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

Yalnızca üst düzey alanlar products.update isteğiyle güncellenebilir. İç içe yerleştirilmiş alanları güncellemek istiyorsanız en üst düzeydeki nesnenin tamamını sağlamanız gerekir.

Gösterilen örnek, mevcut bir ürünün iç içe yerleştirilmiş alanları da dahil olmak üzere üst düzey salePrice nesnesini istek gövdesinde sağlanan ürün verileriyle güncelleyecek ve diğer tüm alanları değiştirmeden bırakacaktır.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

İsteğin gövdesinde yer alan diğer alanlarda değişiklik yapmadan güncellenecek belirli alanları seçmek için updateMask belirtebilirsiniz. Bu sorgu dizesi parametresi, değiştirmek istediğiniz alanların virgülle ayrılmış bir listesi olmalıdır. updateMask, yalnızca adlandırılmış alanların güncelleneceğini onaylamak istediğinizde kullanışlıdır. updateMask belirtmemek, yukarıdaki örnekte gösterildiği gibi, istekteki güncellenecek tüm alanları işaretlemekle aynıdır.

Gösterilen örnek, mevcut "Black Google Tee" ürününün description ve availability özelliklerini yalnızca istek gövdesinde sağlanan ilgili ürün verileriyle güncelleyecek ve title dahil olmak üzere diğer tüm alanları değiştirmeden bırakacaktır.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update için örnek istek gövdesi çağrısı:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

updateMask listesinde sağlanan ancak isteğin gövdesinde bulunmayan bir alan varsa bu alan, mevcutsa Product kaynağında silinir.

Gösterilen örnekte, updateMask alanı için değeri kaldırmak üzere salePrice kullanılacaktır.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

Örnek istek metni, silmek için salePrice alanını içermemelidir. Gövde metni sağlamayabilir veya boş bir gövde metni gönderebilirsiniz. Diğer alanlar, updateMask içinde görünmedikleri sürece değiştirilmez.

updateMask öğesini bir products.custombatch isteğinde kullanmak için updateMask, isteğin gövde bölümünde belirtilmelidir.

Gösterilen örnek, toplu girişle sağlanan ürün verileriyle products.custombatch kullanılarak mevcut bir "Siyah Google Tişörtü"nün price ve availability özelliklerini güncelleyecek, title ve description dahil olmak üzere diğer tüm alanları değiştirmeden bırakacaktır.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

Tek bir ürünü silmek için örnek HTTP isteği URL'si, satıcı kimliğiniz ve silmek istediğiniz ürünün ürün kimliği (online:en:US:1111111111 gibi REST kimliği biçiminde) ile birlikte products.delete kullanın:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Başarılı bir yanıt, yanıt gövdesi içermeyen bir HTTP Status 204 döndürür.

products.list

products.list, bir satıcının Merchant Center veritabanında bulunan tüm ürünlerini listeler. Aşağıdaki istek URL'sini kullanın:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

Başarılı bir çağrı, HTTP 200 ve "resources" anahtarındaki ürünler için JSON verileri döndürür.

Aşağıdaki üç örnek ürün döndürülür:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}