Anda dapat menggunakan Merchant API untuk membagikan data inventaris, toko, dan penjualan Anda ke 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 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/v1/{PARENT}/lfpInventories:insert
Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.lfpInventories.insert.
Berikut 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 contoh perbandingan Content API for Shopping dengan API kemitraan feed lokal untuk permintaan penyisipan promo:
| 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 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 menggunakan 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 menggunakan 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 menggunakan 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} menggunakan format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Berikut perubahan untuk metode inventory API 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 menggunakan 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} menggunakan format accounts/{IFP_PARTNER_ACCOUNT_ID} |
Resource
Berikut perubahan yang terjadi 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 berbagai toko |
| Tidak didukung | targetAccount: integer |
Akun Merchant Center untuk menyisipkan inventaris |
targetCountry: string |
regionCode: string |
targetCountry telah diganti namanya menjadi regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl telah diganti namanya menjadi websiteUri |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal |
Berikut perubahan yang terjadi 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 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 telah diganti namanya menjadi offerId |
quantity: string |
quantity: string |
quantity telah diperbarui menjadi opsional |
| Tidak didukung | availability: string |
availability wajib diisi |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
collectionTime: string |
timestamp telah diganti namanya menjadi collectionTime |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal. |
Berikut perubahan yang terjadi untuk menyisipkan 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 telah diganti namanya menjadi offerId |
|
|
Definisi harga telah berubah. Untuk mengetahui informasi selengkapnya, lihat Harga. |
timestamp: string |
saleTime: string |
timestamp telah diganti namanya menjadi saleTime |
kind: string |
Tidak didukung | kind tidak didukung di API kemitraan feed lokal. |