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 eklenmesi gereken ve zorunlu olan birçok alan vardır.
Konum, ürün türü, ürün varyantları ve ürün paketleri gibi çeşitli koşullara göre zorunlu hale getirilebilecek bazı isteğe bağlı alanlar vardır. Ürünler için yapılandırılabilen 60'tan fazla isteğe bağlı parametre hakkında daha fazla ayrıntı için Ürün Verileri Spesifikasyonları bölümüne bakın.
products kaynağı, aynı anda tek bir ürünü insert, get, update ve delete ile Merchant Center veritabanındaki tüm ürünleri list ayarlamanıza olanak tanır.
productstatuses kaynağı, bir hedef için belirli bir ürünün onay veya ret durumunu kontrol etmek amacıyla kullanılabilir. Hangi ürünlerde veri kalitesi sorunlarının olabileceği ve bu sorunların neler olabileceği hakkında daha fazla bilgi için ürün durumu rehberini inceleyin.
API örneklerimizde üç ürün kullanırız: iki Google tişörtü ve bir Google sınırı. Bağımsız ü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ırız.
Kargo ve Vergi bilgilerinin ürün düzeyinde değil, hesap düzeyinde yapılandırılmasını öneririz.
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 |
| başlık | 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 başlığı |
| öğ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 |
| price (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 Eşyaları | Giyim ve Aksesuar > Giyim Eşyaları | Giyim ve Aksesuar > Kıyafet Aksesuarları > Şapkalar |
| renk | siyah | green | siyah |
| boy | 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. Ek, 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 ilgili ürün için önceki API çağrılarındaki 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övdesi:
{
"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, JSON gövdesinde ayarlanmış özel özelliklere de sahip olabilir. Örneğin, müşterinin sipariş edebileceği öğe sayısını sınırlamak için 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ı 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 şu anda beta sürümündedir. Herhangi bir ek özel özellik satıcı tarafından eklenebilir ancak API'ler tarafından belirli bir işlem yapılmasıyla sonuçlanmaz.
Başarılı bir çağrı, bir HTTP 200 kodu ve yalnızca id, offerId, contentLanguage, feedLabel ve channel doldurulmuş olarak 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 almak için products.get işlevini kullanın. Yeni eklenen bir ürünün bu çağrıda 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 verileri:
{
"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övdesini belirtin. Geçerli tüm alanların sağlanması gereken products.insert'den 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ğeri içeren alanı belirtin. Gösterilen örnek, mevcut bir "Siyah Google Tişört"ün title ve description değerlerini istek gövdesinde sağlanan ürün verileriyle güncelleyerek diğer hiçbir alanı olduğu gibi bırakmıyor.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
products.update için örnek istek gövdesi:
{
"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 yerleştirilmiş alanları güncellemek istiyorsanız üst düzey nesnenin tamamını sağlamanız gerekir.
Gösterilen örnek, mevcut bir ürünün iç içe geçmiş alanları da dahil olmak üzere üst düzey salePrice nesnesini istek gövdesinde sağlanan ürün verileriyle güncelleyerek diğer hiçbir alanı olduğu gibi bırakacak.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
İsteğin gövdesindeki 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ış listesi olmalıdır.
updateMask, yalnızca adlandırılmış alanların güncelleneceğini iddia etmek istediğinizde yararlı olur. Bir updateMask belirtilmemesi, yukarıdaki örnekte gösterildiği gibi, güncelleme isteğindeki tüm alanları güncellemeye eşdeğerdir.
Gösterilen örnek, mevcut bir "Siyah Google Tişörtü"nün yalnızca description ve availability öğelerini istek gövdesinde sağlanan ilgili ürün verileriyle günceller ve title dahil diğer hiçbir alana dokunulmaz.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability
products.update için örnek istek gövdesi:
{
"title": "Google Tee Black",
"description": "This Limited Edition is out of print.",
"availability": "out of stock"
}
updateMask listesinde sağlanmış ancak isteğin gövdesinde olmayan bir alan varsa bu alan (mevcutsa) Product kaynağından silinir.
Gösterilen örnekte salePrice alanındaki değeri kaldırmak için updateMask kullanılacaktır.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
Örnek istek gövdesi, silinebilmesi için salePrice alanını içermemelidir. Ayrıca, gövde veya boş gövde de ekleyemezsiniz. updateMask içinde görünmedikleri sürece diğer alanlar değiştirilmez.
Bir products.custombatch isteği içinde updateMask kullanmak için updateMask, isteğin gövde kısmında belirtilmelidir.
Gösterilen örnek, mevcut "Siyah Google Tişört"ün price ve availability değerlerini toplu girişte sağlanan ürün verileriyle products.custombatch kullanarak günceller ve title ve description dahil diğer hiçbir alana dokunulmaz.
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üne ilişkin ürün kimliğiyle (online:en:US:1111111111 gibi REST kimliği biçiminde) 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 olmayan bir HTTP Status 204 döndürür.
products.list
products.list, bir satıcının Merchant Center veritabanında sahip olduğu 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ı, "kaynaklar" anahtarındaki ürünler için bir 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"
]
}
]
}