يمكنك استخدام Merchant API لمشاركة بيانات المستودع والمتاجر وبيانات المبيعات. مع Google للحصول على إمكانية وصول وإدارة أفضل.
الطلبات
استخدِم تنسيق عنوان URL التالي للطلب في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.lfpInventories.insert.
إليك نموذج مقارنة بين Content API for Shopping والخلاصات المحلّية. واجهة برمجة تطبيقات الشراكة لطلب إدراج مستودع:
| Content 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 والخلاصات المحلّية. واجهة برمجة تطبيقات الشراكة لطلب إدخال عملية بيع:
| Content 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 والخلاصات المحلّية. واجهة برمجة تطبيقات الشراكة لطلب إدراج متجر:
| Content 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} |
الطُرق
في ما يلي التغييرات التي طرأت على طُرق Store 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=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 في الشراكة في الخلاصات المحلية واجهة برمجة التطبيقات:
| الطريقة | عنوان 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 | واجهة برمجة تطبيقات التاجر | الوصف |
| غير متاح | name: string |
تمت إضافة حقل جديد للتمييز بين المتاجر المختلفة. |
| غير متاح | targetAccount: integer |
حساب التاجر المطلوب إدراج المستودعات الخاصة به |
targetCountry: string |
regionCode: string |
تمت إعادة تسمية "targetCountry" إلى "regionCode". |
websiteUrl: string |
websiteUri: string |
تمت إعادة تسمية "websiteUrl" إلى "websiteUri". |
kind: string |
غير متاح | السمة kind غير متاحة في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. |
في ما يلي التغييرات التي تم إجراؤها عند إدراج مستودع. الحقول غير المضمّنة هنا هي: دون تغيير.
| واجهة برمجة تطبيقات المحتوى في Shopping | واجهة برمجة تطبيقات التاجر | الوصف |
| غير متاح | 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 | واجهة برمجة تطبيقات التاجر | الوصف |
| غير متاح | name: string |
إضافة حقل جديد للتمييز بين المستودعات المختلفة |
| غير متاح | targetAccount:integer |
حساب التاجر المطلوب إدراج مبيعات له |
targetCountry: string |
regionCode: string |
رمز CLDR للمنطقة للبلد الذي يتم بيع المنتج فيه. |
itemId: string |
offerId: string |
تمت إعادة تسمية "itemId" إلى "offerId". |
|
|
تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر. |
timestamp: string |
saleTime: string |
تمت إعادة تسمية "timestamp" إلى "saleTime". |
kind: string |
غير متاح | لا يمكن استخدام السمة kind في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. |