Praktik terbaik

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

Kapan menggunakan API

Untuk mengirim permintaan secara terprogram

Content API memungkinkan Anda mengirim pembaruan segera setelah inventaris berubah, baik untuk mengotomatiskan setiap bagian alur kerja, maupun membuat hook ke sistem ERP (Enterprise Resource Planning).

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 akan terjadi untuk permintaan batch yang besar.

Untuk sering mengubah data produk Anda

Dengan Content API, Anda dapat melakukan pembaruan inkremental pada inventaris produk yang bergerak cepat berkali-kali dalam sehari, sedangkan mengirim seluruh feed data setiap kali tidak mungkin dilakukan. Jika update tersedia satu per satu, kirim satu per satu, jangan menunggu hingga ada beberapa update agar Anda dapat mengelompokkannya. Demikian pula, jika update tersedia dalam batch, kirim update dalam batch, jangan membaginya menjadi beberapa permintaan individual.

Untuk mengelola beberapa sub-akun

Akun Merchant Center yang baru dibuat merupakan akun tunggal, yang menyimpan kumpulan data produknya sendiri. Ini berfungsi dengan baik dalam sebagian besar kasus, tetapi seiring perkembangan akun, Anda mungkin memerlukan sistem pengelolaan yang lebih kompleks untuk produk Anda. Jika demikian, 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 gunakan API karena Anda akan menggunakan feed data

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

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

Jika Anda bertanggung jawab untuk mempertahankan 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, alat ini tidak ditujukan untuk pengambilan informasi produk secara rutin oleh klien tersebut. Anda harus memiliki sumber lain untuk informasi produk Anda, seperti database produk lokal, dan produk di Merchant Center harus mencerminkan konten sumber tersebut.

Jangan gunakan feed data dan Content API secara bersamaan 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 bersama-sama dengan aman?

Anda dapat memanipulasi feed data menggunakan Layanan Datafeed 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 dapat terjadi hasil yang tidak terduga.

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

  • Mengeksekusi permintaan hanya baca (mendapatkan atau mencantumkan) dari API: beberapa penjual ingin menggunakan API untuk mengambil informasi dan update status produk mereka. Hal ini dapat diterima karena informasi produk hanya dapat diperbarui melalui feed.

  • Menggunakan API untuk mengelola sub-akun (Accounts Service) dan/atau setelan pajak dan pengiriman tingkat akun (Accounttax Service dan Shippingsettings Service). Ini bukanlah fungsi yang dapat diberikan Datafeed, sehingga tidak ada konflik dengan penggunaan API untuk mengelola fungsi ini.

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

Jika saat ini Anda menggunakan feed data dan ingin beralih hanya menggunakan API untuk memperbarui produk, Anda harus mengupload ulang data produk dengan API tersebut. 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 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 produk tersebut akan mengambil alih kepemilikan produk yang tercantum. Jika ada produk yang ingin Anda hapus sebelum masa berlakunya habis yang 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?

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 referensi products.

Berikut adalah contoh cara mengubah setelan feed utama Content API.

Untuk informasi lebih lanjut, lihat: Menargetkan iklan Shopping dan listingan gratis di beberapa negara.

Memastikan 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 pilihan Anda dan pastikan versi library sudah yang terbaru. Untuk informasi selengkapnya, lihat panduan developer untuk bahasa pilihan Anda di Contoh dan Library.

Pastikan untuk menggunakan atribut destinasi untuk mengontrol produk mana yang akan muncul di berbagai program belanja

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 level produk dalam feed atau melalui Content API.

Jika feed API Anda telah diikutsertakan dalam suatu 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 belum diikutsertakan dalam suatu program, misalnya, Shopping, Anda dapat menyertakan item individual, dengan menggunakan atribut includedDestinations dan Shopping_ads sebagai nilai dan item akan ditampilkan di iklan Shopping.

Untuk mengetahui 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 update terakhir, atau pada tanggal habis masa berlaku yang ditentukan jika sebelumnya, update item tersebut untuk menghindari penonaktifannya. Jika Anda perlu memperbarui banyak item, karena tidak ada item yang berubah atau Anda tidak dapat melacak kapan item tersebut terakhir diperbarui, jangan memperbarui 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 yang 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 online atau feed Content API lokal secara tidak sengaja. Bergantung pada feed yang Anda hapus, produk online atau lokal yang 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 setiap permintaan individual, yang sangat penting jika Anda membuat permintaan berurutan.

Jangan mengirim beberapa update ke satu item dalam satu batch

Hal ini akan memberikan hasil yang tidak diharapkan karena ketidakpastian mengenai urutan update dan dapat menyebabkan error konflik.

Jangan mengirim update 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.

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

Jika Anda mengalami masalah dalam terus memperbarui informasi harga, ketersediaan, atau penjualan produk, pertimbangkan untuk menggunakan Feed Tambahan di referensi products guna mengirim pembaruan hanya untuk atribut tersebut. Karena pembaruan feed tambahan berukuran kecil, Anda dapat melakukan 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.

Cara lain untuk memperbarui harga dan ketersediaan produk adalah menggunakan pembaruan item otomatis. Perubahan 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 token refresh digunakan

Token refresh ditampilkan dalam header HTTP permintaan otorisasi. Token ini berisi banyak informasi terkait autentikasi lainnya, tetapi token refresh sering kali menjadi bagian yang paling diinginkan developer, karena token akses tidak perlu berulang kali meminta autentikasi pengguna, karena token akses hanya berlangsung 60 menit sebelum masa berlakunya habis.