products
memungkinkan banyak fleksibilitas dan kontrol
lebih dari 60 atribut produk.Ada sejumlah bidang yang wajib,
dan harus disertakan agar disetujui untuk ditampilkan di Google Shopping.
Ada sejumlah kolom opsional yang dapat menjadi wajib berdasarkan berbagai
kondisi seperti lokasi, jenis produk, varian produk, dan produk
paket. Untuk rincian lebih lanjut tentang 60+ parameter opsional yang dapat
dikonfigurasikan untuk produk, lihat Data Produk
Spesifikasi.
Resource products memungkinkan Anda melakukan insert, get, update, dan delete
produk pada satu waktu, dan list semua produk di database Merchant Center.
Tujuan
productstatuses
dapat digunakan untuk memeriksa status persetujuan atau penolakan
produk untuk suatu tujuan. Lihat status produk
untuk detail lebih lanjut tentang
produk mungkin memiliki masalah kualitas data
dan apa yang mungkin menjadi masalah itu.
Dalam contoh API, kami menggunakan tiga produk: dua kaus Google dan
Cap Google. Kami menggunakan set data produk minimal yang ditunjukkan dalam tabel di bawah untuk
melakukan panggilan resource products untuk menyisipkan, mendapatkan, memperbarui, mencantumkan, dan menghapus
produk individu dan
kelompok produk.
Sebaiknya informasi Pengiriman dan Pajak dikonfigurasi di akun level, dan bukan di tingkat produk.
Untuk sub-akun multi-penjual terkait
Marketplace, semua produk harus
sertakan kolom external_seller_id. Lihat
ID produk untuk detail selengkapnya.
 |
 |
 |
