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

Merchant API'nin beta sürümünü tanıtmak istiyoruz. Bu, Content API'nin yeni sürümüdür ve gelecekte özeldir.

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 bir dizi alan vardır ve bunların eklenmesi gerekir. Konum, ürün türü, ürün varyantları ve ürün paketleri gibi değişen koşullara bağlı olarak zorunlu hâle getirilebilecek birkaç 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ı bölümüne bakın.

products kaynağı sayesinde aynı anda insert, get, update ve delete ürünleri ve Merchant Center veritabanında tüm ürünleri list kullanabilirsiniz.

productstatuses kaynağı, belirli bir ürünün hedef için onay veya ret durumunu kontrol etmek amacıyla kullanılabilir. Hangi ürünlerde veri kalitesi sorunları olabilecek 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ı. Ayrı ayrı ürün ve ürün grubu eklemek, almak, güncellemek, listelemek ve silmek için products kaynak çağrısı yapmak üzere aşağıdaki tabloda gösterilen minimum ürün verilerini kullanırız.

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ünlerde external_seller_id alanı bulunmalıdır. Daha fazla ayrıntı 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	Siyah Google Tişörtü	Google Tişört Yeşili	Google Kumaş Şapka
açıklama	Siyah Google Tişörtü	%100 pamuklu 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 TRY
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
brand	Google	Google	Google
Google ürün kategorisi	Giyim ve Aksesuar > Giyim	Giyim ve Aksesuar > Giyim	Giyim ve Aksesuar > Kıyafet Aksesuarları > Şapkalar
renk	siyah	yeşil	siyah
beden	L	M	M
age_group	yetişkin	yetişkin	yetişkin
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 satıcı kimliğinizi ve örnek bir JSON gövdesini belirterek aşağıdaki istek URL'sini kullanın. Ekleme işlemi yeni ürünü oluşturur. Belirli bir ürün için channel, contentLanguage, offerId ve feedLabel özellikleri için değer varsa bu yöntem, ilgili girişi günceller ve söz konusu ürün için önceki API çağrılarına ait tüm verileri değiştirir.

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

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

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

products.insert için örnek istek gövde ç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 ayarlanmış özel özellikleri de olabilir. Örneğin, bir müşterinin sipariş verebileceği öğe sayısını sınırlamak amacıyla tek bir ürün için purchase_quantity_limit ayarlayabiliriz:

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

purchase_quantity_limit özel özelliğinin, ürün tanımında müşteri siparişi başına 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. İlave özel özellikler satıcı tarafından eklenebilir ancak API'ler tarafından belirli bir işlem yapılmaz.

Başarılı bir çağrı, bir HTTP 200 kodu ve yalnızca id, offerId, contentLanguage, feedLabel ve channel ile doldurulmuş ü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ında belirli bir ürünle ilgili bilgi almak için products.get kullanın. Yeni eklenen bir ürünün bu çağrı üzerinden kullanılabilir hale gelmesi birkaç dakika sürebilir.

Almak istediğiniz ürün için aşağıdaki HTTP istek URL'sini ve parametrelerini, satıcı kimliğinizi ve ü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. online:en:US:1111111111 kimlikli bir üründen alınan örnek ürün verilerini aşağıda görebilirsiniz:

{
 "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 PATCH yöntemiyle aşağıdaki istek URL'sini kullanın. Satıcı kimliğinizi, ürün kimliğinizi ve ürün için güncellemek istediğiniz verileri içeren JSON gövdesini belirtin. Geçerli tüm alanların doldurulmasını gerektiren products.insert seçeneğinin aksine, products.update yalnızca değiştirmek istediğiniz alanları belirtmenizi gerektirir.

Not: Bir ürünün güncellenmesi products.insert ile benzerdir ve değişikliklerin işlenmesi birkaç dakikayı bulabilir. products.update hatasız bir şekilde başarılı olursa güncelleme başarılı olur. Aşağıdaki products.get çağrıları, güncelleme işlenene kadar önceki değeri döndürebilir.

Uyarı: Aynı ürün kimliğine sahip ürün birincil feed, ek feed veya API aracılığıyla yeniden gönderilirse product.update ile yapılan değişiklikler geçerli olmaz. Bir değerin yeniden gönderimden sonra da kalmasını istiyorsanız güncellenmiş değerinizin feed'e veya products.insert API çağrısı aracılığıyla eklendiğinden emin olun.

Bir özelliği eklemek veya değiştirmek için JSON gövdesindeki yeni değerle alanı belirtin. Gösterilen örnekte, mevcut bir "Siyah Google Tişörtü"nün title ve description değerleri, istek gövdesinde sağlanan ürün verileriyle güncellenerek diğer tüm alanlar değiştirilmeden bırakılır.

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

products.update için örnek istek gövde ç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ği aracılığıyla güncellenebilir. İç içe alanları güncellemek istiyorsanız üst düzey nesnenin tamamını sağlamanız gerekir.

Gösterilen örnekte, mevcut bir ürünün iç içe yerleştirilmiş alanları da dahil olmak üzere üst düzey salePrice nesnesi, istek gövdesinde sağlanan ürün verileriyle güncellenerek diğer tüm alanlar değiştirilmeden bırakılı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 belirli alanları güncellemek için bir updateMask belirtebilirsiniz. Bu sorgu dizesi parametresi, değiştirmek istediğiniz alanların virgülle ayrılmış bir listesi olmalıdır. Yalnızca adlandırılmış alanların güncelleneceğini iddia etmek istediğinizde updateMask yararlı olur. updateMask belirtmemek, yukarıdaki örnekte gösterildiği gibi güncellenecek istekteki tüm alanları işaretlemeyle eşdeğerdir.

Gösterilen örnek, yalnızca mevcut bir "Siyah Google Tişörtü"nün description ve availability öğelerini istek gövdesinde sağlanan ilgili ürün verileriyle günceller ve title dahil diğer tüm alanlara dokunulmaz.

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

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

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

updateMask listesinde sağlanan bir alan isteğin gövdesinde sağlanmazsa söz konusu alan Product kaynağından silinir (mevcutsa).

Gösterilen örnekte, salePrice alanının değerini kaldırmak için updateMask kullanılır.

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

Örnek istek gövdesi, salePrice alanını silmek için içermemelidir. Gövde veya boş gövde de sağlayamazsınız. updateMask içinde görünmedikleri sürece diğer alanlar değiştirilmeden kalır.

Uyarı: updateMask kullanırken updateMask içinde listelenen tüm alanlar için doğru değeri sağlamaya dikkat edin. Değeri isteğin gövdesine eklemezseniz bu işlem, alanı silmeye eşdeğer olur.

updateMask öğesini bir products.custombatch isteğinde kullanmak için isteğin gövdesinde updateMask belirtilmelidir.

Gösterilen örnekte, mevcut bir "Siyah Google Tişörtü"nün price ve availability değerleri, products.custombatch kullanılarak toplu girişte sağlanan ürün verileriyle güncellenerek title ve description dahil diğer tüm alanlara dokunulmayacaktı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 istek URL'si, satıcı kimliğiniz ve silmek istediğiniz ürünün ürün kimliğiyle (online:en:US:1111111111 gibi REST kimliği biçiminde) products.delete öğesini kullanın:

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

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

products.list

products.list, bir satıcının Merchant Center veritabanındaki tüm ürünleri 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ı, "resources" anahtarındaki ürünler için HTTP 200 ve 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"
   ]
  }
 ]
}