ממשק 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": "{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"
}

מידע נוסף זמין במאמר בנושא Method: 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"
}

מידע נוסף זמין במאמר Method: 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.