אתם יכולים להשתמש ב-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.
|