نقل إعدادات إعلانات المنتجات داخل المتجر

إذا كنت تستخدم إعدادات "الإعلانات للمنتجات المتوفرة في المتجر" ضمن Shopping Content API، ستطرأ عدة تغييرات مهمة عند استخدام Merchant API.

تنتمي إعدادات LIA الآن إلى أحد المكوّنات الأساسية الثلاثة، ولكل منها مرجع مرتبط.

المكوّن الأساسي	المرجع
إعدادات الحساب لعرض الإعلانات على قنوات التسويق الشاملة	OmnichannelSetting
الربط بشريك برنامج الشراكة في الخلاصات المحلية (LFP) للحصول على بيانات المستودع	LfpProvider
الربط بحساب الملف التجاري على Google للحصول على بيانات المتاجر المحلية	GbpAccount

بالإضافة إلى ذلك، كانت إعدادات LIA تتضمّن مرجعًا واحدًا لكل حساب، وكان هذا المرجع يحتوي على قائمة بالإعدادات لكل كيان وطني. باستخدام OmnichannelSettings، يمكنك ربط عدّة مراجع بحساب. يمثّل كل مصدر إعدادات جهة وطنية معيّنة.

في ما يلي التغييرات التي طرأت على الطلبات والموارد.

الطلبات

نطاق جديد	اسم طريقة Content API	اسم طريقة Merchant API
accounts.omnichannelSettings	liasettings.custombatch	سيتم إيقاف هذه الطريقة. تتيح Merchant API إمكانية إرسال طلبات متعددة في الوقت نفسه.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	لم تعُد تتوفّر طريقة مباشرة للحصول على جميع إعدادات إعلانات للمنتجات داخل المتجر (LIA) لجميع الحسابات الفرعية. بدلاً من ذلك، استعلم عن جميع الحسابات الفرعية واستخدِم 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. اضبط عنصرًا واحدًا على الأقل من العنصرين inStock أو pickup في واجهة برمجة التطبيقات الخاصة بالإنشاء إذا اخترت أحد أنواع MHLSF، ولكن اضبط inStock فقط إذا كان lsfType هو GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	تمثّل هذه السمة معرّف الموارد المنتظم (URI) لصفحة المنتج الذي سيتم استلامه وحالة العرض الخاصة به regionCode. اضبط عنصرًا واحدًا على الأقل من عناصر inStock أو Pickup في واجهة برمجة التطبيقات الخاصة بالإنشاء إذا اخترت أحد أنواع MHLSF، ولكن لا تضبطه عندما يتم ضبط GHLSF كـ lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	النتائج فقط. الرابط الذي تم إنشاؤه مع مقدّم خدمة LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	عنوان URI الخاص بسياسة "معروض للطلب" (ODO) وحالته لهذا regionCode
about	object (LiaAboutPageSettings)	about	object (About)	معرّف الموارد المنتظم (URI) وحالة صفحة "لمحة" الخاصة بـ 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	تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصفحة المقصودة الخاصة بالمنتج. يجب توفير هذه السمة إذا اخترت أحد أنواع MHLSF. مطلوبة في حال ضبط العنصر. بالنسبة إلى GHLSF، يجب أن يكون الحقل فارغًا، ولكن بالنسبة إلى MHLSF، يجب ألا يكون فارغًا. وتستخدمه الخدمة فقط لمراجعة عرض المنتجات المتوفرة في المستودع. يجب أن يتطابق نطاق معرّف الموارد المنتظم هذا مع الصفحة الرئيسية للتاجر.
(غير متوفر)	(غير متوفر)	state	enum (ReviewState.State)	النتائج فقط. تمثّل هذه السمة حالة عرض الإعلانات التي تتضمّن منتجات متوفّرة. القيم المتاحة هي ACTIVE FAILED RUNNING ACTION_REQUIRED

لمراجعة إصدار "محتوى التسوّق"، يمكنك الاطّلاع على LiaCountrySettings و LiaOmnichannelExperience.

استلام الطلب

Shopping Content API		Merchant API
الحقل	النوع	الحقل	النوع	الوصف
(غير متوفر)	(غير متوفر)	uri	string	معرّف الموارد المنتظم (URI) لصفحة المنتج الذي سيتم استلامه مطلوبة في حال ضبط العنصر. تستخدم واجهة برمجة التطبيقات هذه البيانات فقط لمراجعة عملية عرض خيار الاستلام. يجب أن يتطابق نطاق معرّف الموارد المنتظم (URI) هذا مع الصفحة الرئيسية للتاجر.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	النتائج فقط. حالة عرض نقاط استلام الطلبات القيم المتاحة هي ACTIVE FAILED RUNNING

لمراجعة إصدار "محتوى التسوّق"، يمكنك الاطّلاع على LiaCountrySettings و LiaOmnichannelExperience.

LfpLink

Shopping Content API		Merchant API
الحقل	النوع	الحقل	النوع	الوصف
posDataProviderId	string	lfpProvider	string	الحقل مطلوب. اسم المورد الخاص بموفّر LFP
posExternalAccountId	string	externalAccountId	string	الحقل مطلوب. معرّف الحساب الذي يعرفه موفّر خدمة LFP لهذا التاجر
(غير متوفر)	(غير متوفر)	state	enum (ReviewState.State)	النتائج فقط. تمثّل هذه السمة حالة LfpLink. القيم المتاحة هي ACTIVE RUNNING

لمراجعة إصدار Shopping Content، يُرجى الاطّلاع على LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Merchant API
الحقل	النوع	الحقل	النوع	الوصف
shippingCostPolicyUrl	string	uri	string	الحقل مطلوب. معرّف الموارد المنتظم (URI) لسياسة "معروض للطلب"
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 Content، اطّلِع على 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	الاسم المعروض لمقدّم خدمة LFP

لمراجعة إصدار Shopping Content، يُرجى الاطّلاع على 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 Content، يُرجى الاطّلاع على GmbAccountsGmbAccount.