تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نقل الشراكة في الخلاصات المحلية

يمكنك استخدام 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory`	`POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert`
المعرفات	`{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}`	`{PARENT}`

في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات الخاصة بالخلاصات المحلية partnership API لطلب إدراج تخفيضات:

	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/v1beta/{PARENT}/lfpSales:insert`
المعرفات	`{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}`	`{PARENT}`

في ما يلي نموذج مقارنة بين Content API for Shopping وواجهة برمجة التطبيقات الخاصة بالخلاصات المحلية partnership API لطلب إدراج متجر:

	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/v1beta/{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/v1beta/`{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/v1beta/`{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/v1beta/`{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/v1beta/`{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/v1beta/{PARENT}/lfpInventories:insert`	`{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}`	`{PARENT}`	`parent` بتنسيق `accounts/{IFP_PARTNER_ACCOUNT_ID}`

في ما يلي التغييرات التي طرأت على طرق واجهة برمجة التطبيقات 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store`	`POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert`	`{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}`	`{PARENT}`	`{PARENT}` بتنسيق `accounts/{IFP_PARTNER_ACCOUNT_ID}`

الموارد

في ما يلي التغييرات التي طرأت على مورد المتجر في واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية. إنّ الحقول غير المضمّنة هنا لن تتغيّر.

واجهة برمجة تطبيقات المحتوى في 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` مطلوب
`price: { object (Price) }`	`price: { object (Price) }`	تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر.
`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`.
`price: { object (Price) }`	`price: { object (Price) }`	تم تغيير تعريف السعر. لمزيد من المعلومات، يُرجى الاطّلاع على السعر.
`timestamp: string`	`saleTime: string`	تمت إعادة تسمية `timestamp` ليصبح `saleTime`.
`kind: string`	غير متاح	‫`kind` غير متوافقة مع واجهة برمجة التطبيقات للشراكة في الخلاصات المحلية.

نقل بيانات إدارة إعداد التقارير

الوصول إلى حسابات العملاء