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

يمكنك استخدام Merchant API لمشاركة بيانات المستودعات والمتاجر والمبيعات مع Google من أجل تحسين إمكانية ظهورها وإدارتها.

الميزات الجديدة

بالإضافة إلى ميزات Content API، يقدّم Merchant API الميزات الجديدة التالية:

• طريقة لاسترداد حالة الخصائص على مستوى النشاط التجاري المرتبطة بتكامل "برنامج الشراكة في الخلاصات المحلية"
• طريقة لإرسال إشعار إلى بائع تجزئة

للاطّلاع على تفاصيل هاتَين الطريقتَين، يُرجى مراجعة Local feeds partnership API.

الطلبات

استخدِم تنسيق عنوان URL للطلب التالي في Local feeds partnership API:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

لمزيد من المعلومات، يُرجى الاطّلاع على الطريقة: accounts.lfpInventories.insert.

في ما يلي نموذج مقارنة بين Content API for Shopping وLocal feeds 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/v1/{PARENT}/lfpInventories:insert
المعرّفات	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

في ما يلي نموذج مقارنة بين Content API for Shopping وLocal feeds 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/v1/{PARENT}/lfpSales:insert
المعرّفات	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

في ما يلي نموذج مقارنة بين Content API for Shopping وLocal feeds 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/v1/{PARENT}/lfpStores:insert
المعرّفات	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

الطُرق

في ما يلي التغييرات التي تم إجراؤها على طرق Store API في Local feeds partnership 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/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}

في ما يلي التغييرات التي تم إجراؤها على طرق Inventory API في Local feeds partnership 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/v1/{PARENT}/lfpInventories:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	parent يكون تنسيق accounts/{IFP_PARTNER_ACCOUNT_ID}

في ما يلي التغييرات التي تم إجراؤها على طرق Sales API في Local feeds partnership 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/v1/{PARENT}/lfpSales:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	يكون تنسيق {PARENT} هو accounts/{IFP_PARTNER_ACCOUNT_ID}

الموارد

في ما يلي التغييرات التي تم إجراؤها على مورد المتجر في Local feeds partnership API. لم يتم تغيير الحقول غير المضمّنة هنا.

Content API for Shopping	Merchant API	الوصف
غير متاح	name: string	تمت إضافة حقل جديد للتمييز بين المتاجر المختلفة
غير متاح	targetAccount: integer	حساب Merchant Center الذي سيتم إدراج المستودعات فيه
targetCountry: string	regionCode: string	تم تغيير اسم targetCountry إلى regionCode
websiteUrl: string	websiteUri: string	تم تغيير اسم websiteUrl إلى websiteUri
kind: string	غير متاح	لا تتوافق Local feeds partnership API مع kind

في ما يلي التغييرات التي تم إجراؤها على إدراج مستودع. لم يتم تغيير الحقول غير المضمّنة هنا.

Content API for 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	غير متاح	لا تتوافق Local feeds partnership API مع kind.

في ما يلي التغييرات التي تم إجراؤها على إدراج عملية بيع. لم يتم تغيير الحقول غير المضمّنة هنا.

Content API for 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	غير متاح	لا تتوافق Local feeds partnership API مع kind.