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/ |
https://shop.example.com/ |
https://shop.example.com/ |
gtin | 9504000059422 | 9504000059446 | 9504000059452 |
mpn | 00638NIC | 00638ANG | 00638ABC |
brand | |||
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.
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.
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"
]
}
]
}