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

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

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

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

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

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

    local

  • שירות המלאי בחנות המקומית יוצר מופעים של מלאי בחנות מקומית עבור מוצרים קיימים בחנות מקומית. תחילה צריך ליצור מוצרים בחנויות מקומיות באמצעות שירות המוצרים של 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 אפשר ליצור כמה מופעים של מלאי בחנות מקומית עבור מוצר יחיד בחנות מקומית בכמה חנויות, או ליצור מופעים של מלאי בחנות מקומית לכמה מוצרים בחנויות מקומיות.