API

---

Autentikasi

Agar dapat menggunakan Merchant API for Shopping dengan akun Merchant Center tertentu, harus menyiapkan project Konsol API. Bantuan project Konsol Google Cloud Anda mengelola akses dan autentikasi API untuk solusi Merchant API Anda.

Bergantung pada kasus penggunaannya, ada dua cara untuk mengakses Merchant API:

• OAuth 2.0 direkomendasikan untuk mendapatkan akses ke Merchant Center tertentu pengguna melalui aplikasi yang Anda kembangkan untuk pengguna Anda. Pengguna akan perlu memberikan akses ke akun Anda untuk mengirimkan data atas nama mereka.
• Akun layanan adalah jenis akun khusus, yang biasanya digunakan oleh aplikasi, bukan manusia. Akun layanan diidentifikasi berdasarkan emailnya yang unik untuk akun tersebut.

Lihat cara melakukan autentikasi menggunakan OAuth 2.0 atau layanan menggunakan akun layanan.

Tips: Saat mengirimkan data sebagai Penyedia Kemitraan Feed Lokal, layanan tersebut email akun harus ditambahkan ke daftar pengguna akun MCA karena panggilan diautentikasi melalui akun tersebut untuk semua sub-akun MCA.

Aktifkan setelan negara

Penting: Sebelum mengirimkan penawaran data yang Anda butuhkan untuk mengaktifkan program ini.

Panggil liasettings.update untuk menentukan negara tempat Anda berencana untuk melayani pelanggan lokal.

Informasi selengkapnya di halaman Target Setelan Negara

Kirim data penawaran

Ada dua jenis data: data produk dan inventaris.

Mengirim data produk dan inventaris sekaligus

Data produk dan inventaris dapat dikirimkan sekaligus menggunakan accounts.lfpInventories.insert

Kolom "GTIN" akan berfungsi sebagai kode produk untuk katalog Google dan feed produk akan otomatis dibuat.

Feed yang dibuat secara otomatis ini akan ditampilkan di Merchant Center target sebagai "Penyedia Feed Lokal" dengan penawaran relevan yang terkait.

Metode ini berfungsi dengan baik jika semua produk penjual memiliki GTIN dan tidak ada fitur tersebut akan diaktifkan (seperti Halaman Retailer yang Dihosting Penjual versi dasar). Jika Anda berencana mengaktifkan MHLSF untuk penjual Anda, kirimkan feed produk khusus adalah pengaturan yang disarankan.

Prosedur yang sama dapat digunakan menggunakan accounts.lfpSales.insert

Dalam hal ini, data mengacu pada peristiwa Penjualan untuk produk tertentu dengan waktu tertentu.

Mengirim data produk dan inventaris secara terpisah

Jika GTIN tidak tersedia secara luas atau Anda lebih baik memanfaatkan feed produk yang ada di akun Merchant Center Target atau Anda ingin mengaktifkan MHLSF untuk penjual, Anda harus memiliki Feed Produk Lokal spesifik.

Ini dapat diaktifkan dengan memanggil accounts.productInputs.insert terlebih dahulu dan memasukkan semua nilai statis suatu produk. Ingatlah untuk menyetel Channel ke "lokal".

Pelajari lebih lanjut data produk dasar dalam artikel ini dan API panduan umum untuk memasukkan produk.

Aliran datanya adalah sebagai berikut:

• Panggil accounts.productInputs.insert terlebih dahulu untuk mulai mengupload produk untuk penjual Anda
• Lalu, Hubungi accounts.lfpInventories.insert untuk mengirimkan inventaris layanan otomatis dan data skalabel.

Atau, data inventaris dapat dikirim melalui accounts.lfpSales.insert. Model {i>machine learning<i} kemudian akan memprediksi harga dan kuantitas penawaran berdasarkan data ini.

Contoh ringkasan untuk accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

Penting: offerId yang dikirim di accounts.productInputs.insert harus cocok dengan offerId di accounts.lfpInventories.insert sehingga penawaran dipetakan dengan benar.

Penting: accounts.lfpInventories.insert memiliki induk di URL. Ini adalah akun penyedia LFP Anda yang diaktifkan oleh Tim Dukungan. Akun Merchant Center retailer Anda ada dalam payload permintaan sebagai TargetMerchant. Ini adalah ID Merchant Center penjual yang akan mengirimkan inventarisnya.

Poin Penting: Data produk habis masa berlakunya dalam 30 hari dan data inventaris tidak berlaku lagi dalam waktu 14 hari hari. Hal ini efektif dalam menghilangkan produk yang tidak diinginkan. Produk dan inventaris data dapat dikirim sekaligus menggunakan accounts.lfpInventories.insert jika GTIN diketahui untuk semua penawaran. Atau, Anda dapat menggunakan accounts.productInputs.insert untuk data produk dan accounts.lfpInventories.insert (atau accounts.lfpSales.insert) untuk data inventaris

Mengirim data Profil Bisnis

Jika akun Google Profil Bisnis milik Penjual tidak dapat diakses untuk mengambil kode toko, data Toko dapat dikirim melalui accounts.lfpStores.insert dengan kode toko khusus Anda sendiri.

Perhatikan bahwa saat memanggil accounts.lfpinventories.insert atau accounts.lfpSales.insert Kode toko harus cocok dengan Kode toko yang disediakan dalam permintaan Toko lfp.

Penting: Jika toko yang cocok tidak dapat ditemukan, inventaris atau penjualan yang dikirimkan dengan kode toko tidak akan digunakan. Untuk tingkat keberhasilan yang lebih tinggi, informasi yang diberikan harus sama persis dengan detail yang tersedia di Google Peta untuk toko tersebut.

Respons dari accounts.lfpStores.insert juga akan memberikan matchingState dan matchingStateHint jika pencocokan gagal.

Tips: Anda harus memantau respons tersebut untuk mencatat dan mengatasi masalah pencocokan lebih cepat daripada nanti dan menghindari membangun toko yang tak tertandingi, yang tidak akan dapat membuat penawaran ditayangkan.