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

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

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

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

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

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

שדות

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

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

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

Methods

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

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