ממשק 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 method כדי לשלוח התראה לקמעונאי. לדוגמה, אפשר להשתמש בשיטה הזו כדי לשלוח לקמעונאי התראה על צירוף.

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.