products
bir kaynak, birden fazla kaynak üzerinde çok fazla esneklik ve kontrol sağlar.
ürün özellikleri var.
Zorunlu kılması gereken bir dizi alan vardır.
ve Google Alışveriş'te gösterilmek üzere onaylanması için dahil edilmesi gerekir.
Değişkenlik durumuna göre zorunlu hale getirilebilecek bazı isteğe bağlı alanlar vardır
Konum, ürün türü, ürün varyantları ve ürün gibi koşullar
paket. Eklenebilecek 60'tan fazla isteğe bağlı parametre hakkında
görmek istiyorsanız öncelikle Ürün Verileri
Özellikler.
products kaynağı ile insert, get, update ve delete kez katılabilirsiniz
tek seferde tüm ürünleri ve Merchant Center veritabanındaki tüm ürünleri list
İlgili içeriği oluşturmak için kullanılan
productstatuses
belirli bir öğenin onay veya ret durumunu kontrol etmek için kullanılabilir.
yardımcı olacak bir üründür. Ürün durumuna bakın
kılavuzumuza ulaşabilirsiniz.
ürünlerde veri kalitesi sorunları olabilir ve bu sorunların ne olabileceği konusunda bilgi verilir.
API örneklerimizde üç ürün kullanıyoruz: iki Google tişörtü ve
Google sınırı. Aşağıdaki tabloda gösterilen minimum ürün verisini kullanarak
eklemek, almak, güncellemek, listelemek ve silmek için products kaynak çağrısı yap
tek tek ürünler ve ürün grupları.
Kargo ve vergi bilgilerinin yapılandırılması önerilir. hesabında düzeyi yerine ürün düzeyinde ele alacağız.
Şu kitabın çok satıcılı alt hesapları için:
Ticaret siteleri: Tüm ürünlerin
external_seller_id alanını dahil edin. Görüntüleyin
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 |
| marka | |||
| Google ürün kategorisi | Giyim ve Aksesuarlar > Giysi | Giyim ve Aksesuarlar > Giysi | Giyim ve Aksesuarlar > Giyim 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ği ve örnek bir JSON gövdesi. Ekleme işlemi yeni ürünü oluşturur. Eğer değerler
channel, contentLanguage, offerId ve özellikleri için mevcut
feedLabel değerindeki bu yöntem, söz konusu girişi günceller ve ürünün yerine geçer
belirli bir ürün için önceki API çağrılarına ait tüm veriler.
7 günden uzun bir süre boyunca tüm hedeflerden hariç tutulan ürünler otomatik olarak silinir.
Gösterilen örnekte yeni bir "Siyah Google Tişörtü" takılıyor ve mevcut ürünlerle ilgilidir.
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,
amacıyla tek bir ürün için bir purchase_quantity_limit
bir müşterinin sipariş edebileceği öğe sayısı:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
purchase_quantity_limit özel özelliğinin satın alma sınırı belirlediğini unutmayın
ve feed'ler tarafından desteklenir. İlgili içeriği oluşturmak için kullanılan
özelliği, API tarafından tam olarak desteklenene kadar beta sürümündedir. Herhangi biri
ek özel özellik bir satıcı tarafından eklenebilir, ancak
tüm özel işlemler.
Başarılı bir çağrı, HTTP 200 kodu ve şunu içeren bir yanıt gövdesi döndürüyor:
yalnızca id, offerId, contentLanguage ile eklenen ürün kaynağı
feedLabel ve channel dolduruldu:
{
"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 Yeni eklenen bir ürünün
bu çağrıyla ulaşılabilecek.
Aşağıdaki HTTP istek URL'sini ve parametrelerini, satıcı kimliğinizi ve almak istediğiniz ürünün ürün kimliği (REST kimliği biçimi):
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Başarılı bir çağrı, bir HTTP 200 ve "ürün kaynağı" döndürür.
yanıt gövdesi. Aşağıda kimliği olan bir üründen alınan örnek ürün verileri verilmiştir
online:en:US:1111111111:
{
"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 belirttiğiniz verileri içeren bir JSON gövdesini
, ürün için güncelleme yapmak istiyor. products.insert işlevinin aksine,
tüm geçerli alanların sağlanması, products.update için yalnızca şunları yapmanız gerekir:
değiştirmek istediğiniz alanları belirtin.
Özellik eklemek veya değiştirmek için JSON dosyasında yeni değeri içeren alanı belirtin
gövde. Gösterilen örnekte, mevcut bir title ve description
"Siyah Google Tişörtü" istek gövdesinde sağlanan ürün verileriyle işlem yaparak
diğer tüm alanlara dokunulmaz.
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 örnek, iç içe yerleştirilmiş boyut da dahil olmak üzere üst düzey salePrice nesnesini günceller.
ürün verileriyle birlikte, mevcut bir ürünün
istek gövdesine dokunulduğundan emin olun.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Belirli alanları, eklenen diğer alanlarda değişiklik yapmadan güncellemek için seçmek
, isteğin gövdesinde bir 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 geçerli olduğunu doğrulamak istediğinizde kullanışlıdır.
güncellenecektir. Bir updateMask belirtmemek, tümünü işaretlemekle eşdeğerdir
alanları yukarıdaki örnekte gösterildiği gibi güncellenir.
Gösterilen örnek yalnızca description ve availability öğelerini günceller
mevcut bir "Siyah Google Tişörtü" bu belgede sağlanan ilgili ürün verileriyle
istek gövdesinde, title dahil diğer tüm alanlar değiştirilmeden bırakılır.
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 bir alan sağlanmış ancak isteğin gövdesinde sağlanmamışsa
bu alan, varsa Product kaynağından silinecek.
Gösterilen örnekte, alanın değerini kaldırmak için updateMask kullanılır
salePrice.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
Örnek istek gövdesinde, aşağıdaki işlemi yapmak için salePrice alanını içermemelidir:
silebilirsiniz. Gövde veya boş gövde de sağlayamazsınız. Diğer alanlarda
updateMask içinde görünmedikleri sürece değişmeden kalırlar.
updateMask öğesini bir products.custombatch isteğinde kullanmak için updateMask
isteğin gövdesinde belirtilmelidir.
Gösterilen örnekte, mevcut bir price ve availability
"Siyah Google Tişörtü" sağlanan ürün verileriyle products.custombatch kullanılıyor
toplu girişinde, title ve description dahil diğer tüm alanlar bırakıldı
değiştirmiyor.
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ğiyle products.delete kullanın
URL, satıcı kimliğiniz ve ürün kimliğiniz (REST kimliği biçiminde:
online:en:US:1111111111) kaldırı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'daki 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ı şuradaki ürünler için bir HTTP 200 ve JSON verileri döndürür:
"kaynaklar" tuşuna basın.
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"
]
}
]
}