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

إذا كنت تستخدم إعدادات "الإعلانات للمنتجات المتوفرة في المتجر" ضمن 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، يجب أن يكون غير فارغ. تستخدم الخدمة هذه البيانات فقط لمراجعة عرض المنتجات المتوفرة في المستودع. يجب أن يتطابق نطاق معرّف الموارد المنتظم (URI) هذا مع الصفحة الرئيسية للتاجر.
(غير متوفر)	(غير متوفر)	state	enum (ReviewState.State)	هذه السمة مخصّصة للإخراج فقط، وهي تعرض حالة العرض عندما يكون المنتج متوفّرًا. القيم المتاحة هي ACTIVE FAILED RUNNING ACTION_REQUIRED

لمراجعة إصدار "محتوى Shopping"، اطّلِع على LiaCountrySettings و LiaOmnichannelExperience.

استلام الطلب

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

لمراجعة إصدار "محتوى Shopping"، اطّلِع على 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"، يُرجى الاطّلاع على LiaPosDataProvider.

OnDisplayToOrder

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

لمراجعة إصدار "محتوى التسوّق"، يُرجى الاطّلاع على 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	اسم المورد الخاص بمقدّم خدمة LFP التنسيق: 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.