שירות מלאי בחנות מקומית

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

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

דרישות מוקדמות

  • כדי להשתמש בשירות המלאי בחנות מקומית, צריך ליצור פרופיל עסק, לקשר את פרופיל העסק לחשבון Merchant Center, לאמת את העסק ולהגדיר את קודי החנויות של פרופיל העסק.

  • חשבון Merchant Center שלכם צריך להיות רשום לתוכנית מקומית: מודעות מלאי של חנויות מקומיות בפלטפורמות השונות של Google או מודעות מלאי של חנויות מקומיות. במאמר תחילת העבודה עם מודעות מלאי של חנויות מקומיות מפורט מידע נוסף על השימוש במודעות מלאי של חנויות מקומיות דרך Content API.

  • שירות המלאי בחנות מקומית יוצר מופעים של מלאי בחנות מקומית למוצרים קיימים בחנויות מקומיות. קודם צריך ליצור מוצרים בחנויות מקומיות באמצעות שירות products של Content API או datafeeds ב-Merchant Center, על ידי הגדרת השדה channel ל-local. לאחר מכן תוכלו להשתמש בשירות המלאי בחנות מקומית כדי ליצור מופעים של מלאי בחנות מקומית לכל פרופיל עסק storecode שבו המוצר נמכר.

שדות

כל מופע של מלאי בחנות מקומית מכיל קבוצה של שדות שמשויכים למיקום ספציפי של חנות באמצעות השדה storeCode (שמוגדר בפרופיל העסק). בכל הבקשות נדרשים רק storecode ו-productId. כל שאר השדות הם אופציונליים:

  • חובה לכל הבקשות: storeCode, productId (בכתובת ה-URL)
  • אופציונלי: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla, instoreProductLocation

רשימה מלאה של השדות של המלאי בחנות המקומית והתיאורים שלהם מופיעה בדף העזר של מלאי בחנות מקומית.

שיטות

שירות המלאי בחנות מקומית כולל רק שתי שיטות:

localinventory.insert

localinventory.insert מאפשר ליצור מופע של מלאי בחנות מקומית למוצר אחד בחנות מקומית.

הדוגמה הזו ממחישה איך להשתמש בשירות מלאי בחנות מקומית כדי ליצור מבצע בחנות מ-24 בפברואר 2021 בשעה 13:00 (GMT-8) ועד 28 בפברואר 2021 בשעה 15:30 (GMT-8). הבקשה גם מעדכנת את הכמות שזמינה במכונה של המלאי בחנות המקומית. בניגוד לפידים משלימים לנתוני מוצרים שאינם מקומיים, שדות שלא כלולים בגוף הבקשה יוחלפו בקריאה הבאה:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

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