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ẻ dữ liệu về kho hàng, cửa hàng và doanh số 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:

• Phương thức để truy xuất trạng thái của tài sản cấp người bán 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 đối tác nguồn cấp dữ liệu địa phương:

POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert

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

Dưới đây là thông tin so sánh mẫu về 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/{merchantId}/pos/{targetMerchantId}/inventory	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
Giá trị nhận dạng	{merchantId}/pos/{targetMerchantId}	{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 cục bộ cho yêu cầu chèn chương trình ưu đãi:

	Content API	Merchant API
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert
Giá trị nhận dạng	{merchantId}/pos/{targetMerchantId}	{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 cục bộ cho yêu cầu chèn cửa hàng:

	Content API	Merchant API
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert
Giá trị nhận dạng	{merchantId}/pos/{targetMerchantId}	{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/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert	{merchantId}/pos/{targetMerchantId}	{parent}	parent có định dạng accounts/{lfpPartnerAccountId}
delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}	DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{merchantId}/pos/{targetMerchantId}/store/{storeCode}	{name}	name ở định dạng accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
get	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}	GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{merchantId}/pos/{targetMerchantId}/store/{storeCode}	{name}	name ở định dạng accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
list	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores	/{merchantId}/pos/{targetMerchantId}	{parent}	{parent} có định dạng accounts/{lfpPartnerAccountId}

Sau đây là những điểm 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/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert	{merchantId}/pos/{targetMerchantId}	{parent}	parent có định dạng accounts/{lfpPartnerAccountId}

Sau đây là những thay đổi đối với các phương thức API bán hàng trong API đối 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/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert	{merchantId}/pos/{targetMerchantId}	{parent}	{parent} có định dạng accounts/{lfpPartnerAccountId}

Tài nguyên

Dưới đâ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 cục bộ. 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 thể làm	name: string	Thêm trường mới để phân biệt các cửa hàng
Không thể làm	targetAccount: integer	Tài khoản người bán để 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 thể làm	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 đưa vào ở đây không thay đổi.

Content API for Shopping	Merchant API	Mô tả
Không thể làm	name: string	Thêm trường mới để phân biệt các khoảng không quảng cáo
Không thể làm	targetAccount: integer	Tài khoản người bán để 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 của 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 để trở thành không bắt buộc
Không thể làm	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 phần Giá.
timestamp: string	collectionTime: string	timestamp đổi tên thành collectionTime.
kind: string	Không thể làm	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 điểm thay đổi đối với việc chèn chương trình ưu đãi. 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 thể làm	name: string	Thêm trường mới để phân biệt các khoảng không quảng cáo
Không thể làm	targetAccount:integer	Tài khoản người bán để chèn lượt bán hàng
targetCountry: string	regionCode: string	Mã lãnh thổ CLDR của 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 phần Giá.
timestamp: string	saleTime: string	timestamp đổi tên thành saleTime.
kind: string	Không thể làm	kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương.