Anda dapat menggunakan Merchant API untuk membagikan data inventaris, toko, dan penjualan ke Google untuk visibilitas dan pengelolaan yang lebih baik.
Fitur baru
Selain fitur Content API, Merchant API menawarkan fitur baru berikut:
- Metode untuk mengambil status properti tingkat penjual yang terkait dengan integrasi kemitraan feed lokal
- Metode untuk mengirim notifikasi ke retailer
Untuk mengetahui detail tentang metode ini, lihat API kemitraan feed lokal.
Permintaan
Gunakan format URL permintaan berikut untuk API kemitraan feed lokal:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.lfpInventories.insert.
Berikut adalah contoh perbandingan Content API for Shopping dengan API partner feed lokal untuk permintaan menyisipkan inventaris:
Content API | Merchant API | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert
|
Pengenal |
{merchantId}/pos/ {targetMerchantId}
|
{parent} |
Berikut adalah contoh perbandingan Content API for Shopping dengan API partner feed lokal untuk permintaan menyisipkan promo:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
Pengenal | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Berikut adalah contoh perbandingan Content API for Shopping dengan API partner feed lokal untuk permintaan menyisipkan toko:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpStores:insert |
Pengenal | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Metode
Berikut yang berubah untuk metode API toko di API kemitraan feed lokal:
Metode | URL di Content API for Shopping | URL di Merchant API | ID di Content API for Shopping | ID di Merchant API | Deskripsi |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores:insert |
{merchantId}/pos /{targetMerchantId} |
{parent} | parent dalam format accounts/{lfpPartnerAccountId} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name menggunakan format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name menggunakan format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores |
/{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} menggunakan format accounts/ {lfpPartnerAccountId} |
Berikut yang berubah untuk metode API inventaris di API kemitraan feed lokal:
Metode | URL di Content API for Shopping | URL di Merchant API | ID di Content API for Shopping | ID di Merchant API | Deskripsi |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | parent menggunakan format accounts/ {lfpPartnerAccountId} |
Berikut adalah perubahan pada metode API penjualan di API kemitraan feed lokal:
Metode | URL di Content API for Shopping | URL di Merchant API | ID di Content API for Shopping | ID di Merchant API | Deskripsi |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} dalam format accounts/ {lfpPartnerAccountId} |
Resource
Berikut adalah hal yang telah berubah untuk resource toko di API kemitraan feed lokal. Kolom yang tidak disertakan di sini tidak berubah.
Content API for Shopping | Merchant API | Deskripsi |
Tidak didukung | name: string |
Menambahkan kolom baru untuk membedakan berbagai toko |
Tidak didukung | targetAccount: integer |
Akun penjual yang akan digunakan untuk menyisipkan inventaris |
targetCountry: string |
regionCode: string |
targetCountry diganti nama menjadi regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl diganti nama menjadi websiteUri |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal |
Berikut hal yang telah berubah untuk menyisipkan inventaris. Kolom yang tidak disertakan di sini tidak berubah.
Content API for Shopping | Merchant API | Deskripsi |
Tidak didukung | name: string |
Menambahkan kolom baru untuk membedakan berbagai inventaris |
Tidak didukung | targetAccount: integer |
Akun penjual tempat inventaris akan disisipkan. |
targetCountry: string |
regionCode: string |
targetCountry diganti namanya menjadi regionCode . Kode wilayah CLDR untuk negara tempat produk dijual. |
itemId: string |
offerId: string |
itemId diganti nama menjadi offerId |
quantity: string |
quantity: string |
quantity telah diperbarui untuk menjadikannya opsional |
Tidak didukung | availability: string |
availability wajib diisi |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
collectionTime: string |
timestamp diganti nama menjadi collectionTime |
kind: string |
Tidak didukung | kind tidak didukung dalam API kemitraan feed lokal. |
Berikut ini hal yang berubah terkait cara memasukkan promo. Kolom yang tidak disertakan di sini tidak akan berubah.
Content API for Shopping | Merchant API | Deskripsi |
Tidak didukung | name: string |
Menambahkan kolom baru untuk membedakan berbagai inventaris |
Tidak didukung | targetAccount:integer |
Akun penjual yang akan digunakan untuk memasukkan penjualan |
targetCountry: string |
regionCode: string |
Kode wilayah CLDR untuk negara tempat produk dijual. |
itemId: string |
offerId: string |
itemId diganti nama menjadi offerId |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
saleTime: string |
timestamp diganti nama menjadi saleTime |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal. |