Di chuyển chế độ cài đặt Quảng cáo kho hàng tại địa phương (LIA)

Nếu bạn đã sử dụng chế độ cài đặt Quảng cáo kho hàng tại địa phương trong API Nội dung mua sắm, thì có một số thay đổi quan trọng đối với Merchant API.

Chế độ cài đặt LIA hiện thuộc một trong ba thành phần cốt lõi, mỗi thành phần có một tài nguyên liên kết.

Thành phần cốt lõi	Tài nguyên
Cấu hình tài khoản để phân phát trên nhiều kênh	OmnichannelSetting
Kết nối với đối tác Đối tác nguồn cấp dữ liệu địa phương (LFP) để lấy dữ liệu kho hàng	LfpProvider
Kết nối với tài khoản Trang doanh nghiệp trên Google (GBP) để lấy dữ liệu về cửa hàng địa phương	GbpAccount

Ngoài ra, với chế độ cài đặt LIA, mỗi tài khoản sẽ có một tài nguyên duy nhất và tài nguyên này chứa danh sách chế độ cài đặt cho từng pháp nhân quốc gia. Với OmnichannelSettings, bạn có thể liên kết nhiều tài nguyên với một tài khoản. Mỗi tài nguyên đại diện cho chế độ cài đặt của một thực thể quốc gia cụ thể.

Sau đây là những thay đổi đối với các yêu cầu và tài nguyên.

Yêu cầu

Miền mới	Tên phương thức Content API	Tên phương thức Merchant API
accounts.omnichannelSettings	liasettings.custombatch	Phương thức này sẽ không còn được dùng nữa. Merchant API hỗ trợ tính năng Gửi nhiều yêu cầu cùng một lúc.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Phương thức để lấy tất cả chế độ cài đặt LIA cho tất cả tài khoản phụ không còn được cung cấp trực tiếp nữa. Thay vào đó, hãy truy vấn tất cả tài khoản phụ và sử dụng accounts.omnichannelSettings.list để lấy omnichannelSettings cho những tài khoản bạn quan tâm.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Phương thức này sẽ không còn được dùng nữa. Thay vào đó, hãy sử dụng accounts.omnichannelSettings.create hoặc accounts.omnichannelSettings.update với mặt nạ đã cập nhật.
	liasettings.setomnichannelexperience	Phương thức này sẽ không còn được dùng nữa. Thay vào đó, hãy sử dụng accounts.omnichannelSettings.create hoặc accounts.omnichannelSettings.update với mặt nạ đã cập nhật.
accounts.omnichannelSettings.lfpProvider	liasettings.listposdataproviders	accounts.omnichannelSettings.lfpProviders.findLfpProviders
	liasettings.setposdataprovider	accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount	liasettings.getaccessiblegmbaccounts	accounts.gbpAccount.list
	liasettings.requestgmbaccess	accounts.gbpAccount.linkGbpAccount

Tài nguyên

• OmnichannelSetting
  • LsfType
  • InStock
  • Lấy hàng tại cửa hàng
  • LfpLink
  • OnDisplayToOrder
  • Giới thiệu
  • InventoryVerification
• LfpProvider
• GbpAccount

Ngoài ra, dịch vụ này hoạt động theo cách khác cho PickupType. Xem phần Bắt đầu.

OmnichannelSetting

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
(không áp dụng)	(không áp dụng)	name	string	Tên tài nguyên của chế độ cài đặt đa kênh này. Định dạng: Định dạng: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Bắt buộc. Mã quốc gia Kho dữ liệu ngôn ngữ chung (CLDR) (ví dụ: "Hoa Kỳ")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Bắt buộc. Loại Trang chủ của cửa hàng địa phương (LSF) cho regionCode này. Các giá trị có thể là: GHLSF (Trang chủ cửa hàng địa phương do Google lưu trữ) MHLSF_BASIC (Trang chủ cửa hàng địa phương do người bán lưu trữ (cơ bản), đề cập đến các trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng) MHLSF_FULL (Trang chủ cửa hàng địa phương do người bán lưu trữ (đầy đủ), đề cập đến các trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng)
(không áp dụng)	(không áp dụng)	inStock	object (InStock)	URI (Mã nhận dạng tài nguyên thống nhất) của trang sản phẩm còn hàng và trạng thái phân phát cho regionCode này. Đặt ít nhất một trong các đối tượng inStock hoặc pickup trong API tạo nếu bạn đã chọn một trong các loại MHLSF, nhưng chỉ đặt inStock nếu lsfType là GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	URI trang sản phẩm của tính năng Lấy hàng tại cửa hàng và trạng thái phân phát cho regionCode này. Đặt ít nhất một trong các đối tượng inStock hoặc Pickup trong API tạo nếu bạn đã chọn một trong các loại MHLSF, nhưng đừng đặt đối tượng đó khi GHLSF được đặt làm lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Chỉ có đầu ra. Đường liên kết đã thiết lập đến nhà cung cấp LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI và trạng thái của chính sách "hàng trưng bày có sẵn để đặt hàng" (ODO) cho regionCode này
about	object (LiaAboutPageSettings)	about	object (About)	URI trang giới thiệu và trạng thái của regionCode này
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Trạng thái quy trình xác minh kho hàng và thông tin liên hệ cho regionCode này
omnichannelExperience	object (LiaOmnichannelExperience)	(không áp dụng)	(không áp dụng)	Sử dụng lsfType và pickup (ở trên).

