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

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