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