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

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

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

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

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

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

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

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

إدراج مستودع

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

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

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

{
 "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/v1beta/{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}"
}

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

{
 "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/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{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/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

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

• {accountId}: المعرّف الفريد لحسابك على Merchant Center
• {targetMerchantId}: المعرّف الفريد للحساب الذي تريد إرسال الإشعار إليه
• {emailAddress}: عنوان البريد الإلكتروني للحساب الذي تريد إرسال الإشعار إليه
• {Type}: يمكنك فقط تمرير قيمة السلسلة ONBOARDING_UI في هذا الحقل.