Dokumen ini memberikan panduan untuk praktik terbaik. Lihat Tips performa untuk informasi selengkapnya.
Kapan harus menggunakan API
Untuk mengirim permintaan secara terprogram
Baik Anda memilih untuk mengotomatiskan setiap bagian alur kerja, atau membuat hook ke sistem ERP (Enterprise Resource Planning), Content API memungkinkan Anda mengirim pembaruan 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
Dengan Content API, Anda dapat melakukan pembaruan inkremental pada inventaris produk yang bergerak cepat beberapa kali dalam sehari, sedangkan mengirim seluruh feed data setiap saat tidak memungkinkan. Jika update tersedia satu per satu, kirimkan satu per satu, jangan menunggu hingga ada beberapa update sehingga Anda dapat mengelompokkan update tersebut. Demikian pula, jika update tersedia dalam batch, kirim dalam batch, jangan pisahkan menjadi permintaan individual.
Untuk mengelola beberapa sub-akun
Akun Merchant Center yang baru dibuat adalah akun tunggal, yang menyimpan kumpulan data produknya sendiri. Hal ini berfungsi dengan baik dalam sebagian besar kasus, tetapi seiring berkembangnya akun, Anda mungkin mendapati bahwa Anda memerlukan sistem pengelolaan yang lebih kompleks untuk produk Anda. Jika demikian, sebaiknya gunakan akun multiklien, atau MCA. Pengelolaan akun MCA tingkat API 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 untuk seluruh feed produk Anda saat menggunakan resource products.
Sebagai gantinya, perbarui secara khusus hanya produk yang datanya benar-benar
berubah. Mengirim seluruh feed data Anda 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 konten 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 untuk 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 menyisipkan atau memperbarui produk menggunakan API secara bersamaan dengan feed, karena hasil yang tidak terduga dapat terjadi.
Beberapa contoh lain cara yang dapat diterima untuk menggunakan feed dan API secara bersamaan mencakup:
Menjalankan permintaan hanya baca (get atau list) dari API: beberapa penjual ingin menggunakan API untuk mengambil informasi dan pembaruan status pada produk mereka. Hal ini dapat diterima karena informasi produk hanya diperbarui oleh feed.
Menggunakan API untuk mengelola sub-akun (Layanan Akun) dan/atau setelan pajak dan pengiriman tingkat akun (Layanan Pajak akun dan Layanan Setelan pengiriman). Ini bukan fungsi yang dapat disediakan Feed Data, sehingga tidak ada konflik saat menggunakan API untuk mengelola fungsi ini.
Bagaimana cara bermigrasi dari menggunakan feed data menjadi hanya menggunakan API atau sebaliknya?
Jika saat ini Anda menggunakan feed data dan ingin beralih untuk hanya menggunakan API untuk memperbarui produk, Anda harus mengupload ulang data produk dengan API. Saat Anda menggunakan layanan produk untuk memperbarui produk tertentu, API akan mengontrol 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 kembali kepemilikan 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 informasi produk utama, Anda dapat menambahkan feed data baru ke akun Merchant Center dan feed tersebut akan menjadi pemilik produk yang tercantum. Jika ada produk yang ingin Anda hapus sebelum masa berlakunya berakhir dan 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, konfigurasikan 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 tercantum di bawah.
Untuk mengetahui informasi selengkapnya, lihat: Menargetkan iklan Shopping dan listingan gratis di beberapa negara.
Pastikan library klien Anda sudah yang terbaru
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 informasi selengkapnya, lihat panduan developer untuk bahasa yang Anda pilih di Contoh dan Library.
Pastikan untuk menggunakan atribut tujuan untuk mengontrol produk yang muncul di berbagai program Shopping
Content API otomatis menggunakan setelan default untuk feed Content API Anda seperti yang 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 dengan 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, tindakan ini akan menimpa 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 memilih untuk ikut serta dalam program, misalnya, Shopping, Anda dapat
menyertakan setiap item, dengan menggunakan atribut includedDestinations dan
Shopping_ads sebagai nilai, dan item akan muncul di iklan Shopping.
Untuk informasi selengkapnya tentang atribut produk includedDestinations dan
excludedDestinations, lihat
Pusat Bantuan.
Pastikan untuk memperbarui item sebelum masa berlakunya habis
Jika item tidak berubah sebelum masa berlakunya habis, 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 yang berubah atau Anda tidak dapat melacak kapan item terakhir 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
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 lokal
atau online 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 update 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 yang dihapus kecuali jika item tersebut akan berakhir masa berlakunya.
Menggunakan Feed Tambahan jika harga dan/atau ketersediaan berubah dengan cepat
Jika Anda mengalami masalah dalam memperbarui informasi harga, ketersediaan, atau promosi produk, sebaiknya gunakan Feed Tambahan di resource products untuk mengirim pembaruan hanya untuk atribut tersebut. Karena pembaruan feed tambahan
kecil, Anda dapat membuat lebih banyak pembaruan feed tambahan dalam periode
tertentu daripada pembaruan produk lengkap, yang akan membantu menjaga harga
dan ketersediaan produk Anda tetap sesuai dengan halaman landing.
Rute lain untuk memperbarui harga dan ketersediaan produk adalah menggunakan pembaruan item otomatis. Hal 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 juga memberikan informasi yang benar melalui API.
Kapan harus menggunakan token refresh
Token refresh ditampilkan di header HTTP permintaan otorisasi. Token ini berisi banyak informasi terkait autentikasi lainnya, tetapi token refresh sering kali menjadi bagian yang ingin dimiliki developer, karena tidak perlu meminta autentikasi berulang kali kepada pengguna, karena token akses hanya berlaku selama 60 menit sebelum berakhir masa berlakunya.