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