Resource products
memungkinkan banyak fleksibilitas dan kontrol atas lebih
dari 60 atribut produk.Ada sejumlah kolom yang wajib ada,
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 paket produk. Untuk mengetahui detail selengkapnya tentang 60+ parameter opsional yang dapat dikonfigurasi untuk produk, lihat Spesifikasi Data Produk.
Resource products
memungkinkan Anda melakukan insert
, get
, update
, dan delete
produk dalam satu waktu, serta list
semua produk di database Merchant Center.
Resource
productstatuses
dapat digunakan untuk memeriksa status persetujuan atau penolakan produk
tertentu untuk tujuan. Lihat panduan status
produk untuk mengetahui detail selengkapnya tentang
produk yang mungkin mengalami masalah kualitas data dan kemungkinan masalah tersebut.
Dalam contoh API, kami menggunakan tiga produk: dua kaus Google dan satu kaus Google. Kami menggunakan sekumpulan data produk minimal yang ditampilkan pada tabel di bawah untuk melakukan panggilan resource products
guna menyisipkan, memperoleh, memperbarui, mencantumkan, dan menghapus setiap produk dan batch produk.
Sebaiknya informasi Pengiriman dan Pajak dikonfigurasi di tingkat akun, bukan di tingkat produk.
Untuk sub-akun multi-penjual di Marketplace, semua produk harus
menyertakan 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 |
title | 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 | |
tautkan | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
kondisi | Baru | Baru | Baru |
price | 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 Baju > Topi |
warna | hitam | green | hitam |
ukuran | L | S | S |
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. Jika ada nilai untuk atribut channel
, contentLanguage
, offerId
, dan feedLabel
untuk produk tertentu, metode ini akan memperbarui entri tersebut dan mengganti semua data dari panggilan API sebelumnya untuk produk yang ditentukan.
Produk yang dikecualikan dari semua tujuan selama lebih dari 7 hari akan otomatis dihapus.
Contoh yang ditampilkan menyisipkan "Kaus Google Hitam" baru ke 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 oleh pelanggan:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
Perhatikan bahwa atribut khusus purchase_quantity_limit
menetapkan batas pembelian
per pesanan pelanggan ke definisi produk dan juga didukung oleh feed. Atribut tersebut saat ini masih dalam versi beta hingga didukung sepenuhnya oleh API. Atribut khusus tambahan apa pun dapat ditambahkan oleh penjual, tetapi tidak menghasilkan pemrosesan khusus oleh API.
Panggilan yang berhasil akan menampilkan kode HTTP 200
dan isi respons yang berisi
resource produk yang disisipkan dengan hanya id
, offerId
, contentLanguage
,
feedLabel
, dan channel
yang terisi:
{
"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
tersedia melalui panggilan ini.
Gunakan URL dan parameter permintaan HTTP berikut, ID penjual, dan ID produk (format REST ID) 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" dalam
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 yang
ingin Anda perbarui untuk produk tersebut. Tidak seperti products.insert
, yang mengharuskan semua kolom yang berlaku untuk diberikan, products.update
hanya mengharuskan Anda untuk menentukan kolom yang ingin diubah.
Untuk menambahkan atau mengubah atribut, tentukan kolom dengan nilai baru dalam isi
JSON. Contoh yang ditampilkan akan memperbarui title
dan description
dari
"Kaus Google Hitam" yang sudah ada dengan data produk yang diberikan dalam isi permintaan, sehingga
semua kolom lain tidak tersentuh.
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 kolom bertingkat dari produk yang sudah ada, dengan data produk yang disediakan dalam isi permintaan, sehingga semua kolom lain tidak tersentuh.
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
. Parameter string kueri ini harus berupa daftar kolom yang dipisahkan koma yang ingin diubah.
updateMask
berguna saat Anda ingin menegaskan bahwa hanya kolom bernama yang akan diperbarui. Tidak menentukan updateMask
sama dengan menandai semua kolom dalam permintaan yang akan diperbarui seperti yang ditunjukkan dalam contoh di atas.
Contoh yang ditampilkan hanya akan memperbarui description
dan availability
"Kaus Google Hitam" yang sudah ada dengan data produk masing-masing yang diberikan
dalam isi permintaan, sehingga semua kolom lainnya 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 ditunjukkan 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 dapat
menghapusnya. Anda juga dapat tidak memberikan isi atau bagian kosong. Kolom lain tidak akan
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
"Kaus Google Hitam" yang sudah ada menggunakan products.custombatch
dengan data produk yang diberikan
dalam entri batch, sehingga semua kolom lainnya 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 URL permintaan HTTP, 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 dalam database Merchant Center. 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
kunci "resource".
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"
]
}
]
}