מעבר מגרסה v1beta לגרסה v1

המדריך הזה יעזור לכם לעבור מ-Merchant API v1beta ל-v1, הגרסה הראשונה שזמינה לכולם. בגרסה v1 יש כמה עדכונים וכמה שינויים שעשויים לדרוש עדכונים בקוד. השינויים האלה נועדו לפשט את ה-API ולשפר את הניהול של חשבון Merchant Center.

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

אלה השינויים החשובים ביותר שכדאי להכיר כשעוברים מ-v1beta ל-v1:

• הרשמה חד-פעמית של מפתח API אחד לפחות כדי להשתמש ב-Merchant API: תצטרכו להפעיל את השיטה registerGcp (רק פעם אחת לכל פרויקט Google Cloud שמשמש לאימות) כדי לספק את פרטי הקשר שלכם. כך תוכלו להשתמש ב-API ולקבל עדכונים והודעות שקשורים ל-Merchant API. לא תהיה לכם אפשרות להשתמש באף API של v1 או v1alpha עד שתשלימו את השלב הזה. הוראות מפורטות זמינות במאמר הרשמה כמפתח
• Product.attributes שינוי שם: השם של השדה Product.attributes שונה ל-Product.productAttributes.
• הסרת פרטי מס ברמת המוצר: השדות taxes ו-taxCategory הוסרו מהאובייקט Product.productAttributes. מידע נוסף זמין במאמר בנושא מיסים במרכז העזרה של Google Merchant Center
• שינויים בשדה GTIN: השם של השדה gtin באובייקט Product.productAttributes שונה ל-gtins כדי לשקף טוב יותר את העובדה שהוא יכול להכיל כמה ערכים. השדה gtin באובייקט OrderTrackingSignals.lineItemDetails הוא עכשיו array, ושמו שונה ל-gtins.
• הסרת השדה 'ערוץ': השדה channel הוסר מהמוצרים, מהקלט של המוצרים וממקורות הנתונים. הוספנו שדה בוליאני חדש, legacyLocal, כדי לציין באופן ברור מוצרים שנמכרים רק בחנויות פיזיות. הערה: השדה legacyLocal הוא שדה עזר שנועד לסייע בהעברה, ובסופו של דבר הוא יוצא משימוש אחרי שיהיה אפשר לטרגט באופן מלא שיטות שיווק אונליין ומקומיות באמצעות מקור מוצרים יחיד. מידע נוסף מופיע בטבלה שבקטע הבא.
• שדות חדשים למאפייני מלאי אזורי ומקומי:
  • כל השדות RegionalInventory למעט name, account ו-region עכשיו עטופים באובייקט חדש שנקרא regionalInventoryAttributes . לדוגמה, המאפיין RegionalInventory.price נמצא עכשיו בקטע RegionalInventory.regionalInventoryAttributes.price.
  • כל השדות LocalInventory למעט name, account ו-storeCode עכשיו עטופים באובייקט חדש שנקרא localInventoryAttributes . לדוגמה, המאפיין LocalInventory.price נמצא עכשיו בקטע LocalInventory.localInventoryAttributes.price.
• הסרה של customAttributes ממלאי אזורי וממלאי בחנות מקומית: השדה customAttributes הוסר מהמשאבים RegionalInventory ו-LocalInventory.
• יצירת חשבון משופרת: השדה המיותר users הוסר מה-CreateAndConfigureAccountRequest. משתמשים בשדה user כדי לשייך משתמש ראשוני לחשבון חדש.
• סוגים מסוימים של מאפיינים השתנו ממחרוזות לרשימות מוגדרות: חלק מהשדות במשאבי Product ו-Inventory עם רשימה קצרה מוגדרת של ערכים השתנו מסוג string לסוג enum כדי לשפר את אימות הנתונים (לדוגמה, השדה Product.ProductAttributes.condition הוא עכשיו enum).
• הסרה של שיטת עדכון מדיניות החזרת מוצרים באינטרנט: השיטה onlineReturnPolicy.update הוסרה בגרסה v1. במקום זאת, צריך ליצור מדיניות החזרת מוצרים באינטרנט באמצעות השיטה onlineReturnPolicy.create.

איך מבצעים את ההעברה

