Local Feeds Partnership API

يقدّم "برنامج الشراكة في الخلاصات المحلية" وسيلة يشارك من خلالها بائعو التجزئة في "إعلانات للمنتجات المتوفرة في المتجر" وبيانات المنتجات المحلية المجانية بدون الحاجة إلى إنشاء خلاصات خاصة بهم، سواء كانت خلاصات أساسية أو خلاصات لمستودعات المنتجات داخل المتجر. يمكن لبائعي التجزئة تقديم معلومات المبيعات والمستودع إلى مزوّد بيانات موثوق به يمكنه مشاركة هذه المعلومات مع Google. للاطّلاع على قائمة شركاء البيانات المتوافقين، يُرجى مراجعة المقالة لمحة عن برنامج الشراكة في الخلاصات المحلية.

يمكنك إضافة مستودع المنتجات داخل المتجر من خلال تحميل خلاصة مستودع المنتجات داخل المتجر.

لإضافة مزوّد بيانات المخزون إلى Merchant Center، يُرجى تقديم تفاصيلك في نموذج ملاحظات مزوّد بيانات نقطة البيع لعرض المنتجات المحلية على Google.

للتعرّف على كيفية نقل البيانات من Content API for Shopping، يُرجى الاطّلاع على نقل بيانات شراكة الخلاصات المحلية.

استرداد حالة إعداد بائع التجزئة

يمكنك استخدام طريقة lfpMerchantStates.get لاسترداد حالة المواقع على مستوى التاجر المرتبطة بعملية دمج "برنامج شراكة الخلاصات المحلية". استنادًا إلى السمات المقدَّمة، يمكنك التحقّق مما إذا كان الدمج يعمل على النحو المطلوب أو إذا كان عليك اتّخاذ أي إجراء إضافي.

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

إدراج مستودع

لإدراج مستودع، استخدِم الطلب التالي:

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

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}"
}

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫{PARENT}: التنسيق هو accounts/{ACCOUNT_ID}، حيث يمثّل {ACCOUNT_ID} المعرّف الفريد لحساب Merchant Center.
  • ‫{OFFER_ID}: المعرّف الفريد للمنتج
  • ‫{STORE_CODE}: معرّف متجر التاجر
  • ‫{TARGET_MERCHANT_ID}: رقم تعريف حساب النشاط التجاري الذي تريد إرسال المستودع له

يمكنك توقّع ظهور الردّ التالي:

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

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

إدراج تخفيضات

لإدراج تخفيض، استخدِم الطلب التالي:

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

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGET_MERCHANT_ID}"
}

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫{TARGET_MERCHANT_ID}: رقم تعريف حساب النشاط التجاري المطلوب إرسال عملية البيع له

يمكنك توقّع ظهور الردّ التالي:

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

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

إدراج متجر

لإدراج متجر، استخدِم الطلب التالي:

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

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}"
}

غيِّر القيم في السلسلة على الشكل التالي:

  • {STORE_CODE}: معرّف فريد للمتجر
  • ‫{TARGET_MERCHANT_ID}: رقم تعريف حساب النشاط التجاري الذي تريد إرسال المتجر إليه

يمكنك توقّع ظهور الردّ التالي:

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

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

إرسال إشعار إلى بائع تجزئة

يمكنك استخدام طريقة SendLfpNotification لإرسال إشعار إلى بائع تجزئة. على سبيل المثال، يمكنك استخدام هذه الطريقة لإرسال إشعار إعداد إلى بائع التجزئة.

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫{ACCOUNT_ID}: المعرّف الفريد لحسابك على Merchant Center
  • {TARGETMERCHANT_ID}: المعرّف الفريد للحساب الذي تريد إرسال الإشعار إليه
  • ‫{EMAIL_ADDRESS}: عنوان البريد الإلكتروني للحساب الذي تريد إرسال الإشعار إليه
  • {TYPE}: يمكنك فقط تمرير قيمة السلسلة ONBOARDING_UI في هذا الحقل.