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.

Praktik terbaik

Dokumen ini memberikan panduan untuk praktik terbaik. Lihat Tips performa untuk mengetahui informasi selengkapnya.

Kapan harus menggunakan API

Untuk mengirim permintaan secara terprogram

Baik Anda memilih untuk mengotomatiskan setiap bagian alur kerja, atau membuat hook ke dalam sistem ERP (Enterprise Resource Planning), Content API memungkinkan Anda mengirimkan update segera setelah inventaris berubah.

Untuk menerima masukan langsung

Di Content API, Anda akan langsung mendapatkan respons untuk setiap permintaan, bukan melalui ringkasan email setelah feed data diproses. Latensi lima hingga sepuluh detik diperkirakan untuk permintaan batch besar.

Untuk sering mengubah data produk Anda

Dengan Content API, Anda dapat melakukan pembaruan inkremental pada inventaris produk yang cepat laku berkali-kali dalam sehari, sedangkan pengiriman seluruh feed data setiap kali tidak memungkinkan. Jika update tersedia satu per satu, kirimkan satu per satu, jangan menunggu hingga ada beberapa update sehingga Anda dapat mengirimkannya secara berkelompok. Demikian pula, jika update tersedia dalam batch, kirimkan dalam batch, jangan memecahnya menjadi permintaan individual.

Untuk mengelola beberapa sub-akun

Akun Merchant Center yang baru dibuat adalah akun tunggal, yang menyimpan set data produknya sendiri. Cara ini berfungsi dengan baik dalam sebagian besar kasus, tetapi seiring dengan pertumbuhan akun Anda, Anda mungkin mendapati bahwa Anda memerlukan sistem pengelolaan yang lebih kompleks untuk produk Anda. Jika demikian, pertimbangkan untuk menggunakan akun multiklien (MCA). Pengelolaan tingkat API akun MCA dapat dilakukan melalui layanan Akun, dan memungkinkan penambahan dan pengelolaan sub-akun secara terprogram. Informasi selengkapnya tentang cara mendapatkan akun MCA dapat ditemukan di sini.

Cara menggunakan API

Jangan gunakan API seperti Anda menggunakan feed data

Hindari pembaruan harian seluruh feed produk saat menggunakan resource products. Sebagai gantinya, perbarui secara khusus hanya produk yang datanya benar-benar berubah. Mengirimkan seluruh feed data melalui resource products akan menghabiskan lebih banyak waktu dan resource bagi Google dan Anda.

Jangan gunakan API untuk mengambil informasi produk yang telah Anda upload secara rutin

Jika Anda bertanggung jawab untuk mengelola informasi produk di akun Merchant Center tertentu, hindari meminta informasi produk dari Content API melalui metode products.get atau products.list secara rutin. Untuk klien yang mengupload informasi, metode ini dapat membantu Anda men-debug masalah saat mendesain solusi yang menggunakan Content API. Namun, API ini tidak dimaksudkan untuk pengambilan informasi produk secara rutin oleh klien tersebut. Anda harus memiliki sumber lain untuk informasi produk, seperti database produk lokal, dan produk di Merchant Center harus mencerminkan isi sumber tersebut.

Jangan gunakan feed data dan Content API untuk mengirimkan item produk

Jika Anda mempertimbangkan untuk beralih ke API untuk pengiriman item, pastikan Anda tidak lagi menggunakan feed data untuk mengirimkan item produk. Jika Anda terus mengirimkan item di kedua media, hasil yang tidak terduga dapat terjadi.

Apakah ada cara agar saya dapat menggunakan API dan feed data secara bersamaan dengan aman?

Anda dapat memanipulasi feed data menggunakan Layanan Feed Data API. Meskipun hal ini akan mempermudah pengelolaan feed data dalam skala besar, perlu diingat bahwa Anda tidak boleh memasukkan atau memperbarui produk menggunakan API secara bersamaan dengan feed, karena dapat menyebabkan hasil yang tidak terduga.

