Local Feeds Partnership API

התוכנית לשותפות בפידים מקומיים מאפשרת לקמעונאים להשתתף במודעות מלאי של חנויות מקומיות ובכרטיסים חינמיים למוצרים מקומיים בלי שיצטרכו ליצור בעצמם פיד ראשי ופיד מלאי המוצרים בחנויות המקומיות. קמעונאים יכולים לספק את נתוני המכירות והמלאי שלהם לספק נתונים מהימן, שיכול לשתף את המידע הזה עם Google. רשימת שותפי הנתונים הנתמכים מופיעה במאמר מידע על התוכנית לספקי ניהול פידים עבור חנויות מקומיות.

כדי להוסיף מלאי מוצרים בחנויות מקומיות, אתם יכולים להעלות פיד מלאי המוצרים בחנויות המקומיות.

כדי להוסיף את ספק נתוני המלאי שלכם ל-Merchant Center, אתם צריכים למלא את הפרטים שלכם בטופס משוב על ספק נתונים של נקודות מכירה להצגת מוצרים בחנויות מקומיות ב-Google.

למידע ולמידה על המיגרציה מ-Content API for Shopping, ראו Migrate Local Feeds Partnership.

אחזור סטטוס ההצטרפות של קמעונאי

אתם יכולים להשתמש ב-method‏ lfpMerchantStates.get כדי לאחזר את המצב של המאפיינים ברמת המוכר שקשורים לשילוב של Local Feeds Partnership. על סמך המאפיינים שסופקו, אתם יכולים לבדוק אם השילוב פועל כמו שצריך או אם נדרשת פעולה נוספת.

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"
}

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

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

שליחת התראה לקמעונאי

אתם יכולים להשתמש ב-method‏ 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 בשדה הזה.