انتقال تنظیمات «آگهی‌های فهرست موجودی محلی» (LIA)

اگر از تنظیمات آگهی‌های فهرست موجودی محلی تحت Shopping Content API استفاده کرده‌اید، چندین تغییر مهم در Merchant API وجود دارد.

تنظیمات «آگهی‌های موجودی محلی» اکنون به یکی از سه مؤلفه اصلی تعلق دارد که هرکدام منبعی مرتبط دارند.

جزء اصلی	منبع
پیکربندی حساب برای ارائه Omnichannel	OmnichannelSetting
اتصال به شریک شراکت فید محلی (LFP) برای داده‌های سیاهه	LfpProvider
اتصال به حساب نمایه کسب‌وکار Google برای داده‌های فروشگاه‌های محلی	GbpAccount

علاوه‌براین، با تنظیمات «آگهی‌های موجودی محلی»، برای هر حساب یک منبع وجود داشت و این منبع حاوی فهرستی از تنظیمات برای هر نهاد ملی بود. با OmnichannelSettings می‌توانید چندین منبع را با یک حساب مرتبط کنید. هر منبع نشان‌دهنده تنظیمات یک نهاد ملی خاص است.

در اینجا نحوه تغییر درخواست‌ها و منابع آورده شده است.

درخواست‌ها

دامنه جدید	نام روش Content API	نام روش Merchant API
accounts.omnichannelSettings	liasettings.custombatch	این روش ازبین می‌رود. ‫Merchant API از قابلیت ارسال چندین درخواست به‌طور هم‌زمان پشتیبانی می‌کند.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	روش دریافت همه تنظیمات «آگهی‌های موجودی محلی» برای همه حساب‌های فرعی دیگر مستقیماً دردسترس نیست. درعوض، همه حساب‌های فرعی را پُرسمان کنید و از accounts.omnichannelSettings.list برای دریافت omnichannelSettings برای موارد موردنظر استفاده کنید.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	این روش ازبین می‌رود. به‌جای آن، از accounts.omnichannelSettings.create یا accounts.omnichannelSettings.update با ماسک به‌روزشده استفاده کنید.
	liasettings.setomnichannelexperience	این روش ازبین می‌رود. به‌جای آن، از accounts.omnichannelSettings.create یا accounts.omnichannelSettings.update با ماسک به‌روزشده استفاده کنید.
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

منابع

• OmnichannelSetting
  • LsfType
  • InStock
  • تحویل
  • LfpLink
  • OnDisplayToOrder
  • درباره
  • InventoryVerification
• LfpProvider
• GbpAccount

علاوه‌براین، رفتار سرویس برای PickupType متفاوت است. تحویل گرفتن را ببینید.

OmnichannelSetting

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
(موجود نیست)	(موجود نیست)	name	string	نام منبع این تنظیم همه‌کاناله. قالب: قالب: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	الزامی. کد کشور «مخزن داده‌های محلی مشترک» (CLDR) (برای مثال، «US»)
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	الزامی. نوع ویترین فروشگاه محلی (LSF) برای این regionCode. مقادیر احتمالی شامل موارد زیر هستند: GHLSF (ویترین فروشگاه محلی با میزبانی Google) MHLSF_BASIC (ویترین فروشگاه محلی با میزبانی فروشنده (پایه)، که به صفحه‌های محصول با موجودی کالا در فروشگاه اشاره دارد) MHLSF_FULL (ویترین فروشگاه محلی کامل با میزبانی فروشنده، که به صفحه‌های محصول با موجودی کالا در فروشگاه اشاره دارد)
(موجود نیست)	(موجود نیست)	inStock	object (InStock)	شناسه منبع یکسان (URI) صفحه محصول موجود در انبار و وضعیت ارائه برای این regionCode. اگر یکی از انواع MHLSF را انتخاب کردید، حداقل یکی از اشیاء inStock یا pickup را در API ایجاد تنظیم کنید، اما اگر lsfType از نوع GHLSF است، فقط inStock را تنظیم کنید.
storePickupActive	boolean	pickup	object (Pickup)	شناسه منبع یکسان صفحه محصول «تحویل گرفتن» و وضعیت ارائه برای این regionCode. اگر یکی از انواع MHLSF را انتخاب کردید، حداقل یکی از اشیاء inStock یا Pickup را در میانای برنامه‌سازی کاربردی ایجاد تنظیم کنید، اما وقتی GHLSF به‌عنوان lsfType تنظیم شده است، آن را تنظیم نکنید.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	فقط خروجی. پیوند برقرارشده به ارائه‌دهنده «برنامه وفاداری محلی»
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	شناسه منبع یکسان خط‌مشی «درمعرض‌نمایش برای سفارش» (ODO) و وضعیت این regionCode
about	object (LiaAboutPageSettings)	about	object (About)	شناسه منبع یکسان صفحه درباره و وضعیت برای این regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	وضعیت فرایند درستی‌سنجی فهرست موجودی و اطلاعات تماس برای این regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(موجود نیست)	(موجود نیست)	از lsfType و pickup (در بالا) استفاده کنید.

LsfType

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
lsfType	string	lsfType	enum (LsfType)	نوع «ویترین فروشگاه محلی» (LSF). مقادیر ممکن عبارت‌اند از: GHLSF (ویترین فروشگاه محلی با میزبانی Google) ‫MHLSF_BASIC (ویترین فروشگاه محلی پایه با میزبانی فروشنده) ‫MHLSF_FULL (ویترین فروشگاه محلی با میزبانی فروشنده کامل)

