Memigrasikan setelan Iklan Inventaris Lokal (LIA)

Jika Anda menggunakan setelan Iklan Inventaris Lokal di bagian Shopping Content API, ada beberapa perubahan penting pada Merchant API.

Setelan LIA kini termasuk dalam salah satu dari tiga komponen inti, yang masing-masing memiliki resource terkait.

Komponen inti	Resource
Konfigurasi akun untuk penayangan Omnichannel	OmnichannelSetting
Koneksi ke partner Kemitraan Feed Lokal (LFP) untuk data inventaris	LfpProvider
Koneksi ke akun Google Profil Bisnis (GBP) untuk data toko lokal	GbpAccount

Selain itu, dengan setelan LIA, ada satu resource per akun dan berisi daftar setelan untuk setiap entitas nasional. Dengan OmnichannelSettings, Anda dapat mengaitkan beberapa resource dengan akun. Setiap resource mewakili setelan untuk entitas nasional tertentu.

Berikut ini perubahan permintaan dan resource.

Permintaan

Domain baru	Nama metode Content API	Nama metode Merchant API
accounts.omnichannelSettings	liasettings.custombatch	Metode ini akan dihapus. Merchant API mendukung kemampuan untuk Mengirim beberapa permintaan sekaligus.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Metode untuk mendapatkan semua setelan LIA untuk semua sub-akun tidak lagi tersedia secara langsung. Sebagai gantinya, buat kueri semua sub-akun dan gunakan accounts.omnichannelSettings.list untuk mendapatkan omnichannelSettings untuk sub-akun yang diinginkan.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Metode ini akan dihapus. Sebagai gantinya, gunakan accounts.omnichannelSettings.create atau accounts.omnichannelSettings.update dengan mask yang diperbarui.
	liasettings.setomnichannelexperience	Metode ini akan dihapus. Sebagai gantinya, gunakan accounts.omnichannelSettings.create atau accounts.omnichannelSettings.update dengan mask yang diperbarui.
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

Resource

• OmnichannelSetting
  • LsfType
  • InStock
  • Pengambilan
  • LfpLink
  • OnDisplayToOrder
  • Tentang
  • InventoryVerification
• LfpProvider
• GbpAccount

Selain itu, layanan berperilaku berbeda untuk PickupType. Lihat Pengambilan.