|
| id | online:en:US:1111111111 | online:en:US:2222222222 | online:en:US:3333333333 |
| offerId | 1111111111 | 2222222222 | 3333333333 |
| judul | Kaus Google Hitam | Kaus Hijau Google | Topi Twill Google |
| deskripsi | Kaus Google Hitam | Kaus Google 100% katun | Topi Google klasik |
| ID kelompok item | google_tee | google_tee | |
| link | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
| kondisi | Baru | Baru | Baru |
| harga | 21,99 USD | 21,99 USD | 10,99 USD |
| ketersediaan | Tersedia | Tersedia | Tersedia |
| imageLink | https://shop.example.com/ |
https://shop.example.com/ |
https://shop.example.com/ |
| gtin | 9504000059422 | 9504000059446 | 9504000059452 |
| mpn | 00638NIC | 00638ANG | 00638ABC |
| brand | |||
| Kategori produk Google | Pakaian & Aksesori > Baju | Pakaian & Aksesori > Baju | Pakaian & Aksesori > Aksesori Pakaian > Topi |
| warna | hitam | hijau | hitam |
| ukuran | L | M | M |
| age_group | dewasa | dewasa | dewasa |
| gender | laki-laki | laki-laki | uniseks |
| included_destination | Shopping Actions, Iklan Shopping | Shopping Actions, Iklan Shopping | Shopping Actions |
products.insert
Untuk memasukkan satu produk, gunakan URL permintaan berikut, dengan menentukan
ID penjual dan contoh isi JSON. Sebuah sisipan akan membuat produk baru. Nilai if
ada untuk atribut channel, contentLanguage, offerId, dan
feedLabel untuk produk tertentu, metode ini memperbarui entri tersebut dan menggantikan
semua data dari panggilan API sebelumnya untuk produk yang diberikan.
Produk yang dikecualikan dari semua tujuan selama lebih dari 7 hari akan dihapus secara otomatis.
Contoh yang ditampilkan menyisipkan "Kaus Google Hitam" baru dengan produk yang tersedia.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Contoh panggilan isi permintaan untuk products.insert:
{
"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"
]
}
Produk juga dapat memiliki atribut khusus yang ditetapkan dalam isi JSON. Misalnya,
kita dapat menetapkan purchase_quantity_limit untuk satu produk guna membatasi
jumlah item yang dapat dipesan pelanggan:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
Perlu diperhatikan bahwa atribut khusus purchase_quantity_limit menetapkan batas pembelian
per pesanan pelanggan hingga definisi produk dan juga didukung oleh feed. Tujuan
saat ini dalam versi beta hingga didukung sepenuhnya oleh API. Apa saja
atribut khusus tambahan dapat ditambahkan oleh penjual, tetapi tidak menghasilkan
pemrosesan spesifik apa pun oleh API.
Panggilan yang berhasil akan menampilkan kode HTTP 200 dan isi respons yang berisi
resource produk yang disisipkan hanya dengan id, offerId, contentLanguage,
feedLabel, dan channel telah diisi:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online"
}
products.get
Untuk mendapatkan informasi tentang produk tertentu di database Merchant Center, gunakan
products.get. Diperlukan waktu beberapa menit agar produk yang baru dimasukkan
yang tersedia melalui panggilan ini.
Gunakan URL dan parameter permintaan HTTP berikut, ID penjual Anda, dan ID produk (format ID REST) untuk produk yang ingin Anda dapatkan:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Panggilan yang berhasil akan menampilkan HTTP 200 dan "resource produk" di
isi respons. Berikut adalah contoh data produk yang diambil dari produk dengan ID
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
Untuk memperbarui satu produk, gunakan URL permintaan berikut dengan metode PATCH,
yang menentukan ID penjual, ID produk, dan isi JSON yang berisi data
ingin memperbarui produk. Tidak seperti products.insert, yang memerlukan
semua kolom yang berlaku harus disediakan, products.update hanya mengharuskan Anda untuk
menentukan {i>field<i} yang ingin Anda ubah.
Untuk menambahkan atau mengubah atribut, tentukan kolom dengan nilai baru di JSON
{i>body <i}itu. Contoh yang ditampilkan akan memperbarui title dan description properti yang sudah ada
"Kaus Google Hitam" dengan data produk yang disediakan dalam isi permintaan, sehingga
semua isian lain
yang tidak disentuh.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Contoh panggilan isi permintaan untuk products.update:
{
"title": "Google Tee Black Limited Edition",
"description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}
Hanya kolom tingkat teratas yang dapat diperbarui melalui permintaan products.update.
Jika ingin memperbarui kolom bertingkat, Anda harus menyediakan seluruh objek tingkat teratas.
Contoh yang ditampilkan akan memperbarui objek salePrice tingkat teratas, termasuk objek bertingkat
dari produk yang sudah ada, dengan data produk disediakan di
isi permintaan, sehingga semua kolom lain tidak berubah.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Untuk memilih kolom tertentu yang akan diperbarui tanpa melakukan perubahan pada kolom lain yang disertakan
dalam isi permintaan, Anda dapat menentukan updateMask. String kueri ini
harus berupa daftar bidang yang dipisahkan koma yang akan dimodifikasi.
updateMask berguna saat Anda ingin menyatakan bahwa hanya kolom bernama
akan diperbarui. Tidak menentukan updateMask sama dengan menandai semua
dalam permintaan yang akan diperbarui seperti yang ditunjukkan pada contoh di atas.
Contoh yang ditampilkan hanya akan mengupdate description dan availability
dari "Black Google Tee" yang sudah ada dengan data produk terkait yang disediakan dalam
isi permintaan, sehingga semua kolom lain termasuk title tidak disentuh.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability
Contoh panggilan isi permintaan untuk products.update:
{
"title": "Google Tee Black",
"description": "This Limited Edition is out of print.",
"availability": "out of stock"
}
Jika kolom disediakan dalam daftar updateMask tetapi tidak ada dalam isi permintaan,
kolom tersebut akan dihapus dari resource Product, jika ada.
Contoh yang ditampilkan akan menggunakan updateMask untuk menghapus nilai kolom
salePrice.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
Isi permintaan contoh tidak boleh menyertakan kolom salePrice agar
menghapusnya. Anda juga dapat tidak memberikan isi atau bagian kosong. {i>Field<i} lain akan
tetap tidak disentuh asalkan tidak muncul di updateMask.
Untuk menggunakan updateMask dalam permintaan products.custombatch, updateMask
harus ditentukan dalam isi permintaan.
Contoh yang ditampilkan akan memperbarui price dan availability properti yang sudah ada
"Kaus Google Hitam" menggunakan products.custombatch dengan data produk yang disediakan
dalam entri batch, menyisakan semua kolom lain termasuk title dan description
tidak disentuh.
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
Untuk menghapus satu produk, gunakan products.delete dengan contoh permintaan HTTP
URL, ID penjual, dan ID produk (dalam format REST ID seperti
online:en:US:1111111111) untuk produk yang ingin Anda hapus:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Respons yang berhasil akan menampilkan HTTP Status 204 tanpa isi respons.
products.list
products.list mencantumkan semua produk yang dimiliki penjual di Merchant Center
di skrip untuk menyiapkan database. Gunakan URL permintaan berikut:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Panggilan yang berhasil akan menampilkan data HTTP 200 dan JSON untuk produk di
"sumber daya" tombol.
Tiga contoh produk berikut ditampilkan:
{
"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"
]
}
]
}