העברת מוצרים

‫Merchant API הוא דרך יציבה ואינטואיטיבית יותר לניהול נתוני המוצרים. השינוי העיקרי הוא הפרדת נתוני המוצרים לשני מקורות מידע נפרדים: ProductInput לשליחת הנתונים ו-Product לצפייה בגרסה הסופית המעובדת, כולל סטטוס המוצר והבעיות. המבנה החדש הזה מספק חוויה צפויה ושקופה יותר.

במדריך הזה מוסבר על ההבדלים העיקריים בין הממשקים, כדי לעזור לכם להעביר את השילוב מ-Content API for Shopping. במאמר ניהול המוצרים מופיע מדריך מפורט לשימוש בתכונות החדשות.

ההבדלים העיקריים

אלה השינויים המשמעותיים ביותר בניהול מוצרים ב-Merchant API בהשוואה ל-Content API for Shopping:

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

  • קידוד של שמות מוצרים: אפשר להשתמש בקידוד base64url ללא ריפוד (RFC 4648 Section 5) בשדות ProductInput.name ו-Product.name. אם שמות המוצרים מכילים תווים שמשמשים את Merchant API או תווים שמורים בכתובות URL, חובה להשתמש בקידוד. לדוגמה, צריך לקודד את שמות המוצרים אם הם מכילים את אחד מהתווים הבאים:

    % . + / : ~ , ( * ! ) & ? = @ # $

  • סטטוס המוצר המשולב: שירות productstatuses הוסר. בעיות באימות מוצרים וסטטוסים של יעדים נכללים עכשיו ישירות במשאב Product בשדה productStatus, מה שמפשט את אחזור הנתונים.

  • עדכוני מוצרים צפויים: השיטה החדשה productInputs.patch משנה ישירות קלט של מוצר ספציפי. זהו שיפור משמעותי לעומת Content API for Shopping, שבו עדכונים עלולים להידרס באופן בלתי צפוי על ידי העלאות אחרות של פידים. ב-Merchant API, עדכון נשאר עד שקלט המוצר הספציפי הזה מתעדכן או נמחק שוב. עדכוני מוצרים מוחלים על משאב ProductInput במקום על משאב Product שעבר עיבוד.

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

  • מזהי משאבים חדשים: מוצרים מזוהים עכשיו על ידי משאב RESTful‏ name במקום השדה id. הפורמט הוא accounts/{account}/products/{product}.

  • אין יותר קבוצות בהתאמה אישית: השיטה custombatch לא זמינה יותר. אפשר להשתמש בבקשות אסינכרוניות או בקיבוץ באצווה של HTTP כדי לשלוח כמה בקשות בקריאת HTTP אחת.

  • מקורות נתונים לכל תווית פיד ושפה: Merchant API מאפשר ליצור מקור נתונים בלי לציין תווית פיד ושפה, ולכן אפשר להוסיף מוצר עם כל תווית פיד ושפה.

בקשות

בקטע הזה מוצגות השוואות בין פורמטים של בקשות ב-Content API for Shopping וב-Merchant API.

תיאור הבקשה Content API for Shopping Merchant API
קבלת מוצר GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
הצגת מוצרים GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
הוסף מוצר POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert
עדכון מוצר PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
מחיקת מוצר DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId} DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
קבלת סטטוס המוצר GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId} GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
רשימת סטטוסים של מוצרים GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
איך שולחים כמה בקשות באצווה POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch שימוש בבקשות אסינכרוניות או באצוות HTTP

מזהים

הפורמט של מזהי המוצרים ב-Merchant API השתנה לשם משאב REST רגיל.

