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