ממשק API של שותפות עם פידים של חנויות מקומיות

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

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

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

מידע על ההעברה מ-Content API for Shopping זמין במאמר העברת שותפות של פידים מקומיים.

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

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

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

הוספת מלאי

כדי להוסיף מלאי, משתמשים בבקשה הבאה:

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

התגובה הצפויה היא:

{
 "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/v1beta/{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}"
}

התגובה הצפויה תהיה:

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

מידע נוסף זמין במאמר שיטה: accounts.lfpSales.insert

הוספת חנות

כדי להוסיף חנות, משתמשים בבקשה הבאה:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{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"
}

מידע נוסף זמין במאמר Method: accounts.lfpStores.insert.

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

אפשר להשתמש בשיטה SendLfpNotification כדי לשלוח התראה לקמעונאי. לדוגמה, אפשר להשתמש בשיטה הזו כדי לשלוח התראה לקמעונאי על תחילת תהליך ההצטרפות.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

מחליפים את מה שכתוב בשדות הבאים:

  • {accountId}: המזהה הייחודי של חשבון Merchant Center
  • {targetMerchantId}: המזהה הייחודי של החשבון שאליו רוצים לשלוח את ההתראה
  • {emailAddress}: כתובת האימייל של החשבון שאליו רוצים לשלוח את ההתראה
  • {Type}: אפשר להעביר בשדה הזה רק את ערך המחרוזת ONBOARDING_UI