אתם יכולים להשתמש ב-Merchant API כדי לנהל מלאי מקומי (בחנות) ומלאי אזורי.
בקשות
משתמשים בפורמט הבא של כתובת URL לבקשה עבור Merchant Inventories API:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT} יהיה בפורמט: accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}.
הנה דוגמה להשוואה של בקשות מלאי של חנויות מקומיות:
| פריט | Content API for Shopping | Merchant API |
|---|---|---|
| כתובת URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories |
| מזהים | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
Methods
ב-Merchant API יש שתי שיטות חדשות לניהול מלאי שטחי פרסום:
-
list: מאפשרת לכם להציג רשימה של מלאי מוצרים בחנויות מקומיות ובאזורים. -
delete: מאפשר למחוק מלאי של מוצרים בחנויות מקומיות ובאזורים.
הנה השוואה בין השיטות הזמינות לניהול מלאי שטחי הפרסום:
| שיטה | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
כן | לא |
insert |
כן | כן |
list |
לא | כן |
delete |
לא | כן |
משאבים
אלה השינויים שחלים על מלאי מקומי ואזורי:
| Content API for Shopping | Merchant API | תיאור |
|---|---|---|
| אפשרות לא נתמכת | name:string
|
השדה מבדיל בין משאבי LocalInventory לבין משאבי RegionalInventory בתוך product. ב-Content API for Shopping, מלאי בחנויות מקומיות מזוהה באמצעות storeCode ו-productId, ומלאי אזורי מזוהה באמצעות regionId ו-productId.
|
| אפשרות לא נתמכת | account:string
|
הוספנו שדה חדש לזיהוי החשבון ב-Merchant Center שאליו שייכים product ו-LocalInventory.
|
price: {
object (Price)
}
|
price: {
|
ההגדרה של Price השתנתה.
|
salePrice: {
|
salePrice: {
|
ההגדרה של Price השתנתה.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate משתמש באובייקט TimePeriod החדש ב-Merchant Inventories API.
|
kind:string
|
אפשרות לא נתמכת | ה-API לא תומך ב-kind.
|
quantity:string
|
quantity:integer
|
במקום מחרוזת, המערכת מקבלת מספר שלם quantity במלאי בחנות המקומית.
|
| אפשרות לא נתמכת | localShippingLabel:string
|
נוסף שדה חדש לזיהוי החשבון ב-Merchant Center שאליו שייכים product ו-regionalInventory.
|
"regionId": string
|
"region": string
|
ההגדרה regionID נקראת עכשיו region במלאי שטחי הפרסום האזורי.
|
string שדות מסוגים עם קבוצה מוגדרת של ערכים
|
enum שדות מסוגים עם קבוצה מוגדרת של ערכים
|
שדות במאפייני מלאי עם קבוצת ערכים מוגדרת (למשל availability, pickupMethod) הם עכשיו מסוג enum.
|