يمكنك استخدام Merchant API لمشاركة مستودعاتك ومتاجرك وبيانات المبيعات مع Google لتحسين مستوى العرض والإدارة.
الميزات الجديدة
بالإضافة إلى ميزات Content API، تقدّم Merchant API ميزات جديدة التالية:
- طريقة لاسترداد حالة المواقع على مستوى التاجر ذات الصلة بتكامل برنامج الشراكة في الخلاصات المحلية
- طريقة لإرسال إشعار إلى بائع تجزئة
ولمزيد من التفاصيل حول هاتَين الطُرق، يُرجى الاطّلاع على واجهة برمجة التطبيقات الخاصة بالشراكة في الخلاصات المحلية.
الطلبات
استخدِم تنسيق عنوان URL للطلب التالي لواجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.lfpInventories.insert.
في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات الخاصة بالخلاصات المحلية partnership API لطلب إدراج مستودع:
| Content API | Merchant API | |
| عنوان URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
|
| المعرفات |
{merchantId}/pos/{targetMerchantId}
|
{parent} |
في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات الخاصة بالخلاصات المحلية partnership API لطلب إدراج تخفيضات:
| Content API | Merchant API | |
| عنوان URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
| المعرفات | {merchantId}/pos/{targetMerchantId} |
{parent} |
في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات الخاصة بالخلاصات المحلية partnership API لطلب إدراج متجر:
| Content API | Merchant API | |
| عنوان URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert |
| المعرفات | {merchantId}/pos/{targetMerchantId} |
{parent} |
الطُرق
في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات الخاصة بالمتجر في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية:
| الطريقة | عنوان URL في Content API for Shopping | عنوان URL في Merchant API | المعرّفات في Content API for Shopping | المعرّفات في Merchant API | الوصف |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent بتنسيق accounts/{lfpPartnerAccountId} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name بتنسيق accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name بتنسيق accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores |
/{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} بتنسيق accounts/{lfpPartnerAccountId} |
في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات الخاصة بالمستودع في واجهة برمجة التطبيقات الخاصة بالشراكة في الخلاصات المحلية:
| الطريقة | عنوان URL في Content API for Shopping | عنوان URL في Merchant API | المعرّفات في Content API for Shopping | المعرّفات في Merchant API | الوصف |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent بالتنسيق accounts/{lfpPartnerAccountId} |
في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات Sales API في واجهة برمجة التطبيقات API للشراكة في الخلاصات المحلية:
| الطريقة | عنوان URL في Content API for Shopping | عنوان URL في Merchant API | المعرّفات في Content API for Shopping | المعرّفات في Merchant API | الوصف |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} بتنسيق accounts/{lfpPartnerAccountId} |
الموارد
في ما يلي التغييرات التي تم إجراؤها على مورد المتجر في واجهة برمجة التطبيقات الخاصة بالشراكة في الخلاصات المحلية. إنّ الحقول غير المضمّنة هنا لن تتغيّر.
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
| غير متاح | name: string |
تمت إضافة حقل جديد للتمييز بين المتاجر المختلفة |
| غير متاح | targetAccount: integer |
حساب التاجر الذي تريد إدراج المستودعات له |
targetCountry: string |
regionCode: string |
تمت إعادة تسمية targetCountry ليصبح regionCode. |
websiteUrl: string |
websiteUri: string |
تمت إعادة تسمية websiteUrl ليصبح websiteUri. |
kind: string |
غير متاح | kind غير متوافقة مع واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية |
في ما يلي التغييرات التي تم إجراؤها عند إدراج مستودع. الحقول غير المضمنة هنا لا تتغير.
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
| غير متاح | name: string |
تمت إضافة حقل جديد للتمييز بين المستودعات المختلفة |
| غير متاح | targetAccount: integer |
حساب التاجر الذي تريد إدراج المستودعات له |
targetCountry: string |
regionCode: string |
تمت إعادة تسمية targetCountry إلى regionCode. رمز منطقة CLDR للبلد الذي يُباع فيه المنتج |
itemId: string |
offerId: string |
تمت إعادة تسمية "itemId" إلى "offerId". |
quantity: string |
quantity: string |
تم تعديل quantity ليكون اختياريًا. |
| غير متاح | availability: string |
availability مطلوب |
|
|
تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر. |
timestamp: string |
collectionTime: string |
تمت إعادة تسمية timestamp ليصبح collectionTime. |
kind: string |
غير متاح | kind غير متوافقة مع واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. |
في ما يلي التغييرات التي طرأت على إدراج تخفيضات. إنّ الحقول غير المضمّنة هنا لم تتغيّر.
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
| غير متاح | name: string |
تمت إضافة حقل جديد للتمييز بين المستودعات المختلفة |
| غير متاح | targetAccount:integer |
حساب التاجر الذي تريد إدراج المبيعات له |
targetCountry: string |
regionCode: string |
رمز منطقة CLDR للبلد الذي يُباع فيه المنتج |
itemId: string |
offerId: string |
تمت إعادة تسمية itemId ليصبح offerId. |
|
|
تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر. |
timestamp: string |
saleTime: string |
تمت إعادة تسمية "timestamp" إلى "saleTime". |
kind: string |
غير متاح | لا يمكن استخدام السمة kind في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. |