תיאור המזהה Content API for Shopping Merchant API
מזהה מוצר מחרוזת שמורכבת מפלחים שמופרדים באמצעות נקודתיים (:).
פורמט: channel:contentLanguage:targetCountry:offerId או channel:contentLanguage:feedLabel:offerId.
דוגמה: online:en:US:sku123		 מחרוזת name של משאב REST.
פורמט: accounts/{account}/products/{product} כאשר {product} הוא contentLanguage~feedLabel~offerId.
דוגמה: accounts/12345/products/en~US~sku123.
קידוד: מומלץ להשתמש בקידוד base64url ללא ריפוד, וחובה להשתמש בו במקרה של מזהי מוצרים שמכילים תווים שמשמשים את Merchant API או תווים שמורים בכתובות URL.

Methods

בטבלה הזו מוצגות השיטות של Content API for Shopping והשיטות המקבילות שלהן ב-Merchant API.

שיטה של Content API for Shopping שיטת Merchant API זמינות והערות
products.get products.get אחזור של המוצר הסופי שעבר עיבוד.
products.list products.list רשימה של מוצרים סופיים שעברו עיבוד.
products.insert productInputs.insert הוספת קלט מוצר. נדרש מינוי dataSource.
products.update productInputs.update ההתנהגות שונה באופן משמעותי. היא מעדכנת קלט ספציפי של מוצר והיא קבועה.
products.delete productInputs.delete מחיקה של קלט מוצר ספציפי. נדרש מינוי dataSource.
products.custombatch לא זמין משתמשים בבקשות אסינכרוניות או באצווה של HTTP.
productstatuses.get products.get השירות productstatuses יוסר. פרטי הסטטוס הם עכשיו חלק מהמשאב Product.
productstatuses.list products.list השירות productstatuses יוסר. פרטי הסטטוס הם עכשיו חלק מהמשאב Product.
productstatuses.custombatch לא זמין משתמשים בבקשות לא סנכרוניות או באצווה של בקשות HTTP.

שינויים מפורטים בשדות

בטבלה הזו מודגשים שדות חשובים ששונו, נוספו או הוסרו ב-Merchant API.

Content API for Shopping Merchant API תיאור
id name המזהה הראשי של מוצר הוא עכשיו משאב ה-REST‏ name. מומלץ להשתמש בקידוד base64url ללא ריפוד, והוא חובה במקרה של שמות מוצרים שמכילים תווים שמשמשים את Merchant API או תווים שמורים בכתובת URL.
מאפיינים של מפרט נתוני מוצרים ברמה העליונה (לדוגמה, title, price, link) אובייקט productAttributes מאפייני מוצר כמו title, price ו-link כבר לא מופיעים כשדות ברמה העליונה. עכשיו הם מקובצים באובייקט productAttributes במשאבים Product ו-ProductInput. כך מתקבל מבנה משאבים נקי ומאורגן יותר.
targetCountry feedLabel שם המשאב כולל עכשיו feedLabel במקום targetCountry, בהתאם לפונקציונליות של Merchant Center.
feedId dataSource (פרמטר של שאילתה) הפרמטר dataSource name הוא עכשיו פרמטר חובה בשאילתה לכל שיטות הכתיבה של productInputs (‏insert, ‏ update, ‏ delete).
channel לא זמין. משתמשים בערך legacy_local למוצרים שנמכרים בחנויות מקומיות בלבד. השדה channel לא מופיע יותר ב-Merchant API. במקום זאת, במוצרים עם הערוץ LOCAL ב-Content API for Shopping צריך להגדיר את השדה legacy_local כ-true.
לא זמין versionNumber שדה אופציונלי חדש ב-ProductInput שאפשר להשתמש בו כדי למנוע הוספות לא מסודרות למקורות נתונים ראשיים.
‫string שדות מסוגים עם קבוצה מוגדרת של ערכים ‫enum שדות מסוגים עם קבוצה מוגדרת של ערכים שדות במאפייני מוצר עם קבוצה מוגדרת של ערכים (לדוגמה, excluded_destinations, availability) הם עכשיו מסוג enum.
הקודם
Migrate merchant support
הבא
Migrate data sources management