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

Chế độ cài đặt quảng cáo kho hàng tại địa phương 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 quảng cáo đa kênh	OmnichannelSetting
Kết nối với đối tác Chương trình đố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 tại đị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 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 pháp nhân quốc gia cụ thể.

Sau đây là những thay đổi về 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 hoạt động. Merchant API hỗ trợ khả năng Gửi nhiều yêu cầu cùng lúc.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Phương thức lấy tất cả chế độ cài đặt quảng cáo kho hàng tại địa phương 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 hoạt động. 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 hoạt động. 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
  • Đến lấy 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 Lấy hàng.

OmnichannelSetting

Shopping Content API		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 theo Kho lưu trữ dữ liệu ngôn ngữ chung (CLDR) (ví dụ: "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Bắt buộc. Loại Trang chủ 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 nhà bán hàng 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 nhà bán hàng 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 đến lấy 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 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 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 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ệ của 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

Shopping Content API		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 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

Shopping Content API		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 đối tượng được đặt. Đố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 đó để xem xét việc phân phát quảng cáo cho sản phẩm còn hàng. 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 phân phát của sản phẩm 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

Shopping Content API		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 đến lấy hàng. Bắt buộc nếu đối tượng được đặt. API chỉ sử dụng thông tin này để xem xé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 dịch vụ đến 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

Shopping Content API		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 dùng để nhận dạng 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

Shopping Content API		Merchant API
Trường	Loại	Trường	Loại	Nội dung mô tả
shippingCostPolicyUrl	string	uri	string	Bắt buộc. URI của 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

Shopping Content API		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ể có là ACTIVE FAILED RUNNING

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

InventoryVerification

Shopping Content API		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ệ cho quy trình 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

Shopping Content API		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 Trang doanh nghiệp trên Google Đị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ố trang thông tin 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.