Dokumen ini memberikan pedoman untuk praktik terbaik. Lihat Tips performa untuk mengetahui informasi selengkapnya.
Kapan harus menggunakan API
Untuk mengirim permintaan secara terprogram
Baik Anda lebih memilih untuk mengotomatiskan setiap bagian alur kerja Anda, maupun membuat hook ke dalam sistem ERP (Enterprise Resource Planning), Content API memungkinkan Anda mengirim update segera setelah inventaris Anda berubah.
Untuk menerima masukan langsung
Di Content API, Anda akan langsung mendapatkan respons atas setiap permintaan, bukan melalui email evaluasi 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 bertahap pada inventaris produk yang bergerak cepat berkali-kali dalam sehari, sedangkan mengirimkan seluruh feed data Anda setiap saat tidak memungkinkan. Jika update tersedia satu per satu, kirim satu per satu, jangan tunggu hingga ada beberapa update sehingga Anda dapat memadukannya. Demikian pula, jika update tersedia dalam beberapa batch, kirim dalam batch, jangan dibagi menjadi beberapa permintaan.
Untuk mengelola beberapa sub-akun
Akun Merchant Center yang baru dibuat adalah akun tunggal yang menyimpan kumpulan data produknya sendiri. Cara ini berfungsi dengan baik di sebagian besar kasus, tetapi seiring dengan berkembangnya akun Anda, Anda mungkin memerlukan sistem pengelolaan yang lebih kompleks untuk produk Anda. Jika ini terjadi pada Anda, pertimbangkan untuk menggunakan akun multiklien, atau MCA. Pengelolaan level API untuk 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 menggunakan 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 untuk 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 berkala. Untuk klien yang mengupload informasi, metode
ini dapat membantu Anda men-debug masalah saat mendesain solusi yang
menggunakan Content API. Namun, alat ini tidak dimaksudkan untuk pengambilan rutin
informasi produk 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 menggunakan feed data lagi untuk mengirimkan item produk. Jika Anda terus mengirimkan item di kedua media tersebut, hasil yang tidak diharapkan dapat terjadi.
Adakah cara agar saya dapat menggunakan API dan feed data secara bersamaan dengan aman?
Anda dapat memanipulasi feed data menggunakan Layanan Datafeed API. Meskipun cara ini akan mempermudah pengelolaan feed data dalam skala besar, perlu diingat bahwa Anda tidak boleh menyisipkan atau memperbarui produk menggunakan API bersamaan dengan feed, karena dapat terjadi hasil yang tidak terduga.
Beberapa contoh lain tentang cara yang dapat diterima untuk menggunakan feed dan API secara bersama-sama mencakup:
Mengeksekusi permintaan hanya baca (dapatkan atau cantumkan) dari API: beberapa penjual ingin menggunakan API untuk mengambil informasi dan update 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 Accounttax dan Layanan setelan pengiriman). Ini bukanlah fungsi yang dapat disediakan Datafeed, sehingga tidak ada konflik penggunaan 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 agar hanya menggunakan API untuk memperbarui produk, Anda harus mengupload ulang data produk dengan API. Saat Anda menggunakan layanan produk untuk memperbarui produk tertentu, API 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 utama informasi produk, Anda cukup menambahkan feed data baru ke akun Merchant Center dan mereka akan mengambil alih kepemilikan produk yang tercantum. Jika ada produk yang ingin Anda hapus sebelum habis masa berlakunya dan hanya diupload dari API, Anda harus menghapusnya melalui Merchant Center atau melalui API.
Bagaimana cara menargetkan beberapa negara dengan produk yang menggunakan Content API for Shopping?
Guna menargetkan beberapa negara dengan iklan dan listingan gratis untuk produk yang dikirimkan
melalui Content API, konfigurasikan negara tambahan pada feed utama Content API
di Merchant Center atau tambahkan negara tambahan tersebut melalui kolom shipping
di resource products.
Berikut adalah contoh cara memodifikasi setelan feed utama Content API.
Untuk mengetahui informasi selengkapnya, lihat: Menargetkan iklan Shopping dan listingan gratis di beberapa negara.
Memastikan bahwa library klien Anda sudah yang terbaru
Jika Anda menggunakan library klien Google untuk berinteraksi dengan Content API, pastikan Anda 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 pilihan Anda di Contoh dan Library.
Pastikan untuk menggunakan atribut tujuan untuk mengontrol produk mana yang muncul di program belanja yang berbeda
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 pada 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
nilainya. Asalkan 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 tidak diikutsertakan dalam program, misalnya, Shopping, Anda dapat
menyertakan item individual, dengan menggunakan atribut includedDestinations dan
Shopping_ads sebagai nilai dan item tersebut akan muncul di iklan Shopping.
Untuk informasi selengkapnya tentang atribut produk includedDestinations dan
excludedDestinations, lihat
Pusat Bantuan.
Pastikan untuk memperbarui item sebelum kedaluwarsa
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 tersebut 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 sekaligus, 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 berjudul Content API. Saat pertama
kali mengupload produk dengan channel:local melalui Content API, feed
baru akan muncul di Merchant Center berjudul Content API dengan 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
produk 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 demikian, latensi untuk membuat permintaan ke endpoint API hanya terjadi satu kali untuk panggilan custombatch, bukan pada setiap permintaan individual, yang sangat penting jika Anda membuat permintaan berurutan.
Jangan kirim beberapa pembaruan ke satu item dalam satu batch
Hal ini akan memberikan hasil yang tidak diharapkan karena ketidakpastian urutan update dan dapat menyebabkan error konflik.
Jangan kirim pembaruan untuk item yang tidak diubah
Pastikan Anda hanya mengirim permintaan untuk item produk baru, yang diubah, atau dihapus kecuali jika item tersebut akan habis masa berlakunya.
Menggunakan Feed Tambahan jika harga dan/atau ketersediaan berubah dengan cepat
Jika Anda mengalami masalah saat terus memperbarui informasi harga, ketersediaan, atau promo produk, sebaiknya gunakan Feed Tambahan dalam resource products untuk mengirim pembaruan hanya untuk atribut tersebut. Karena pembaruan feed tambahan berukuran kecil, Anda dapat melakukan lebih banyak pembaruan feed tambahan dalam periode tertentu dibandingkan pembaruan produk lengkap. Hal ini akan membantu menjaga harga dan ketersediaan produk tetap sesuai dengan halaman landing Anda.
Cara lain untuk memperbarui harga dan ketersediaan produk adalah menggunakan pembaruan item otomatis. Hal ini dapat digunakan selain update API untuk membantu menghindari ketidakcocokan antara informasi di Merchant Center dan informasi di halaman landing produk. Namun, perlu diingat bahwa hal 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. Token ini berisi banyak informasi terkait autentikasi lainnya, tetapi token refresh sering kali menjadi bagian yang perlu didapatkan oleh developer secara langsung karena tidak perlu berulang kali meminta autentikasi pengguna, karena token akses hanya berlaku selama 60 menit sebelum habis masa berlakunya.