InStock

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
(موجود نیست)	(موجود نیست)	uri	string	شناسه منبع یکسان صفحه مقصد محصول. اگر یکی از انواع MHLSF را انتخاب کرده باشید، الزامی است. اگر شیء تنظیم شده باشد، الزامی است. برای GHLSF، باید خالی باشد، اما برای MHLSF، نباید خالی باشد. این سرویس فقط برای بررسی ارائه موجودی از آن استفاده می‌کند. دامنه این شناسه منبع یکسان باید با صفحه اصلی فروشنده مطابقت داشته باشد.
(موجود نیست)	(موجود نیست)	state	enum (ReviewState.State)	فقط خروجی. وضعیت ارائه موجود در انبار. مقادیر دردسترس عبارت‌اند از ACTIVE FAILED RUNNING ACTION_REQUIRED

برای بررسی نسخه «محتوای Shopping»، LiaCountrySettings و LiaOmnichannelExperience را ببینید.

تحویل

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
(موجود نیست)	(موجود نیست)	uri	string	URI صفحه محصول تحویل گرفتن. اگر شیء تنظیم شده باشد، الزامی است. ‫API فقط برای بررسی خدمات تحویل گرفتن از آن استفاده می‌کند. دامنه این URI باید با صفحه اصلی فروشنده مطابقت داشته باشد.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	فقط خروجی. وضعیت ارائه تحویل. مقادیر دردسترس عبارت‌اند از ACTIVE FAILED RUNNING

برای بررسی نسخه «محتوای Shopping»، LiaCountrySettings و LiaOmnichannelExperience را ببینید.

LfpLink

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
posDataProviderId	string	lfpProvider	string	الزامی. نام منبع ارائه‌دهنده «برنامه ویترین محلی»
posExternalAccountId	string	externalAccountId	string	الزامی. شناسه حسابی که این فروشنده با آن برای ارائه‌دهنده «برنامه ویترین فروشگاه محلی» شناخته می‌شود
(موجود نیست)	(موجود نیست)	state	enum (ReviewState.State)	فقط خروجی. وضعیت LfpLink. مقادیر دردسترس عبارت‌اند از ACTIVE RUNNING

برای مرور نسخه «محتوای Shopping»، LiaPosDataProvider را ببینید.

OnDisplayToOrder

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
shippingCostPolicyUrl	string	uri	string	الزامی. شناسه منبع یکسان خط‌مشی «نمایش برای سفارش» (ODO).
status	string	state	enum (ReviewState.State)	فقط خروجی. وضعیت URI. مقادیر ممکن عبارتند از ACTIVE FAILED RUNNING

برای مرور نسخه «محتوای Shopping»، LiaOnDisplayToOrderSettings را ببینید.

درباره

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
url	string	uri	string	الزامی. URI صفحه درباره
status	string	state	enum (ReviewState.State)	فقط خروجی. وضعیت URI. مقادیر احتمالی عبارتند از ACTIVE FAILED RUNNING

برای بررسی نسخه «محتوای Shopping»، به LiaAboutPageSettings مراجعه کنید.

InventoryVerification

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
status	string	state	enum (InventoryVerification.State)	فقط خروجی. وضعیت فرایند درستی‌سنجی فهرست موجودی. مقادیر ممکن عبارتند از ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	الزامی. نام مخاطب برای فرایند درستی‌سنجی فهرست موجودی
inventoryVerificationContactEmail	string	contactEmail	string	الزامی. ایمیل مخاطب برای فرایند درستی‌سنجی موجودی
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	فقط خروجی. وضعیت درستی‌سنجی مخاطب. مقادیر ممکن عبارتند از ACTIVE RUNNING

برای بررسی نسخه «محتوای Shopping»، LiaCountrySettings و LiaInventorySettings را ببینید.

LfpProvider

Shopping Content API		Merchant API
فیلد	تایپ کردن	فیلد	تایپ کردن	شرح
fullName	string	name	string	نام منبع ارائه‌دهنده «برنامه ویترین محلی». قالب: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(موجود نیست)	(موجود نیست)	regionCode	string	الزامی. کد کشور CLDR
providerId	string	(موجود نیست)	(موجود نیست)	این فیلد ازبین می‌رود.
displayName	string	displayName	string	نام نمایشی ارائه‌دهنده «برنامه ویترین محلی»

برای مرور نسخه «محتوای Shopping»، به PosDataProvidersPosDataProvider مراجعه کنید.

GbpAccount

Shopping Content API		Merchant API
Field	Type	فیلد	تایپ کردن	شرح
name	string	name	string	نام منبع حساب «نمایه کسب‌وکار Google» قالب: accounts/{account}/gbpAccount/{gbp_account}
(موجود نیست)	(موجود نیست)	gbpAccountId	string	شناسه نمایه کسب‌وکار
type	string	type	enum (GbpAccount.Type)	نوع نمایه کسب‌وکار. مقادیر دردسترس عبارت‌اند از USER (حساب شخصی) ‫BUSINESS_ACCOUNT (حساب کسب‌وکار)
email	string	gbpAccountName	string	نام نمایه کسب‌وکار: برای حساب‌های شخصی، این شناسه ایمیل مالک است. برای حساب‌های کسب‌وکار، این نام حساب کسب‌وکار است.
listingCount	string	listingCount	int64	تعداد فهرستگان‌های مرتبط با این حساب

برای مرور نسخه «محتوای Shopping»، به GmbAccountsGmbAccount مراجعه کنید.