הגרסה v1beta של Merchant API תצא משימוש ב-28 בפברואר 2026. מידע נוסף על לוח הזמנים להוצאה משימוש זמין במדריך לניהול גרסאות של Merchant API.

• השלב הראשון בתהליך ההעברה הוא לבצע רישום חד-פעמי כמפתח (ראו הרשמה כמפתח). כדי ששיטות v1 יעבדו, צריך להפעיל את שיטת registerGcp לכל פרויקט ב-Google Cloud שמשמש לאימות.

• לא משנה איך קוראים לממשקי ה-API (עם REST, ‏ gRPC או באמצעות ספריות לקוח), אפשר לבצע את המעבר בשלבים. המשמעות היא שאפשר לעדכן ולהעביר את הקוד שלכם API אחד בכל פעם (לדוגמה, להעביר את Products API ל-v1 תוך שמירה על Accounts API ב-v1beta) בלי לעדכן את השילוב כולו בבת אחת.

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

בטבלה הזו מוצגת השוואה מפורטת של השדות שהשתנו בין גרסה v1beta לגרסה v1.

v1beta	v1	תיאור
Product.gtin	Product.gtins	השם של השדה של מספרי ה-GTIN השתנה.
Product.taxes	הוסר	השדה taxes הוסר
Product.taxCategory	הוסר	השדה taxCategory הוסר
Product.channel	הוסר	השדה channel הוסר. משתמשים בשדה legacyLocal לתרחישים מקומיים.
Product.attributes	Product.productAttributes	השם של השדה attributes השתנה ל-productAttributes.
השדות availability, ‏ condition, ‏ gender, ‏ includedDestinations ו-excludedDestinations ב-Product מיוצגים כ-strings (או array מתוך strings)	השדות האלה הם עכשיו enums (או array מתוך enums)	השדות עם רשימה קצרה מוגדרת של ערכים השתנו מסוג string לסוג enum.
‫price, salePrice, salePriceEffectiveDate וגם availability בRegionalInventory	הועברה אל RegionalInventory.regionalInventoryAttributes	השדות האלה הועברו לקטע regionalInventoryAttributes.
השדה RegionalInventory.availability הוא string	מעכשיו התפקיד של RegionalInventory.regionalInventoryAttributes.availability הוא enums	סוג הזמינות השתנה מ-string ל-enum.
‫price, salePrice, salePriceEffectiveDate, availability, quantity, pickupMethod, pickupSla וinstoreProductLocation בLocalInventory	הועברה אל LocalInventory.localInventoryAttributes	השדות האלה הועברו לקטע localInventoryAttributes.
השדה LocalInventory.availability הוא string	מעכשיו התפקיד של LocalInventory.localInventoryAttributes.availability הוא enums	סוג הזמינות השתנה מ-string ל-enum.
LocalInventory.customAttributes	הוסר	אין יותר תמיכה במאפיינים בהתאמה אישית במלאי של חנויות מקומיות.
RegionalInventory.customAttributes	הוסר	אין יותר תמיכה במאפיינים מותאמים אישית למלאי אזורי.
ProductInput.channel	הוסר	השדה channel הוסר. משתמשים בשדה legacyLocal לתרחישים מקומיים.
DataSource.channel	הוסר	השדה channel הוסר. משתמשים בשדה legacyLocal לתרחישים מקומיים.
לא זמין	ProductInput.legacyLocal	שדה בוליאני חדש שמציין שמוצר יכול לטרגט רק שיטות שיווק מקומיות. מזהה משאב המוצר יכלול את הקידומת local~.
לא זמין	Product.legacyLocal	שדה בוליאני חדש שמציין שמוצר נמכר רק בחנויות מקומיות ולא זמין לרכישה אונליין.
לא זמין	DataSource.legacyLocal	שדה בוליאני חדש שמציין שמקור נתונים מכיל מוצרים שנמכרים רק בחנויות מקומיות.
OrderTrackingSignals.LineItemDetails.gtin	OrderTrackingSignals.LineItemDetails.gtins	השם של השדה gtin השתנה ל-gtins, ועכשיו הוא מערך של מחרוזות (במקום מחרוזת).
CreateAndConfigureAccountRequest.users	הוסר	השדה users הוסר. משתמשים בשדה user כדי להוסיף את האדמין הראשוני לחשבון.