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

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