Beberapa contoh lain cara yang dapat diterima untuk menggunakan feed dan API secara bersamaan meliputi:

Mengeksekusi permintaan hanya baca (get atau list) dari API: beberapa penjual ingin menggunakan API untuk mengambil informasi dan update status tentang produk mereka. Hal ini dapat diterima karena informasi produk hanya diperbarui oleh feed.
Menggunakan API untuk mengelola sub-akun (Accounts Service) dan/atau setelan pajak dan pengiriman tingkat akun (Accounttax Service dan Shippingsettings Service). Ini bukan fungsi yang dapat disediakan oleh Feed Data, sehingga tidak ada konflik dengan penggunaan API untuk mengelola fungsi ini.

Bagaimana cara bermigrasi dari penggunaan feed data ke hanya menggunakan API atau sebaliknya?

Jika saat ini Anda menggunakan feed data dan ingin beralih ke hanya menggunakan API untuk memperbarui produk, Anda harus mengupload ulang data produk dengan API. Saat Anda menggunakan products service untuk memperbarui produk tertentu, API akan mengambil alih informasi produk, dan menghapus produk dari feed data atau menghapus feed data itu sendiri tidak akan lagi menghapus informasi produk dari akun Merchant Center Anda. Pastikan tidak ada pembaruan feed data jika Anda ingin menghapus produk dari feed data atau feed data itu sendiri. Jika tidak, feed data akan mengambil kepemilikan lagi dan menghapus produk dari feed data akan menyebabkan produk tersebut dihapus.

Jika saat ini Anda hanya menggunakan API untuk informasi produk dan ingin menggunakan feed data sebagai sumber utama informasi produk, Anda cukup menambahkan feed data baru ke akun Merchant Center dan feed tersebut akan mengambil kepemilikan produk yang tercantum. Jika ada produk yang ingin Anda hapus sebelum masa berlakunya berakhir dan produk tersebut diupload hanya dari API, Anda harus menghapusnya melalui Merchant Center atau melalui API.

Bagaimana cara menargetkan beberapa negara dengan produk menggunakan Content API for Shopping?

Untuk menargetkan beberapa negara dengan iklan dan listingan gratis untuk produk yang dikirimkan melalui Content API, konfigurasi negara tambahan di feed utama Content API di Merchant Center atau tambahkan negara tambahan tersebut melalui kolom shipping di resource products.

Contoh cara mengubah setelan feed utama Content API ada di bawah.

Untuk mengetahui informasi selengkapnya, lihat: Menargetkan iklan Shopping dan listingan gratis di beberapa negara.

Pastikan library klien Anda sudah diupdate

Jika Anda menggunakan library klien Google untuk berinteraksi dengan Content API, pastikan untuk menggunakan pengelola paket untuk bahasa pemrograman yang Anda pilih dan pastikan versi library sudah yang terbaru. Untuk mengetahui informasi selengkapnya, lihat panduan developer untuk bahasa yang Anda pilih di Contoh dan Library.

Pastikan untuk menggunakan atribut tujuan untuk mengontrol produk mana yang muncul di berbagai program Shopping

Content API secara otomatis menerapkan setelan default untuk feed Content API sebagaimana dikonfigurasi di Merchant Center. Anda dapat menggunakan atribut produk includedDestinations atau excludedDestinations untuk mengontrol partisipasi program di tingkat produk dalam feed atau melalui Content API.

Jika feed API Anda telah diikutsertakan dalam program, misalnya, Beli di Google (sebelumnya dikenal sebagai Shopping Actions), tetapi Anda ingin mengecualikan produk tertentu, gunakan atribut excludedDestinations dan tentukan Shopping Actions sebagai nilai. Jika tidak ada error, setelan ini akan menggantikan setelan feed default di Merchant Center dan item tertentu tersebut tidak akan muncul di Beli dengan Google (sebelumnya dikenal sebagai Shopping Actions). Sebaliknya, jika feed Anda belum diikutsertakan dalam program, misalnya, Shopping, Anda dapat menyertakan item satu per satu, dengan menggunakan atribut includedDestinations dan Shopping_ads sebagai nilai, dan item akan muncul di iklan Shopping.

