يمكنك استخدام Merchant API لمشاركة بيانات المستودعات والمتاجر والمبيعات مع Google من أجل تحسين الظهور والإدارة.
الميزات الجديدة
بالإضافة إلى ميزات Content API، تقدّم Merchant API الميزات الجديدة التالية:
- طريقة لاسترداد حالة خصائص على مستوى النشاط التجاري مرتبطة بدمج "برنامج الشراكة في الخلاصات المحلية"
- طريقة لإرسال إشعار إلى بائع تجزئة
للحصول على تفاصيل حول هذه الطرق، يُرجى الاطّلاع على Local Feeds Partnership 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} |
في ما يلي التغييرات التي تم إجراؤها على طرق واجهة برمجة التطبيقات الخاصة بالمستودع في واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية:
| الطريقة | عنوان 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 مطلوب |
|
|
تم تغيير تعريف السعر. لمزيد من المعلومات، اطّلِع على السعر. |
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 |
|
|
تم تغيير تعريف السعر. لمزيد من المعلومات، اطّلِع على السعر. |
timestamp: string |
saleTime: string |
تمت إعادة تسمية timestamp ليصبح saleTime |
kind: string |
غير متاح | لا تتوافق kind مع واجهة برمجة التطبيقات الخاصة ببرنامج الشراكة في الخلاصات المحلية. |