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

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

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

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

الموارد

بالإضافة إلى ذلك، يختلف سلوك الخدمة بالنسبة إلى 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 (Merchant-Hosted Local Store Front Full)

InStock

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

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

استلام الطلب

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

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

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) لسياسة "معروض للطلب" (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 اسم المورد الخاص بمقدّم خدمة 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.

السابق
Migrate local feeds partnership management
التالي
Migrate online return policy management