نقل الشراكة في الخلاصات المحلية

يمكنك استخدام Merchant API لمشاركة بيانات المستودعات والمتاجر والمبيعات مع Google من أجل تحسين مستوى ظهورها وإدارتها.

الميزات الجديدة

بالإضافة إلى ميزات Content API، توفّر Merchant API الميزات الجديدة التالية:

  • طريقة لاسترداد حالة خصائص على مستوى النشاط التجاري مرتبطة بتكامل "برنامج الشراكة في الخلاصات المحلية"
  • طريقة لإرسال إشعار إلى بائع تجزئة

للاطّلاع على تفاصيل حول هاتَين الطريقتَين، يُرجى مراجعة Local feeds partnership API.

الطلبات

استخدِم تنسيق عنوان URL للطلب التالي في Local feeds partnership API:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.lfpInventories.insert.

في ما يلي نموذج لمقارنة بين Content API for Shopping وLocal feeds partnership API لطلب إدراج مستودع:

Content API Merchant API
عنوان URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
المعرّفات {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

في ما يلي نموذج لمقارنة بين Content API for Shopping وLocal feeds partnership API لطلب إدراج عملية بيع:

Content API Merchant API
عنوان URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert
المعرّفات {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

في ما يلي نموذج لمقارنة بين Content API for Shopping وLocal feeds partnership API لطلب إدراج متجر:

Content API Merchant API
عنوان URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert
المعرّفات {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

الطُرق

في ما يلي التغييرات التي تم إجراؤها على طرق واجهة برمجة التطبيقات للمتجر في Local feeds partnership API:

الطريقة عنوان URL في Content API for Shopping عنوان URL في Merchant API المعرّفات في Content API for Shopping المعرّفات في Merchant API الوصف
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} يكون تنسيق parent هو accounts/{IFP_PARTNER_ACCOUNT_ID}
delete DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} يكون تنسيق name هو accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
get GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} يكون تنسيق name هو accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
list GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores /{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} يكون تنسيق {PARENT} هو accounts/{IFP_PARTNER_ACCOUNT_ID}

في ما يلي التغييرات التي تم إجراؤها على طرق واجهة برمجة التطبيقات للمستودع في Local feeds partnership API:

الطريقة عنوان URL في Content API for Shopping عنوان URL في Merchant API المعرّفات في Content API for Shopping المعرّفات في Merchant API الوصف
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent يكون تنسيق accounts/{IFP_PARTNER_ACCOUNT_ID}

في ما يلي التغييرات التي تم إجراؤها على طرق واجهة برمجة التطبيقات للمبيعات في Local feeds partnership API:

الطريقة عنوان URL في Content API for Shopping عنوان URL في Merchant API المعرّفات في Content API for Shopping المعرّفات في Merchant API الوصف
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} يكون تنسيق {PARENT} هو accounts/{IFP_PARTNER_ACCOUNT_ID}

الموارد

في ما يلي التغييرات التي تم إجراؤها على مورد المتجر في Local feeds partnership API. تبقى الحقول غير المضمّنة هنا بدون تغيير.

Content API for Shopping Merchant API الوصف
غير متاح name: string تمت إضافة حقل جديد للتمييز بين المتاجر المختلفة
غير متاح targetAccount: integer حساب Merchant Center الذي سيتم إدراج المستودعات فيه
targetCountry: string regionCode: string تم تغيير اسم targetCountry إلى regionCode
websiteUrl: string websiteUri: string تم تغيير اسم websiteUrl إلى websiteUri
kind: string غير متاح لا تتوافق Local feeds partnership API مع kind

في ما يلي التغييرات التي تم إجراؤها على إدراج مستودع. تبقى الحقول غير المضمّنة هنا بدون تغيير.

Content API for Shopping Merchant API الوصف
غير متاح name: string تمت إضافة حقل جديد للتمييز بين المستودعات المختلفة
غير متاح targetAccount: integer حساب Merchant Center الذي سيتم إدراج المستودعات فيه
targetCountry: string regionCode: string تم تغيير اسم targetCountry إلى regionCode. رمز المنطقة في CLDR للبلد الذي يُباع فيه المنتج
itemId: string offerId: string تم تغيير اسم itemId إلى offerId
quantity: string quantity: string تم تعديل quantity ليصبح اختياريًا
غير متاح availability: string availability مطلوب

price: {

object (Price)

}

price: {

object (Price)

}

 تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر.
timestamp: string collectionTime: string تم تغيير اسم timestamp إلى collectionTime
kind: string غير متاح لا تتوافق Local feeds partnership API مع kind.

في ما يلي التغييرات التي تم إجراؤها على إدراج عملية بيع. تبقى الحقول غير المضمّنة هنا بدون تغيير.

Content API for Shopping Merchant API الوصف
غير متاح name: string تمت إضافة حقل جديد للتمييز بين المستودعات المختلفة
غير متاح targetAccount:integer حساب Merchant Center الذي سيتم إدراج المبيعات فيه
targetCountry: string regionCode: string رمز المنطقة في CLDR للبلد الذي يُباع فيه المنتج
itemId: string offerId: string تم تغيير اسم itemId إلى offerId

price: {

object (Price)

}

price: {

object (Price)

}

 تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر.
timestamp: string saleTime: string تم تغيير اسم timestamp إلى saleTime
kind: string غير متاح لا تتوافق Local feeds partnership API مع kind.
السابق
Migrate conversion sources management
التالي
Migrate Comparison Shopping Services management