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

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

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

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

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

للحصول على تفاصيل حول هذه الطرق، يُرجى الاطّلاع على واجهة برمجة التطبيقات لبرنامج الشراكة في الخلاصات المحلية.

الطلبات

استخدِم تنسيق عنوان URL التالي لطلب البيانات من واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية:

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

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

في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات للشراكة في الخلاصات المحلية لطلب إدراج مستودع:

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 وواجهة برمجة التطبيقات للشراكة في الخلاصات المحلية لطلب إدراج عملية بيع:

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 وواجهة برمجة التطبيقات للشراكة في الخلاصات المحلية لطلب إدراج متجر:

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}

الطُرق

في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات الخاصة بالمتجر في واجهة برمجة التطبيقات لبرنامج الشراكة في الخلاصات المحلية:

الطريقة عنوان 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}

في ما يلي التغييرات التي تم إجراؤها على طرق Inventory 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}

في ما يلي التغييرات التي تم إجراؤها على طرق واجهة برمجة التطبيقات الخاصة بالمبيعات في واجهة برمجة التطبيقات الخاصة بالشراكة في الخلاصات المحلية:

الطريقة عنوان 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}

الموارد

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

واجهة برمجة تطبيقات المحتوى في Shopping Merchant API الوصف
غير متاح name: string تمت إضافة حقل جديد للتمييز بين المتاجر المختلفة
غير متاح targetAccount: integer حساب Merchant Center المطلوب إدراج المستودعات فيه
targetCountry: string regionCode: string تم تغيير اسم "targetCountry" إلى "regionCode"
websiteUrl: string websiteUri: string تم تغيير اسم "websiteUrl" إلى "websiteUri"
kind: string غير متاح ‫"kind" غير متوافقة مع واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية

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

واجهة برمجة تطبيقات المحتوى في 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 غير متاح لا يمكن استخدام السمة kind في واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية.

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

واجهة برمجة تطبيقات المحتوى في 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 غير متاح لا يمكن استخدام السمة kind في واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية.
السابق
Migrate conversion sources management
التالي
Migrate Comparison Shopping Services management