يمكنك استخدام Merchant API لمشاركة بيانات المخزون والمتاجر والمبيعات مع Google لتحسين أذونات الوصول وإدارتها.
طلبات
استخدِم التنسيق التالي لعنوان URL للطلب في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/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 في واجهة برمجة التطبيقات الخاصة بالشراكة في الخلاصات المحلية:
| الطريقة | عنوان 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}. |
في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات للمبيعات في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية:
| الطريقة | عنوان 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 في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. |