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

إذا كنت قد استخدمت إعدادات إعلانات للمنتجات داخل المتجر ضمن واجهة برمجة التطبيقات Content API في Shopping، هناك العديد من التغييرات المهمة في 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

الموارد

بالإضافة إلى ذلك، يختلف سلوك الخدمة في ما يتعلق بالسمة PickupType. راجِع مقالة استلام الطلب.

OmnichannelSetting

Shopping Content API Merchant API
الحقل النوع الحقل النوع الوصف
(غير متوفّر) (غير متوفّر) name string اسم المورد الخاص بإعداد قناة التسويق الشاملة هذا. التنسيق:
التنسيق: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string مطلوب. الرمز البريدي لبلد ملف Common Locale Data Repository (CLDR) (على سبيل المثال، "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) مطلوب. نوع Local Store Front (LSF) لهذا regionCode. وتشمل القيم المحتمَلة ما يلي:
  • GHLSF (واجهة محل مجاور تستضيفها Google)
  • MHLSF_BASIC (واجهة محلّ مجاور يستضيفها تاجر (أساسية)، والتي تشير إلى صفحات المنتجات مع عرض معلومات التوفّر في المتجر)
  • MHLSF_FULL (واجهة محلّ مجاور يستضيفها تاجر (كاملة)، ويشير ذلك إلى صفحات المنتجات مع عرض التوفّر في المتجر)
(غير متوفّر) (غير متوفّر) inStock object
(InStock)		 معرّف الموارد المنتظم (URI) لصفحة المنتج المتوفّر وحالة عرض هذا regionCode. اضبط أحد عنصرَي inStock أو pickup على الأقل في create API إذا اخترت أحد أنواع MHLSF، ولكن اضبط inStock فقط إذا كان lsfType هو GHLSF.
storePickupActive boolean pickup object
(Pickup)		 معرّف الموارد المنتظم لصفحة المنتج الذي سيتم استلامه وحالة العرض لهذا regionCode. اضبط عنصرًا واحدًا على الأقل من inStock أو Pickup في create API إذا اخترت أحد أنواع MHLSF، ولكن لا تضبطه عند ضبط GHLSF على أنّه lsfType.
posDataProvider object
(LiaPosDataProvider)		 lfpLink object
(LfpLink)		 النتائج فقط. الرابط الذي تم إنشاؤه مع مقدّم خدمة LFP
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)		 odo object
(OnDisplayToOrder)		 عنوان URL لسياسة "معروض للطلب" وحالتها 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) نوع واجهة المحل المجاور القيم المحتمَلة هي:
  • GHLSF (واجهة محل مجاور تستضيفها Google)
  • MHLSF_BASIC (واجهة محلّ مجاور يستضيفها تاجر (أساسية))
  • MHLSF_FULL (واجهة محلّ مجاور يستضيفها تاجر (كاملة))

InStock

Shopping Content API Merchant API
الحقل النوع الحقل النوع الوصف
(غير متوفّر) (غير متوفّر) uri string معرّف الموارد المنتظم للصفحة المقصودة الخاصة بالمنتج. مطلوب إذا اخترت أحد أنواع MHLSF. مطلوبة إذا تم ضبط العنصر. بالنسبة إلى GHLSF، يجب أن يكون الحقل فارغًا، ولكن يجب ألا يكون فارغًا بالنسبة إلى MHLSF. لا تستخدم الخدمة هذه البيانات إلا لأجل التحقّق من عرض المنتجات المتوفّرة. يجب أن يتطابق نطاق معرّف الموارد المنتظم (URI) هذا مع الصفحة الرئيسية للتاجر.
(غير متوفّر) (غير متوفّر) 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، يُرجى الاطّلاع على 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 مطلوب. عنوان URL الخاص بالصفحة "لمحة"
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، اطّلِع على 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.

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