Untuk mengetahui informasi selengkapnya tentang atribut produk includedDestinations dan excludedDestinations, lihat Pusat Bantuan.

Pastikan untuk memperbarui item sebelum masa berlakunya berakhir

Jika item tidak berubah sebelum habis masa berlakunya, 30 hari setelah pembaruan terakhir atau pada tanggal habis masa berlaku yang ditentukan jika lebih awal, perbarui item untuk menghindari penonaktifannya. Jika Anda perlu memperbarui banyak item, karena tidak ada item yang berubah atau Anda tidak dapat melacak kapan terakhir kali item tersebut diperbarui, jangan perbarui semua item secara bersamaan, tetapi sebarkan beban secara merata selama beberapa hari.

Jangan hapus feed Content API atau produk Anda dapat hilang

Saat pertama kali Anda mengupload produk dengan channel:online melalui Content API, feed baru akan muncul di Merchant Center dengan judul Content API. Saat pertama kali Anda mengupload produk dengan channel:local melalui Content API, feed baru akan muncul di Merchant Center dengan judul Content API dan subjudul Produk Lokal. Pastikan Anda tidak menghapus feed Content API online atau lokal secara tidak sengaja. Bergantung pada feed yang Anda hapus, produk online atau lokal yang telah Anda tambahkan ke Merchant Center melalui Content API akan dihapus.

Mengelompokkan beberapa permintaan ke layanan yang sama menggunakan metode custombatch

Daripada membuat banyak permintaan berurutan atau paralel ke layanan yang sama, buat satu permintaan custombatch yang berisi semua permintaan yang diinginkan. Dengan cara ini, latensi untuk membuat permintaan ke endpoint API hanya terjadi sekali untuk panggilan custombatch, bukan pada setiap permintaan individual, yang sangat penting jika Anda membuat permintaan berurutan.

Jangan mengirim beberapa pembaruan ke satu item dalam satu batch

Hal ini akan memberikan hasil yang tidak terduga karena ketidakpastian urutan pembaruan dan dapat menyebabkan error konflik.

Jangan kirim pembaruan untuk item yang tidak berubah

Pastikan Anda hanya mengirim permintaan untuk item produk baru, yang diubah, atau dihapus kecuali jika item akan habis masa berlakunya.

Gunakan Feed Tambahan jika harga dan/atau ketersediaan berubah dengan cepat

Jika Anda mengalami masalah dalam menjaga harga, ketersediaan, atau informasi penjualan produk tetap terbaru, pertimbangkan untuk menggunakan Feed Tambahan di resource products untuk mengirimkan pembaruan hanya untuk atribut tersebut. Karena pembaruan feed tambahan berukuran kecil, Anda dapat melakukan lebih banyak pembaruan feed tambahan dalam jangka waktu tertentu dibandingkan pembaruan produk lengkap, yang akan membantu menjaga harga dan ketersediaan produk Anda sesuai dengan halaman landing Anda.

Cara lain untuk memperbarui harga dan ketersediaan produk adalah dengan menggunakan pembaruan item otomatis. Fitur ini dapat digunakan selain pembaruan API untuk membantu menghindari ketidakcocokan antara informasi di Merchant Center dan informasi di halaman landing produk. Namun, perlu diingat bahwa fitur ini dirancang untuk memperbaiki masalah kecil terkait akurasi harga dan ketersediaan produk, sehingga pembaruan item otomatis bukanlah pengganti untuk memberikan informasi yang benar melalui API.

Kapan harus menggunakan token refresh

Token refresh ditampilkan di header HTTP permintaan otorisasi. Respons ini berisi banyak informasi terkait autentikasi lainnya, tetapi token refresh sering kali merupakan bagian yang ingin didapatkan oleh developer, karena token ini menghilangkan kebutuhan untuk meminta autentikasi pengguna berulang kali, karena token akses hanya bertahan selama 60 menit sebelum berakhir.