Migrasi kemitraan feed lokal

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 ke retailer

Untuk mengetahui detail tentang metode ini, lihat Local feeds partnership API.

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
Pengenal	{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
Pengenal	{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
Pengenal	{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 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 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 dalam format accounts/{IFP_PARTNER_ACCOUNT_ID}

Berikut perubahan pada metode sales 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}/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 berbagai toko
Tidak didukung	targetAccount: integer	Akun Merchant Center 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 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 diganti nama menjadi offerId
quantity: string	quantity: string	quantity telah diperbarui 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 perubahan yang terjadi pada cara memasukkan 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 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.