LsfType

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
lsfType	string	lsfType	enum (LsfType)	Loại Trang chủ của cửa hàng địa phương (LSF). Các giá trị có thể sử dụng là: GHLSF (Trang chủ của cửa hàng địa phương do Google lưu trữ) MHLSF_BASIC (Trang chủ cửa hàng địa phương do người bán lưu trữ (cơ bản)) MHLSF_FULL (Trang chủ cửa hàng địa phương do người bán lưu trữ (đầy đủ))

InStock

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
(không áp dụng)	(không áp dụng)	uri	string	URI trang đích của sản phẩm. Bắt buộc nếu bạn chọn một trong các loại MHLSF. Bắt buộc nếu bạn đặt đối tượng. Đối với GHLSF, giá trị này phải trống, nhưng đối với MHLSF, giá trị này không được để trống. Dịch vụ này chỉ sử dụng thông tin này để xem xét việc phân phát hàng có sẵn. Miền URI này phải khớp với trang chủ của người bán.
(không áp dụng)	(không áp dụng)	state	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái của hoạt động phân phát sản phẩm còn hàng. Các giá trị có thể sử dụng là ACTIVE FAILED RUNNING ACTION_REQUIRED

Để xem lại phiên bản Nội dung mua sắm, hãy xem LiaCountrySettings và LiaOmnichannelExperience.

Đến lấy hàng

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
(không áp dụng)	(không áp dụng)	uri	string	URI trang sản phẩm của tính năng lấy hàng tại cửa hàng. Bắt buộc nếu bạn đặt đối tượng. API chỉ sử dụng thông tin này để xem xét việc phân phát dịch vụ đến lấy hàng. Miền URI này phải khớp với trang chủ của người bán.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái của lượt phân phát đến lấy hàng. Các giá trị có thể sử dụng là ACTIVE FAILED RUNNING

Để xem xét phiên bản Nội dung mua sắm, hãy xem LiaCountrySettings và LiaOmnichannelExperience.

LfpLink

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
posDataProviderId	string	lfpProvider	string	Bắt buộc. Tên tài nguyên của nhà cung cấp LFP
posExternalAccountId	string	externalAccountId	string	Bắt buộc. Mã tài khoản mà nhà cung cấp LFP biết đến người bán này
(không áp dụng)	(không áp dụng)	state	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái của LfpLink. Các giá trị có thể sử dụng là ACTIVE RUNNING

Để xem lại phiên bản Nội dung mua sắm, hãy xem LiaPosDataProvider.

OnDisplayToOrder

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
shippingCostPolicyUrl	string	uri	string	Bắt buộc. URI chính sách "hàng trưng bày có sẵn để đặt hàng" (ODO).
status	string	state	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái của URI. Các giá trị có thể có là ACTIVE FAILED RUNNING

Để xem lại phiên bản Nội dung mua sắm, hãy xem phần LiaOnDisplayToOrderSettings.

Giới thiệu

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
url	string	uri	string	Bắt buộc. URI trang giới thiệu
status	string	state	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái của URI. Các giá trị có thể có là ACTIVE FAILED RUNNING

Để xem lại phiên bản Nội dung mua sắm, hãy xem phần LiaAboutPageSettings.

InventoryVerification

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
status	string	state	enum (InventoryVerification.State)	Chỉ có đầu ra. Trạng thái của quy trình xác minh kho hàng. Các giá trị có thể có là ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Bắt buộc. Tên người liên hệ cho quy trình xác minh kho hàng
inventoryVerificationContactEmail	string	contactEmail	string	Bắt buộc. Email của người liên hệ để xác minh kho hàng
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Chỉ có đầu ra. Trạng thái xác minh người liên hệ. Các giá trị có thể có là ACTIVE RUNNING

Để xem lại phiên bản Nội dung mua sắm, hãy xem LiaCountrySettings và LiaInventorySettings.

LfpProvider

Content API for Shopping		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
fullName	string	name	string	Tên tài nguyên của nhà cung cấp LFP. Định dạng: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(không áp dụng)	(không áp dụng)	regionCode	string	Bắt buộc. Mã quốc gia CLDR
providerId	string	(không áp dụng)	(không áp dụng)	Trường này sẽ biến mất.
displayName	string	displayName	string	Tên hiển thị của nhà cung cấp LFP

PosDataProvidersPosDataProvider

GbpAccount

Shopping Content API		Merchant API
Field	Type	Trường	Loại	Nội dung mô tả
name	string	name	string	Tên tài nguyên của tài khoản GBP Định dạng: accounts/{account}/gbpAccount/{gbp_account}
(không áp dụng)	(không áp dụng)	gbpAccountId	string	Mã của trang doanh nghiệp
type	string	type	enum (GbpAccount.Type)	Loại trang doanh nghiệp. Các giá trị có thể sử dụng là USER (tài khoản cá nhân) BUSINESS_ACCOUNT (tài khoản doanh nghiệp)
email	string	gbpAccountName	string	Tên của trang doanh nghiệp: Đối với tài khoản cá nhân, đây là mã email của chủ sở hữu. Đối với tài khoản doanh nghiệp, đây là tên của tài khoản doanh nghiệp.
listingCount	string	listingCount	int64	Số lượng trang thông tin được liên kết với tài khoản này

Để xem lại phiên bản Nội dung mua sắm, hãy xem phần GmbAccountsGmbAccount.