Penting: Content API for Shopping akan dihentikan pada 18 Agustus 2026.

Temui Merchant API - pengganti resmi Content API for Shopping.

Dapatkan info terbaru tentang fitur, perbaikan bug, dan update Merchant API baru.

Mulai menggunakan Merchant API dan dapatkan akses ke data, insight, dan kemampuan unik dalam skala besar.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

panggilan resource produk

Resource products memungkinkan fleksibilitas dan kontrol yang besar atas lebih dari 60 atribut produk.Ada sejumlah kolom yang wajib diisi, dan harus disertakan agar disetujui untuk ditampilkan di Google Shopping. Ada sejumlah kolom opsional yang dapat menjadi wajib diisi berdasarkan berbagai kondisi seperti lokasi, jenis produk, varian produk, dan paket produk. Untuk mengetahui detail selengkapnya tentang lebih dari 60 parameter opsional yang dapat di konfigurasi untuk produk, lihat Spesifikasi Data Produk.

Resource products memungkinkan Anda insert, get, update, dan delete satu produk dalam satu waktu, serta list semua produk dalam database Merchant Center.

Resource productstatuses dapat digunakan untuk memeriksa status persetujuan atau penolakan produk tertentu untuk suatu tujuan. Lihat panduan status produk untuk mengetahui detail selengkapnya tentang produk yang mungkin mengalami masalah kualitas data dan masalah tersebut.

Dalam contoh API kami, kami menggunakan tiga produk: dua t-shirt Google dan satu topi Google. Kami menggunakan kumpulan data produk minimal yang ditampilkan dalam tabel di bawah untuk melakukan panggilan resource products guna menyisipkan, mendapatkan, memperbarui, mencantumkan, dan menghapus produk individual serta batch produk.

Sebaiknya konfigurasi informasi Pengiriman dan Pajak di tingkat akun daripada di tingkat produk.

Untuk sub-akun multi-penjual Marketplace, semua produk harus menyertakan kolom external_seller_id. Lihat ID Produk untuk mengetahui detail selengkapnya.


id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
judul	The Black Google Tee	Google Tee Green	Google Twill Cap
deskripsi	The Black Google Tee	T-shirt 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
rusak	Baru	Baru	Baru
harga	21,99 USD	21,99 USD	10,99 USD
ketersediaan	Tersedia	Tersedia	Tersedia
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin	9504000059422	9504000059446	9504000059452
mpn	00638NIC	00638ANG	00638ABC
brand	Google	Google	Google
Kategori produk Google	Pakaian & Aksesori > Pakaian	Pakaian & Aksesori > Pakaian	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 menyisipkan satu produk, gunakan URL permintaan berikut, dengan menentukan ID merchant dan isi JSON contoh. Penyisipan akan membuat produk baru. Jika nilai ada 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 tertentu.

Produk yang dikecualikan dari semua tujuan selama lebih dari 7 hari akan dihapus secara otomatis.

Contoh yang ditampilkan menyisipkan "Black Google Tee" 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 kustom 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"
 }
]

Perhatikan bahwa atribut kustom purchase_quantity_limit menetapkan batas pembelian per pesanan pelanggan ke definisi produk dan juga didukung oleh feed. Atribut ini saat ini dalam versi beta hingga didukung sepenuhnya oleh API. Atribut kustom tambahan dapat ditambahkan oleh penjual, tetapi tidak menghasilkan pemrosesan tertentu 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 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 dalam database Merchant Center, gunakan products.get. Mungkin diperlukan waktu beberapa menit agar produk yang baru disisipkan tersedia melalui panggilan ini.

Gunakan URL dan parameter permintaan HTTP berikut, ID merchant 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" 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, dengan menentukan ID merchant, 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 disediakan, products.update hanya mengharuskan Anda 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 "Black Google Tee" yang ada dengan data produk yang diberikan dalam isi permintaan, tanpa mengubah kolom lainnya.

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 atas yang dapat diperbarui melalui permintaan products.update Jika ingin memperbarui kolom bertingkat, Anda harus memberikan seluruh objek tingkat atas.

Contoh yang ditampilkan akan memperbarui objek salePrice tingkat atas, termasuk kolom bertingkat dari produk yang ada, dengan data produk yang diberikan dalam isi permintaan, tanpa mengubah kolom lainnya.

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 membuat 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 Anda ubah. updateMask berguna saat Anda ingin memastikan bahwa hanya kolom bernama yang akan diperbarui. Tidak menentukan updateMask sama dengan menandai semua kolom dalam permintaan untuk diperbarui seperti yang ditunjukkan dalam contoh di atas.

Contoh yang ditampilkan akan memperbarui hanya description dan availability dari "Black Google Tee" yang ada dengan data produk masing-masing yang diberikan dalam isi permintaan, tanpa mengubah kolom lainnya, termasuk title.

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 diberikan dalam daftar updateMask, tetapi tidak 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 dapat dihapus. Anda juga dapat tidak memberikan isi atau isi kosong. Kolom lain akan tetap tidak berubah 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 dari "Black Google Tee" yang ada menggunakan products.custombatch dengan data produk yang diberikan dalam entri batch, tanpa mengubah kolom lainnya, termasuk title dan description.

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 URL permintaan HTTP contoh, ID merchant Anda, dan ID produk (dalam format ID REST 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 HTTP 200 dan data JSON untuk produk dalam kunci "resources".

Tiga contoh produk berikut akan 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"
   ]
  }
 ]
}