واجهة برمجة تطبيقات الشراكة في الخلاصات المحلية

يسمح "برنامج الشراكة في الخلاصات المحلية" لبائعي التجزئة بالمشاركة في إعلانات للمنتجات داخل المتجر وبيانات المنتجات المحلية المجانية بدون الحاجة إلى إنشاء خلاصات خاصة بهم، سواء كانت خلاصات أساسية أو خلاصات لمستودعات المنتجات داخل المتجر. يمكن لبائعي التجزئة تقديم معلومات المبيعات والمستودع إلى مزوّد بيانات موثوق به يمكنه مشاركة هذه المعلومات مع 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": "{TARGETMERCHANT_ID}"
}

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

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

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

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_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": "{TARGETMERCHANT_ID}"
}

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

  • {TARGETMERCHANT_ID}: معرّف الحساب الخاص بالنشاط التجاري الذي سيتم إرسال بيانات البيع إليه.

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

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_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": "{TARGETMERCHANT_ID}"
}

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

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

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

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "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 في هذا الحقل فقط.