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 Shopping Content API, thì Merchant API sẽ có một số thay đổi quan trọng.

Giờ đây, chế độ cài đặt LIA thuộc một trong 3 thành phần cốt lõi, mỗi thành phần có một tài nguyên được 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 Local Feed Partnership (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 cửa hàng địa phương	GbpAccount

Ngoài ra, với chế độ cài đặt LIA, mỗi tài khoản có một tài nguyên duy nhất và tài nguyên đó 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 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ẽ ngừng hoạt động. Merchant API hỗ trợ khả năng Gửi nhiều yêu cầu cùng một lúc.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Một phương thức để nhận 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 để nhận omnichannelSettings cho những tài khoản phụ mà 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ẽ ngừng hoạt động. Thay vào đó, hãy dùng accounts.omnichannelSettings.create hoặc accounts.omnichannelSettings.update với mặt nạ mới.
	liasettings.setomnichannelexperience	Phương thức này sẽ ngừng hoạt động. Thay vào đó, hãy dùng accounts.omnichannelSettings.create hoặc accounts.omnichannelSettings.update với mặt nạ mới.
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
  • Nhận 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 đối với PickupType. Xem phần Tự đến lấy.

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 của Kho lưu trữ 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 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 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 (Giá trị 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 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 khô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 một nhà cung cấp LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI và trạng thái 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 và trạng thái của trang giới thiệu cho regionCode này
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Trạng thái của 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)	Hãy 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 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ạn phải cung cấp thông tin này nếu 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, bạn phải để trống, nhưng đối với MHLSF, bạn không được để trống. Dịch vụ này chỉ sử dụng thông tin đó để xem xét việc phân phát hàng trong kho. 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 tính năng phân phát khi còn hàng. Các giá trị có thể sử dụng là ACTIVE FAILED RUNNING ACTION_REQUIRED

Để xem 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. Bắt buộc nếu bạn đặt đối tượng. API này chỉ sử dụng thông tin đó để xem xét dịch vụ 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 dịch vụ lấy hàng. Các giá trị có thể sử dụng là ACTIVE FAILED RUNNING

Để xem 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 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 phiên bản Nội dung mua sắm, hãy xem 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 của 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ể là ACTIVE FAILED RUNNING

Để xem phiên bản Nội dung mua sắm, hãy xem 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 của người liên hệ để 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 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ẽ bị xoá.
displayName	string	displayName	string	Tên hiển thị của nhà cung cấp LFP

Để xem phiên bản Nội dung mua sắm, hãy xem 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ã nhận dạng 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 phiên bản Nội dung mua sắm, hãy xem GmbAccountsGmbAccount.