Di chuyển mối quan hệ đối tác nguồn cấp dữ liệu địa phương

Bạn có thể sử dụng Merchant API để chia sẻ kho hàng, cửa hàng và dữ liệu bán hàng với Google nhằm tăng khả năng hiển thị và quản lý hiệu quả hơn.

Tính năng mới

Ngoài các tính năng của Content API, Merchant API còn cung cấp các tính năng mới sau đây:

• Một phương thức để truy xuất trạng thái của các thuộc tính ở cấp doanh nghiệp liên quan đến việc tích hợp đối tác nguồn cấp dữ liệu địa phương
• Phương thức gửi thông báo cho nhà bán lẻ

Để biết thông tin chi tiết về các phương thức này, hãy xem API đối tác nguồn cấp dữ liệu địa phương.

Yêu cầu

Sử dụng định dạng URL yêu cầu sau đây cho API quan hệ đối tác nguồn cấp dữ liệu tại địa phương:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

Để biết thêm thông tin, hãy xem Phương thức: accounts.lfpInventories.insert.

Dưới đây là ví dụ so sánh Content API for Shopping với API đối tác nguồn cấp dữ liệu tại địa phương cho yêu cầu chèn khoảng không quảng cáo:

	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
Giá trị nhận dạng	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Dưới đây là ví dụ so sánh Content API for Shopping với API đối tác nguồn cấp dữ liệu tại địa phương cho yêu cầu chèn một chương trình ưu đãi:

	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
Giá trị nhận dạng	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Dưới đây là một ví dụ so sánh Content API for Shopping với API đối tác nguồn cấp dữ liệu tại địa phương cho yêu cầu chèn một cửa hàng:

	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
Giá trị nhận dạng	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Phương thức

Sau đây là những thay đổi đối với các phương thức API cửa hàng trong API đối tác nguồn cấp dữ liệu địa phương:

Phương thức	URL trong Content API for Shopping	URL trong Merchant API	Giá trị nhận dạng trong Content API for Shopping	Giá trị nhận dạng trong Merchant API	Mô tả
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 có định dạng 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 có định dạng 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 có định dạng 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} có định dạng accounts/{IFP_PARTNER_ACCOUNT_ID}

Sau đây là những thay đổi đối với các phương thức API kho hàng trong API đối tác nguồn cấp dữ liệu địa phương:

Phương thức	URL trong Content API for Shopping	URL trong Merchant API	Giá trị nhận dạng trong Content API for Shopping	Giá trị nhận dạng trong Merchant API	Mô tả
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 có định dạng accounts/{IFP_PARTNER_ACCOUNT_ID}

Sau đây là những thay đổi đối với các phương thức API bán hàng trong API hợp tác nguồn cấp dữ liệu tại địa phương:

Phương thức	URL trong Content API for Shopping	URL trong Merchant API	Giá trị nhận dạng trong Content API for Shopping	Giá trị nhận dạng trong Merchant API	Mô tả
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} có định dạng accounts/{IFP_PARTNER_ACCOUNT_ID}

Tài nguyên

Sau đây là những thay đổi đối với tài nguyên cửa hàng trong API đối tác nguồn cấp dữ liệu địa phương. Các trường không có trong danh sách này sẽ không thay đổi.

Content API for Shopping	Merchant API	Mô tả
Không được hỗ trợ	name: string	Thêm trường mới để phân biệt các cửa hàng
Không được hỗ trợ	targetAccount: integer	Tài khoản Merchant Center để chèn khoảng không quảng cáo
targetCountry: string	regionCode: string	targetCountry đổi tên thành regionCode.
websiteUrl: string	websiteUri: string	websiteUrl đổi tên thành websiteUri.
kind: string	Không được hỗ trợ	kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương

Sau đây là những thay đổi đối với việc chèn khoảng không quảng cáo. Các trường không có trong danh sách này sẽ không thay đổi.

Content API for Shopping	Merchant API	Mô tả
Không được hỗ trợ	name: string	Đã thêm trường mới để phân biệt các khoảng không quảng cáo
Không được hỗ trợ	targetAccount: integer	Tài khoản Merchant Center để chèn khoảng không quảng cáo.
targetCountry: string	regionCode: string	targetCountry đổi tên thành regionCode Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán.
itemId: string	offerId: string	itemId đổi tên thành offerId.
quantity: string	quantity: string	quantity đã được cập nhật thành không bắt buộc
Không được hỗ trợ	availability: string	availability là bắt buộc
price: { object (Price) }	price: { object (Price) }	Định nghĩa về giá đã thay đổi. Để biết thêm thông tin, hãy xem bài viết Giá.
timestamp: string	collectionTime: string	timestamp đổi tên thành collectionTime.
kind: string	Không được hỗ trợ	kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương.

Sau đây là những thay đổi đối với việc chèn một lượt bán hàng. Các trường không có trong danh sách này sẽ không thay đổi.

Content API for Shopping	Merchant API	Mô tả
Không được hỗ trợ	name: string	Đã thêm trường mới để phân biệt các khoảng không quảng cáo
Không được hỗ trợ	targetAccount:integer	Tài khoản Merchant Center để chèn doanh số
targetCountry: string	regionCode: string	Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán.
itemId: string	offerId: string	itemId đổi tên thành offerId.
price: { object (Price) }	price: { object (Price) }	Định nghĩa về giá đã thay đổi. Để biết thêm thông tin, hãy xem bài viết Giá.
timestamp: string	saleTime: string	timestamp đổi tên thành saleTime.
kind: string	Không được hỗ trợ	kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương.