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

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

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

المكوّن الأساسي	المرجع
إعداد الحساب لعرض الإعلانات على قنوات التسويق الشاملة	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. يجب ضبط عنصر واحد على الأقل من عناصر 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

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

لمراجعة إصدار محتوى تسوّق، يُرجى الاطّلاع على LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Merchant API
الحقل	النوع	الحقل	النوع	الوصف
shippingCostPolicyUrl	string	uri	string	الحقل مطلوب. معرّف الموارد المنتظم (URI) لسياسة "معروض للطلب" (ODO)
status	string	state	enum (ReviewState.State)	للعرض فقط. حالة معرّف الموارد المنتظم (URI) القيم المحتمَلة هي ACTIVE FAILED RUNNING

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

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

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