Migrasi kemitraan feed lokal

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Pengenal {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert
Pengenal {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert
Pengenal {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{parent=accounts/*}/lfpStores /{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} menggunakan format accounts/{IFP_PARTNER_ACCOUNT_ID}

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent menggunakan format accounts/{IFP_PARTNER_ACCOUNT_ID}

Berikut yang berubah untuk 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/v1beta/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} menggunakan format accounts/{IFP_PARTNER_ACCOUNT_ID}

Resource

Berikut adalah perubahan untuk resource toko di API kemitraan feed lokal. 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 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-hal yang telah berubah untuk menyisipkan inventaris. 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 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 nama menjadi offerId
quantity: string quantity: string quantity telah diperbarui untuk menjadi opsional
Tidak didukung availability: string availability wajib diisi

price: {

object (Price)

}

price: {

object (Price)

}

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 di API kemitraan feed lokal.

Berikut ini perubahan yang dilakukan untuk menyisipkan 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

price: {

object (Price)

}

price: {

object (Price)

}

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.