OmnichannelSetting

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
(t/a)	(t/a)	name	string	Nama resource setelan omnichannel ini. Format: Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Wajib. Kode negara Common Locale Data Repository (CLDR) (misalnya, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Wajib. Jenis Halaman Retailer Lokal (LSF) untuk regionCode ini. Nilai yang memungkinkan mencakup GHLSF (Halaman Retailer yang Dihosting Google) MHLSF_BASIC (Halaman Retailer yang Dihosting Penjual (Dasar), yang merujuk pada halaman produk dengan data ketersediaan di toko) MHLSF_FULL (Halaman Retailer yang Dihosting Penjual (Lengkap), yang merujuk pada halaman produk dengan data ketersediaan di toko)
(t/a)	(t/a)	inStock	object (InStock)	URI halaman produk yang tersedia (Universal Resource Identifier) dan status penayangan untuk regionCode ini. Tetapkan minimal salah satu objek inStock atau pickup di API pembuatan jika Anda memilih salah satu jenis MHLSF, tetapi hanya tetapkan inStock jika lsfType adalah GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	URI halaman produk Pengambilan dan status penayangan untuk regionCode ini. Tetapkan minimal salah satu objek inStock atau Pickup di API pembuatan jika Anda memilih salah satu jenis MHLSF, tetapi jangan tetapkan jika GHLSF ditetapkan sebagai lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Hanya output. Link yang dibuat ke penyedia LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI dan status kebijakan "produk contoh untuk pesanan" (ODO) untuk regionCode ini
about	object (LiaAboutPageSettings)	about	object (About)	URI dan status halaman tentang untuk regionCode ini
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Status proses verifikasi inventaris dan informasi kontak untuk regionCode ini
omnichannelExperience	object (LiaOmnichannelExperience)	(t/a)	(t/a)	Gunakan lsfType dan pickup (di atas).

LsfType

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
lsfType	string	lsfType	enum (LsfType)	Jenis Halaman Retailer Lokal (LSF). Kemungkinan nilainya adalah: GHLSF (Halaman Retailer yang Dihosting Google) MHLSF_BASIC (Halaman Retailer yang Dihosting Penjual Versi Dasar) MHLSF_FULL (Halaman Retailer yang Dihosting Penjual Lengkap)

InStock

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
(t/a)	(t/a)	uri	string	URI halaman landing produk. Wajib jika Anda memilih salah satu jenis MHLSF. Wajib jika objek ditetapkan. Untuk GHLSF, harus kosong, tetapi untuk MHLSF, tidak kosong. Layanan ini hanya menggunakannya untuk meninjau penayangan yang tersedia. Domain URI ini harus cocok dengan halaman beranda penjual.
(t/a)	(t/a)	state	enum (ReviewState.State)	Hanya output. Status penayangan produk yang tersedia. Nilai yang tersedia adalah ACTIVE FAILED RUNNING ACTION_REQUIRED

Untuk meninjau versi Konten Shopping, lihat LiaCountrySettings dan LiaOmnichannelExperience.

Pengambilan

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
(t/a)	(t/a)	uri	string	URI halaman produk pengambilan. Wajib jika objek ditetapkan. API hanya menggunakannya untuk meninjau penayangan pengambilan. Domain URI ini harus cocok dengan halaman beranda penjual.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Hanya output. Status penayangan pesanan ambil. Nilai yang tersedia adalah ACTIVE FAILED RUNNING

Untuk meninjau versi Konten Shopping, lihat LiaCountrySettings dan LiaOmnichannelExperience.

LfpLink

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
posDataProviderId	string	lfpProvider	string	Wajib. Nama resource penyedia LFP
posExternalAccountId	string	externalAccountId	string	Wajib. ID akun yang digunakan penyedia LFP untuk mengenali penjual ini
(t/a)	(t/a)	state	enum (ReviewState.State)	Hanya output. Status LfpLink. Nilai yang tersedia adalah ACTIVE RUNNING

Untuk meninjau versi Konten Shopping, lihat LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
shippingCostPolicyUrl	string	uri	string	Wajib. URI kebijakan "produk contoh untuk pesanan" (ODO).
status	string	state	enum (ReviewState.State)	Hanya output. Status URI. Kemungkinan nilainya adalah ACTIVE FAILED RUNNING

Untuk meninjau versi Konten Shopping, lihat LiaOnDisplayToOrderSettings.

Tentang

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
url	string	uri	string	Wajib. URI halaman tentang
status	string	state	enum (ReviewState.State)	Hanya output. Status URI. Kemungkinan nilainya adalah ACTIVE FAILED RUNNING

Untuk meninjau versi Konten Shopping, lihat LiaAboutPageSettings.

InventoryVerification

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
status	string	state	enum (InventoryVerification.State)	Hanya output. Status proses verifikasi inventaris. Kemungkinan nilainya adalah ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Wajib. Nama kontak untuk proses verifikasi inventaris
inventoryVerificationContactEmail	string	contactEmail	string	Wajib. Email kontak untuk proses verifikasi inventaris
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Hanya output. Status verifikasi kontak. Kemungkinan nilainya adalah ACTIVE RUNNING

Untuk meninjau versi Konten Shopping, lihat LiaCountrySettings dan LiaInventorySettings.

LfpProvider

Shopping Content API		Merchant API
Kolom	Jenis	Kolom	Jenis	Deskripsi
fullName	string	name	string	Nama resource penyedia LFP. Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(t/a)	(t/a)	regionCode	string	Wajib. Kode negara CLDR
providerId	string	(t/a)	(t/a)	Kolom ini akan dihapus.
displayName	string	displayName	string	Nama tampilan penyedia LFP

Untuk meninjau versi Konten Shopping, lihat PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		Merchant API
Field	Type	Kolom	Jenis	Deskripsi
name	string	name	string	Nama resource akun GBP Format: accounts/{account}/gbpAccount/{gbp_account}
(t/a)	(t/a)	gbpAccountId	string	ID profil bisnis
type	string	type	enum (GbpAccount.Type)	Jenis profil bisnis. Nilai yang tersedia adalah USER (akun pribadi) BUSINESS_ACCOUNT (akun bisnis)
email	string	gbpAccountName	string	Nama profil bisnis: Untuk akun pribadi, ini adalah ID email pemilik. Untuk akun bisnis, ini adalah nama akun bisnis.
listingCount	string	listingCount	int64	Jumlah listingan yang terkait dengan akun ini

Untuk meninjau versi Konten Shopping, lihat GmbAccountsGmbAccount.