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