Anda dapat menggunakan Merchant API untuk membagikan data inventaris, toko, dan penjualan Anda kepada Google agar visibilitas dan pengelolaan lebih baik.
Fitur baru
Selain fitur Content API, Merchant API menawarkan fitur baru berikut:
- Metode untuk mengambil status properti tingkat bisnis yang terkait dengan integrasi kemitraan feed lokal
- Metode untuk mengirim notifikasi kepada retailer
Untuk mengetahui detail metode ini, lihat API kemitraan feed lokal.
Permintaan
Gunakan format URL permintaan berikut untuk API kemitraan feed lokal:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.lfpInventories.insert.
Berikut adalah contoh perbandingan Content API for Shopping dengan API kemitraan feed lokal untuk permintaan penyisipan inventaris:
| Content API | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| ID |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Berikut adalah contoh perbandingan Content API for Shopping dengan API kemitraan feed lokal untuk permintaan penyisipan penjualan:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| ID | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Berikut adalah contoh perbandingan Content API for Shopping dengan API kemitraan feed lokal untuk permintaan penyisipan toko:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| ID | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Metode
Berikut perubahan pada 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent dalam format accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name dalam format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name dalam format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} dalam format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Berikut perubahan pada 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent dalam format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Berikut 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} dalam format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Resource
Berikut perubahan pada 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 toko yang berbeda |
| Tidak didukung | targetAccount: integer |
Akun Merchant Center untuk menyisipkan inventaris |
targetCountry: string |
regionCode: string |
targetCountry diganti namanya menjadi regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl diganti namanya menjadi websiteUri |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal |
Berikut perubahan pada penyisipan 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 inventaris yang berbeda |
| Tidak didukung | targetAccount: integer |
Akun Merchant Center untuk menyisipkan inventaris. |
targetCountry: string |
regionCode: string |
targetCountry diganti namanya menjadi regionCode. Kode wilayah CLDR untuk negara tempat produk dijual. |
itemId: string |
offerId: string |
itemId diganti namanya menjadi offerId |
quantity: string |
quantity: string |
quantity telah diperbarui agar bersifat opsional |
| Tidak didukung | availability: string |
availability wajib diisi |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
collectionTime: string |
timestamp diganti namanya menjadi collectionTime |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal. |
Berikut perubahan pada penyisipan penjualan. Kolom yang tidak disertakan di sini tidak berubah.
| Content API for Shopping | Merchant API | Deskripsi |
| Tidak didukung | name: string |
Menambahkan kolom baru untuk membedakan inventaris yang berbeda |
| Tidak didukung | targetAccount:integer |
Akun Merchant Center untuk menyisipkan penjualan |
targetCountry: string |
regionCode: string |
Kode wilayah CLDR untuk negara tempat produk dijual. |
itemId: string |
offerId: string |
itemId diganti namanya menjadi offerId |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
saleTime: string |
timestamp diganti namanya menjadi saleTime |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal. |