Anda dapat menggunakan Merchant API untuk membagikan data inventaris, toko, dan penjualan Anda kepada Google agar visibilitas dan pengelolaannya 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 Local feeds partnership API.
Permintaan
Gunakan format URL permintaan berikut untuk local feeds partnership API:
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 local feeds partnership API 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 local feeds partnership API 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 local feeds partnership API 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 yang terjadi pada metode API toko di local feeds partnership API:
| 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 yang terjadi pada metode API inventaris di local feeds partnership API:
| 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 yang terjadi pada metode API penjualan di local feeds partnership API:
| 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 yang terjadi pada resource toko di local feeds partnership API. 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 local feeds partnership API |
Berikut perubahan yang terjadi 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 local feeds partnership API. |
Berikut perubahan yang terjadi 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 local feeds partnership API. |