נתוני גרסה (גרסה 2.1)

30 באוקטובר 2024

שירותים שקשורים ליישוב

כחלק מתהליך ההוצאה משימוש של ממשקי ה-API שקשורים להסדר, השירותים הבאים הוצאו משימוש: - settlementreports - settlementtranscations

סגירת ממשקי ה-API שקשורים ליישוב קשורה לתוכנית BuyOnGoogle ולממשקי ה-API שקשורים להזמנות שנסגרו בעבר.

קריאות לשירותים שצוינו למעלה צפויות להיכשל עם תגובה מסוג Service was not found on the server.

16 באוקטובר 2024

update_mask בUpdateConversionSourceRequest נקראת עכשיו OPTIONAL. אם לא מצוינת מסיכת עדכון, כל השדות שיש להם ערך שאינו ריק יעודכנו.

26 באוגוסט 2024 (מוקדם יותר לתאריך ההודעה המקורי)

שירותים שקשורים להזמנות

כחלק מההוצאה משימוש של ממשקי API שקשורים להזמנות, השירותים הבאים הוצאו משימוש: - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

קריאות לשירותים שצוינו למעלה צפויות להיכשל עם תגובה מסוג Service was not found on the server.

השירות OrderTrackingSignals לא הוצא משימוש והוא עדיין זמין.

10 באוגוסט 2024

שירותי Buy on Google

כחלק מהשבתה של ממשקי Buy on Google API, כל השיטות ב-BuyOnGoogleProgramService ייכשלו עם service was not found on the server.

‫19 ביולי 2024

שירות מוצרים

נוסף השדה member_price_effective_date. העדכון הזה מאפשר לכם לציין, במקרים הרלוונטיים, את טווח התאריכים שבו מחיר המועדון בתוקף. אם לא מציינים ערך בשדה, המחיר לחברי מועדון תמיד בתוקף.

‫20 במאי 2024

שירות מוצרים

הוספת את LoyaltyPrograms. העדכון הזה מאפשר לכם לספק כמה רמות עם נקודות נאמנות, מחירים וכו' שונים למוצר אחד. צריך להשתמש בשדה הזה במקום בשדה היחיד LoyaltyProgram.

שירות הדוחות

מדדים של 'קונים ב-Google' שהוצאו משימוש בטבלה MerchantPerformanceView. אחרי העדכון הזה, אחזור של כל מדד של 'קונים ב-Google' יחזיר את הערך 0. זה נכון גם לגבי ערכים היסטוריים של תאריכים קודמים.

מידע נוסף זמין במאמר ההוצאה משימוש של 'קונים ב-Google'.

13 במאי 2024

שירות מוצרים

מקור מידע על המוצר

שינויים בשדה האישורים: הוספנו את הערך certificationValue לשדה ProductCertification כדי לספק ערך אישור (נקרא גם סיווג, רמה או דירוג). הערך הזה מאפשר למשתמשים להעלות פרטי אישור גם אם רשות האישור לא מנפיקה קוד או מספר אישור.

מידע נוסף זמין במדריכים למוצרים.

6 במאי 2024

שירות הדוחות

הוספת קטגוריית יעילות לטבלה PriceInsightsProductView. הדירוג 'יעילות' מציין באילו מוצרים צפויה העלייה הכי גדולה בביצועים אם המחיר ישתנה. הדירוג הזה משקף את השיפור הצפוי בביצועים אם מחיר המבצע ישתנה ואת ההפרש בין המחיר הנוכחי למחיר המוצע.

24 באפריל 2024

שירות מוצרים

מקור מידע על המוצר

נוספו השדות האופציונליים downpayment ו-creditType לתשלומים בתשלומים:

• downpayment מספק את הסכום שהקונה צריך לשלם מראש כתשלום חד-פעמי.
• השדה creditType מציין את סוג התשלום בתשלומים (finance או lease). השדה הזה רלוונטי רק למודעות למכירת רכב.

11 באפריל 2024

שירות מוצרים

משאב המוצר

• הוספנו את המאפיין 'מחיר מינימום למשלוח חינם' (FreeShippingThreshold) למשלוח ברמת המבצע. המאפיין הזה מאפשר למוכרים להזין מחיר מוצר מינימלי כדי שהעלות של המשלוח תהיה בחינם.
• שינית את הרשאות הגישה של LoyaltyPoints

10 באפריל 2024

שירות מוצרים

משאב המוצר

הוספת את LoyaltyProgram

‫9 באפריל 2024

שירות מוצרים

מקור מידע על המוצר

הוספנו את האפשרויות structuredTitle ו-structuredDescription כדי לספק שמות ותיאורים של מוצרים שנוצרו על ידי AI.

‫3 באפריל 2024

שירות תמיכה למוכרים

נוסף השדה user_input_action_option שמאפשר לשותפים לבקש סוג פעולה חדש: BuiltInUserInputAction. הפעולה הזו מאפשרת לשותפים ליצור פונקציונליות מורכבת בשירות עצמי למוכרים, ישירות באפליקציה שלהם, במקום להפנות אותם אל Merchant Center.

נוספה שיטת TriggerAction חדשה עבור BuiltInUserInputAction. כדי לגשת לשיטה הזו, צריך לשלוח בקשה באמצעות הטופס הזה.

‫27 במרץ 2024

שירות מוצרים

מקור מידע על המוצר

הוספנו את AutoPricingMinPrice כמנגנון הגנה בפרויקטים 'הנחות אוטומטיות' ו'קידומי מכירות דינמיים', כדי להבטיח שהנחות על מבצעים של מוכרים לא יגרמו להורדת מחיר המוצר מתחת לערך הזה. כך אפשר לשמור על הערך והרווחיות של המבצע.

‫15 במרץ 2024

סגירה של 'קונים ב-Google' לחיפוש ולשופינג. תוכלו להמשיך לראות את ההזמנות הקיימות עד 31 באוקטובר 2024 באמצעות orders.list ו-orders.get.

8 במרץ 2024

שירות הדוחות

דוח TopicTrendsView נוסף לשירות Reports.

מידע נוסף זמין במדריכים בנושא דיווח.

6 במרץ 2024

שירות דוחות

הוספנו קטגוריה ודירוג של פוטנציאל קליקים למוצרים.

למידע נוסף, ראו את המדריכים לדיווח.

19 בפברואר 2024

השירות ConversionSources

המערכת הסירה את הערכים הבאים כמקורות המרות חוקיים:

• CROSS_CHANNEL_FIRST_CLICK
• CROSS_CHANNEL_LINEAR
• CROSS_CHANNEL_POSITION_BASED
• CROSS_CHANNEL_TIME_DECAY

האפשרויות 60 ו-90 ימים כחלון מבט לאחור הוסרו והאפשרות 40 ימים נוספה.

‫17 בינואר 2024

שירות POS

הוספנו ערכים חדשים לשדה matching_status_hint ב-PosStore, שמאפשרים למשתמשים לקבל פרטים נוספים על הסיבה לכך שההתאמה לחנות נכשלה.

11 בינואר 2024

שירות חשבונות

נוספו localProductManager ו-localProductManagement כסוג קישור ושירות, בהתאמה, לשיטה link. הם מאפשרים לקשר חשבונות למטרת ניהול נתוני מוצרים מקומיים.

29 בנובמבר 2023

שירות תמיכה למוֹכרים

נוספה פעולה חיצונית מסוג VERIFY_IDENTITY_IN_MERCHANT_CENTER לאימות הזהות שצריך לבצע ב-Merchant Center.

שירות POS

הוספנו את השדות matching_status ו-matching_status_hint ל-PosStore, שמאפשרים למשתמשים לדעת מה סטטוס ההתאמה של חנות ה-POS לחנות בפרופיל העסק ב-Google, ולקבל רמזים לפתרון במקרה של בעיה.

15 בנובמבר 2023

נקודות הקצה repricingrules ו-repricingrules.repricingreports כבר לא נתמכות.

1 בנובמבר, 2023

שירות ההגדרות של המשלוח

אין יותר תמיכה ב-shipment_type=pickup.

18 באוקטובר 2023

שירות חשבונות

הוספנו את השדה Business Identity שמאפשר למוכרים לזהות את עצמם בערכים מסוימים של צרכנים.

10 באוקטובר 2023

נוספה האפשרות Collection Point כסוג משלוח חדש בשירות ההגדרות של שירותי המשלוחים. מסירה בנקודת איסוף היא שירות שניתן על ידי צד שלישי (למשל, לא בבעלות המוכר) שבו שולחים את הפריט למיקום משויך של צד שלישי (כמו נקודות משלוח ואיסוף של UPS), במקום לשלוח אותם ישירות לכתובת הלקוח.

18 בספטמבר 2023

שירות הגדרות של מודעות LIA

הוספנו את השיטה setOmnichannelExperience כדי לאפשר למשתמשים להגדיר את חוויית השימוש בערוצים השונים (כלומר, הגדרות של חנות מקומית ואיסוף). בשלב זה, האפשרות הזו זמינה רק למשתמשים שספק ה-POS שלהם מהימן להפעלת הגדרות כאלה.

7 בספטמבר 2023

הוצאה משימוש של 'קונים ב-Google'

הוספת סטטוס DEPRECATED חדש לשיטה GetBuyOnGoogleProgramStastus. אי אפשר להפעיל מחדש או להשהות את התוכנית במצב כזה.

4 בספטמבר 2023

שירות תמיכה למוכרים

נוספה פעולה מובנית FIX_ACCOUNT_ISSUE לבעיות במוצרים שצריך לפתור ברמת החשבון. נוספה פעולה מובנית של SHOW_ADDITIONAL_CONTENT שתשמש להצגת הצדקה מרשות לאומית.

28 באוגוסט 2023

שירות לקידום מכירות

פתיחת השיטה list בשירות Promotions מגישה מוגבלת לכולם.

22 באוגוסט 2023

שירות תמיכה למוכרים

השקנו את שירות התמיכה למוכרים. השירות הזה מספק תוכן תמיכה בבעיות שקשורות לחשבון ולבעיות במוצרים.

4 באוגוסט 2023

שירות הדוחות

הדוח 'חשיפה לעומת מתחרים קרובים' נוסף לשירות הדוחות.

מידע נוסף זמין במדריכי הדיווח שלנו.

25 ביולי 2023

שירות POS

משאב מלאי שטחי פרסום

צריך להוסיף את השדות pickup_method ו-pickup_sla כדי לאפשר למוכרים לשלוח מידע לאיסוף יחד עם המלאי שלהם.

14 ביולי 2023

שירות הדוחות

הוספנו את הדוחות 'חשיפה לעומת המתחרים' לשירות הדוחות.

מידע נוסף זמין במדריכי הדיווח שלנו.

7 ביולי 2023

שירות מוצרים

מקור מידע על המוצר

הוספת את virtualModelLink כדי לספק כתובות URL של תמונה של מודל תלת-ממדי.

4 ביולי 2023

שירות מוצרים

מקור מידע על המוצר

מוסיפים את השדה certifications כדי לספק אישורי מוצרים, למשל לצורך סימון יעילות אנרגטית של מוצרים על סמך מסד הנתונים EPREL באיחוד האירופי.

26 ביוני 2023

שירות ההגדרות של המשלוח

מילוי הזמנות מקומי

נוסף השדה no_delivery_post_cutoff כדי לאפשר למוכרים לבטל את ההסכמה להצגת משלוח מקומי של n+1 יום כאשר יש להם שירות משלוחים מוגדר למסירה מקומית תוך יום אחד.

29 במאי 2023

שירות מבצעים

השיטה list נוספה עבור השירות Promotions.

שירות המלצות

מפעילים את סגירת האינטראקציה בשיטה ReportInteraction של שירות ההמלצות.

9 במאי 2023

יעד Cloud Retail

נכסים נוספים של קמעונאות ב-Cloud

מוסיפים את השדה 'מאפיינים נוספים של קמעונאות בענן'. זהו שדה חוזר שמיועד לשימוש של לקוחות שמשתמשים ביעד Cloud Retail. כשמשתמשים בשדה הזה, הוא יהיה זמין כשמשתמשים בתוכנית Cloud Retail. השדה הזה ימופה לשדה המאפיינים במודל Google Cloud Retail product.

22 במאי 2023

שירות מבצעים

השיטה list נוספה עבור השירות Promotions.

11 באפריל 2023

שירות ההגדרות של המשלוח

מילוי הזמנות מקומי

הוספנו את האפשרות 'מילוי הזמנה במשלוח מקומי' למוכרים שיוצרים הגדרת משלוח חדשה. הם יכולים להגדיר את ההגדרות שלהם לחנויות המקומיות בשדה החדש storeConfig. המידע הזה כולל את רדיוס השירות, המועד האחרון להזמנה וקודי החנויות של החנויות שמציעות משלוח מקומי.

3 באפריל

שירות ההמלצות

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

20 בפברואר 2023

שירות חשבונות

משאב חשבון

נוספ קטע חדש Account.ConversionSettings במשאב Accounts.

שירות ConversionSources

הוספנו את השירות 'מקורות המרות', שבו אפשר לנהל את מקורות ההמרות (השירות נמצא בקטע 'הגדרות המרות' ב-Merchant Center).

16 בפברואר 2023

שירות ההגדרות של המשלוח

אימות קוד החנות

קודי החנויות מאומתים עכשיו כדי לוודא שהם שייכים למוכרים לפני שההגדרות של משלוח מעודכנות.

אימות מוכר במודעות LIA

עכשיו מתבצע אימות של התוכניות שמספר המוֹכר רשום בהן לפני שההגדרות של המשלוח מתעדכנות. המוכרים צריכים להשתתף באחת מהתוכניות הבאות:

• LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
• LOCAL_INVENTORY_ADS

9 בפברואר 2023

שירות קידום מכירות

מרחיבים את שירות מבצעים ל-6 אפשרויות נוספות ב-targetCountry עם תמיכה מקומית ב-contentLanguage:

• BR
• ES
• NL
• JP
• IT
• KR

12 בינואר 2023

שירות מוצרים

משאב המוצר

נוספה lifestyleImageLinks כדי לספק כתובות URL לתמונות סגנון חיים.

24 בנובמבר 2022

שירות קידום מכירות

נוספו השדות החדשים 'promotionStatus' ו-'promotionStatus' בקטע Promotions.PromotionStatus. זהו שדה לקריאה בלבד.

15 בנובמבר 2022

שירות דוחות

הוספנו דוחות של Market Insights לשירות הדוחות.

אפשר עכשיו להריץ שאילתות בשירות Reports עבור:

• דוחות 'המוצרים הכי נמכרים' באמצעות הטבלאות BestSellersProductClusterView ו-BestSellersBrandView.
• דוח השוואת מחירים ביחס לשוק באמצעות הטבלה PriceCompetitivenessProductView.
• דוח מדדי המחירים באמצעות הטבלה PriceInsightsProductView.

מידע נוסף זמין במדריכי הדיווח שלנו.

7 בנובמבר, 2022

שירות פידים של נתונים

הוספנו תמיכה ב-feedLabel לשירות של פידים של נתונים.

14 בספטמבר 2022

עודכן הערך feedLabel כדי לאשר כל מחרוזת.

9 באוגוסט 2022

הוספנו את השדה feedLabel למוצרים.

עכשיו אפשר לציין את המדינה למזהי המוצרים באמצעות feedLabel במקום targetCountry. מזהי המבצעים מורכבים עכשיו מהפורמט online:language:feedLabel:offerId.

feedLabel מאוכלס באופן אוטומטי בערך של targetCountry בפידים קיימים, כדי לשמור על תאימות לאחור.

targetCountry הוצא משימוש.

כדי לתמוך במבצעים גלובליים, ה-Content API for Shopping הוציא את השדה targetCountry משימוש. במקום זאת, מומלץ להשתמש בשדה shipping כדי לציין את מדינות היעד.

עכשיו השדה targetCountry מאוכלס באופן אוטומטי בערך שסיפקתם בשדה feedLabel.

אזהרה: ערכים של targetCountry שמולאו על סמך שליחת feedLabel לא מאפשרים להציג את המבצעים במדינה שצוינה ב-feedLabel. כדאי להשתמש ב-shipping כדי לוודא שהמבצעים שלכם יוצגו במדינות היעד שבחרתם.

לפרטים נוספים, עיינו בפוסט בבלוג Feed labels מחליפה את מדינת היעד ב-Content API for Shopping.

8 בדצמבר 2021

שירות חשבונות

משאב חשבון

נוספ קטע חדש Account.AutomaticImprovements במשאב Accounts.

הקטע החדש הזה יאפשר למוכרים לעדכן פריטים באופן אוטומטי, לשפר את התמונות ואת הגדרות המשלוח.

25 באוקטובר 2021

שירות קידום מכירות

הוספת Get Promotion ל-Promotion API.

11 באוקטובר 2021

Shipping Settings API

הוספנו את השדה החדש warehouse במשאב ShippingSettings כדי לאפשר לסוחרים לנהל את המחסנים שאפשר להשתמש בהם ב-WarehouseBasedDeliveryTime.

מוסיפים שדה warehouseName חדש ב-WarehouseBasedDeliveryTime כדי להפנות ל-warehouse לפי שם המחסן.

4 באוקטובר 2021

שירות חשבונות

משאב חשבון

נוסף שדה חדש 'phone_verification_status' בקטע Accounts.BusinessInformation. זהו שדה לקריאה בלבד, שמוגדר על ידי Accounts.VerifyPhoneNumber.

13 בספטמבר 2021

השירות BuyOnGooglePrograms

המשאב BuyOnGoogleProgramStatus

נוספו שדות חדשים במשאב BuyOnGooglePrograms.BuyOnProgramStatus שמייצגים: ערוצי מכירות אונליין, מודלים עסקיים ומספר טלפון של שירות לקוחות.

שיטת UpdateBuyOnGoogleProgramStatus חדשה

נוספה שיטת UpdateBuyOnGoogleProgramStatus חדשה, שתאפשר לעדכן משאב מורחב BuyOnGooglePrograms.BuyOnProgramStatus.

6 בספטמבר 2021

שירות חשבונות

משאב חשבון

הוספנו שדה חדש 'korean_business_registered_number' בקטע Accounts.BusinessInformation. השדה הזה יימחק רק אם תגדירו לו מחרוזת ריקה באופן מפורש.

30 באוגוסט 2021

שירות קידום מכירות

נוסף שירות חדש לקידום מכירות עם קידום מכירות מסוג Insert.

שירות הזמנות

הוספנו שיטה חדשה orders/captureOrder לחיוב לפני המשלוח.

הסיבה לביטול ההזמנה החדשה: FAILED_TO_CAPTURE_FUNDS

שירות מוצרים

מקור מידע על המוצר

הוספנו את המאפיינים productLength, productHeight, productWidth ו-productWeight כדי לספק את המידות והמשקל של המוצר.

9 באוגוסט 2021

שירות RepricingRule

RepricingRule Type

ערך enum חדש לשדה RepricingRuleType.

הוספת את TYPE_SALES_VOLUME_BASED ואת TYPE_COMPETITIVE_PRICE.

17 במאי 2021

שירות להזמנת תוויות להחזרת מוצרים

נוסף שדה חדש 'product_id' ב-CreateReturnRequest. המוכרים יכולים לציין את product_id או את line_item_id כדי לזהות את הפריט שצריך להחזיר.

שירות מוצרים

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

3 במאי 2021

שירות להזמנת תוויות להחזרת מוצרים

נוספו שיטות חדשות להעלאת תוויות להחזרות שמנוהלות על ידי המוכר (MMR). בעזרת השדה החדש orderreturns.labels.create, תוכלו להעלות את תוויות ההחזרה כדי לשתף אותן עם הלקוח.

26 באפריל 2021

Shipping Settings API

שדה warehouseBasedDeliveryTimes חדש ב-DeliveryTime כדי לתמוך בשירותי משלוחים שמחשבים את תאריך האספקה המשוער על סמך מיקום המחסן ושירות חברת התובלה שנבחר.

שדה eddServices חדש באובייקט CarriersCarrier, שמחזיר את השמות של השירותים שרלוונטיים לחישוב מועד המסירה המשוער.

12 באפריל 2021

שירות מוצרים

מקור מידע על המוצר

שדה additionalSizeType חדש שיכול לתמוך ב-2 סוגי מידות לכל מוצר לכל היותר.

שינויים בשדה המשלוח: נוספו minHandlingTime, maxHandlingTime, minTransitTime ו-maxTransitTime ל-ProductShipping כדי לספק מהירות משלוח ברמת המוצר.

‫28 בינואר 2021

שירות חשבונות

נוספה תמיכה בתוויות אוטומטיות למשאבים AccountLabel ו-Account. למידע נוסף, קראו את הקטע סוגי תוויות CSS במדריך לניהול תוויות CSS.

5 באוקטובר 2020

שירות CSSES

משאב CSS

נוסף שירות csses חדש לאחזור מידע על דומיינים של CSS והקצאת תוויות אליהם. עכשיו אפשר להשתמש במשאב AccountLabel גם כדי ליצור תוויות ברמת קבוצת ה-CSS ולפרסם אותן. מידע נוסף זמין במאמר ניהול תוויות CSS.

24 באוגוסט 2020

שירות מוצרים

מקור מידע על מוצרים

שדה shoppingAdsExcludedCountries חדש להחרגת מבצעים מפרסום במדינות מסוימות.

המשאב Productstatuses

השדות החדשים approvedCountries, ‏ pendingCountries ו-disapprovedCountries באובייקט destinationStatuses מספקים מידע נוסף על סטטוס המבצע מעבר למידע שמופיע בשדה targetCountry.

שדה itemLevelIssues.applicableCountries חדש.

10 באוגוסט 2020

שירות חשבונות

נוסף משאב AccountLabel חדש לניהול תוויות חשבון ב-Merchant Center ב-CSS Center. משתמשי CSS Center יכולים עכשיו גם להציג את חשבונות Merchant Center שלהם ולהקצות להם תוויות באמצעות השיטות accounts.list, ‏ accounts.get ו-accounts.updatelabels. מידע נוסף זמין במאמר ניהול תוויות CSS.

19 ביוני 2020

שירות מוצרים

מקור מידע על המוצר

שדות חדשים

השדות החדשים productDetails,‏ productHighlights,‏ subscriptionCost ו-canonicalLink.

2 ביוני 2020

שירות ההזמנות

הוספנו שיטות חדשות להפעלת החזרים כספיים ללא החזרת מוצרים. בעזרת השדות החדשים orders.refunditem ו-orders.refundorder, תוכלו להתחיל החזרים כספיים על הזמנות גם אם הלקוח לא מחזיר אותן.

27 באפריל 2020

שירות החזרת הזמנות

נוספו שיטות חדשות acknowledge ו-process, ומסננים ושדות חדשים לשיטות קריאה (list, get).

קישור GMB

הוספנו את האפשרות לקשר חשבונות Merchant Center לחשבון GMB באמצעות מזהה חשבון GMB.

14 באפריל 2020

ממשקי API לדוחות הסדרה

נוסף שירות חדש לקבלת דוחות הסדרת נתונים.

9 במרץ 2020

Local inventory API

הוספנו שירות חדש לשליחת נתוני מלאי בחנות מקומית.

2 במרץ 2020

API של הגדרות התראות ב-Pubsub

נוספו שירותים חדשים לניהול ההגדרות של התראות pubsub.

3 בדצמבר 2019

שירות מוצרים

הוספנו תמיכה בפידים משלימים של Content API לחשבונות מרובי לקוחות.

11 בספטמבר 2019

שירות הזמנות

נוספה תמיכה בהזמנות עם איסוף עצמי ובתכונות המתאימות בסביבת החול.

14 באוגוסט 2019

שירותים חדשים

נוספו שירותים חדשים של מדיניות החזרת מוצרים וכתובת להחזרת מוצרים עבור 'קונים ב-Google'.

שירות הזמנות

משאב ההזמנה

שדה חדש

שדה quantityUndeliverable חדש.

7 באוגוסט 2019

שירות ההזמנות

משאב ההזמנה

שדות חדשים

נוספו השדות החדשים loyaltyInfo ו-invoiceReceivingEmail למשאב Order.

1 ביולי 2019

שירות מוצרים

תמיכה בפידים משלימים של Content API שנוספו בשירות 'מוצרים'.

11 ביוני 2019

שירות ההזמנות

משאבים של Order ו-TestOrder

הוספה של התאמת מחיר

נוסף השדה החדש lineItem[].adjustments שמכיל התאמה למחיר המקורי של פריט העלויות ולמס שנגרמו כתוצאה מהחרגות.

14 בפברואר 2019

השינויים בגרסה הזו

אין יותר תמיכה בהרצות יבשות

הפרמטר dryRun הוסר מגרסה 2.1. הדרישה הזו חלה על כל הקריאות ל-API.

שיטות תיקון שכבר לא נתמכות

השירותים הבאים כבר לא תומכים בשיטה patch:

• חשבונות
• Accounttax
• פידים של נתונים
• Liasettings
• הגדרות משלוח

הסרה של שיטות HTTP BATCH

כל השיטות של BATCH ב-HTTP הוסרו מגרסה 2.1. במקום זאת, אתם צריכים להשתמש ב-customBatch. השירותים המושפעים הם:

• חשבונות
• סטטוסי חשבון
• פידים של נתונים
• Datafeedstatuses
• Liasettings
• Orderreports
• מיקום
• מוצרים
• Productstatuses
• Shippingsettings

שירות חשבונות

עדכון

השדות businessInformation ו-googleMyBusinessLink בבקשה נוספו אחרי ההשקה הראשונית של Content API v2. לכן, יש אמצעי הגנה שמונעים מהמוכרים למחוק בטעות מידע בשני השדות האלה באמצעות update, אם הם לא סיפקו את המידע.

בגרסה 2, המוכרים צריכים לציין במפורש את השדות האלה בגוף ריק ( {}) כדי למחוק אותם. בגרסה 2.1, השדות נמחקים אם אתם מספקים גוף ריק או אם אתם לא מספקים אותם.

משאב חשבון

שינוי המיתוג של AdWords ל-Google Ads

AdWords נקראת עכשיו Google Ads, ולכן השמות של השדות הבאים שקשורים ל-AdWords השתנו:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

הסרת שדות וערכים שיצאו משימוש

השדה reviewsUrl, שהוצא משימוש, הוסר. בנוסף, סטטוס הקישור inactive הוסר עבור adsLinks,‏ googleMyBusinessLink ו-youtubeChannelLinks.

השירות Accountstatuses

המשאב AccountStatus

הסרה של dataQualityIssues

הן הוחלפו על ידי itemLevelIssues.

שירות פיד נתונים

מקור מידע של פיד נתונים

הסרת שדות שהוצאו משימוש

השדות contentLanguage,‏ targetCountry ו-intendedDestinations הוסרו והוחלפו בשדות country,‏ language,‏ includedDestinations ו-excludedDestinations ב-targets.

הסרה של עדכון מלאי מוצרים

פידים מסוג product inventory update הוסרו.

שירות מלאי

השירות inventory מגרסה 2 הוסרה והוחלפה בשתי תכונות חדשות בגרסה 2.1:

• משתמשים בפידים משלימים חדשים כדי לעדכן מוצרים באופן חלקי.
• משתמשים בשירות החדש localinventory לעדכוני מוצרים בחנויות מקומיות.

שירות ההזמנות

CancelLineItem

השדות amount,‏ amountPretax ו-amountTax בבקשה הוסרו. הסכום להחזר כספי מחושב עכשיו באופן אוטומטי.

CustomBatch

השדה CustomBatch הוסר מגרסה 2.1.

InStoreRefundLineItem

השדות amountPretax ו-amountTax הוחלפו בשדות priceAmount ו-taxAmount, בהתאמה. השדה priceAmount עשוי לכלול את הסכום לפני המס או אחרי המס, בהתאם למיקום ההזמנה.

החזר כספי

השיטה הזו הוסרה. במקום זאת, אתם צריכים להשתמש ב-returnRefundLineItem.

ReturnLineItem

השיטה הזו הוסרה. במקום זאת, צריך להשתמש ב-returnRefundLineItem בלי לציין סכום להחזר כספי.

ReturnRefundLineItem

השדות amountPretax ו-amountTax הוחלפו בשדות priceAmount ו-taxAmount, בהתאמה. השדה priceAmount עשוי לכלול את הסכום לפני המס או אחרי המס, בהתאם למיקום ההזמנה.

ShipLineItem

השדות carrier,‏ shipmentId ו-trackingId בבקשה הועברו אל shipmentInfos.

משאבים ל-Order ול-TestOrder

פורמט חדש של קידום מכירות

יש פורמט חדש לקידום מכירות בגרסה 2.1. אי אפשר ליצור הזמנות לבדיקה עם מבצעים.

הסרה של שדות שיצאו משימוש

השדה paymentMethod הוסר, ו-billingAddress ו-predefinedBillingAddress הם עכשיו שדות ברמה העליונה ב-Order וב-TestOrder, בהתאמה.

בנוסף, customer.explicitMarketingPreference הוסר והוחלף על ידי customer.marketingRightsInfo גם ב-Order וגם ב-TestOrder.

השדה customer.email, שהוצא משימוש, הוסר.

הפורמט של השדה promotions השתנה במשאב Order.

שירות Orderpayments

השירות הזה הוסר מגרסה 2.1.

שירות מוצרים

התגובה מ-insert תכלול רק את המאפיינים הבאים:

• channel
• contentLanguage
• id
• offerId
• targetCountry

לא מוחזרות אזהרות ושגיאות לא חמורות בתשובה. כך אפשר לשלב טוב יותר את הפיד עם כללי פיד ותכונות מתקדמות אחרות לניהול פיד.

עכשיו יש עיכוב של כמה דקות לפני שאפשר לאחזר מוצר שהוסף באמצעות get או list.

אין יותר ערובה שמזהה המבצע שהוחזר יהיה זהה למזהה המבצע שהוזן.

המחירים מאומתים עכשיו לפני הוספת המוצרים. מותר להשתמש רק בתווים הבאים במחרוזת הערך: +,‏ -,‏ . וספרות (0-9). לא ניתן להשתמש יותר בפסיקים.

משאב המוצר

הקבוצות המותאמות אישית הוחלפו במאפיינים מותאמים אישית רקורסיביים

בעבר, אפשר היה לקבץ מאפיינים מותאמים אישית על ידי הוספת מאפיינים מותאמים אישית לאותה קבוצה בהתאמה אישית בגרסה 2. מאפיינים מותאמים אישית הם עכשיו חזרה (recursive) בגרסה 2.1, כך שאין צורך בקבוצות בהתאמה אישית.

למאפיינים מותאמים אישית יש עכשיו שדה groupValues נוסף בנוסף לשדה value המקורי. צריך להגדיר רק אחד מהם, כלומר אי אפשר להגדיר אותם בו-זמנית או להשמיט אותם.

מכיוון שמוכרים יכולים לעבור בין הגרסה 2 לגרסה 2.1, יכול להיות למוצרים מאפיינים מותאמים אישית חזרהיים (recursive) שלא ניתן לייצג בגרסה 2, כי לקבוצות בהתאמה אישית יש לכל היותר שתי רמות. במקרה כזה, קבוצת המאפיינים המותאמים אישית תהיה קטועה.

הסרת הסוג והיחידה ב-customAttributes

בגרסה 2.1, מאפיינים מותאמים אישית לא יכילו יותר את הערכים type ו-unit. במקום זאת, היחידות יצורפו ל-value (אם יש), והסוגים אמורים להיות מזוהים באופן אוטומטי. לדוגמה, אפשר להשתמש ב-'1.23 EUR' או ב-'5.6 ס"מ' בתור הערך של value ב-v2.1.

ProductTypes מחליף את productType ואת additionalProductTypes

בעבר, סוגי המוצרים היו מאוחסנים בשני שדות, כאשר הסוג הראשון מאוחסן בשדה היחיד productType והשאר בשדה החוזר additionalProductTypes. בגרסת v2.1, שני השדות הוחלפו בשדה יחיד productTypes.

המאפיין 'יעדים' הוחלף במאפיינים includedDestinations ו-excludedDestinations

ב-v2, היעדים הוזנו כרשימה של שמות יעדים וזוגות של כוונות בשדה החוזר destinations. השדה הזה הוחלף בשני השדות החוזרים הבאים: includedDestinations ו-excludedDestinations. אין צורך לכלול ב-includedDestinations. יעדים שמופעלים כברירת מחדל. ההגדרה הזו תואמת להגדרה של שינויי ברירת המחדל של היעדים בפיד.

שינוי השמות של שדות שקשורים ל-AdWords

AdWords נקראת עכשיו Google Ads, ולכן השמות של השדות הבאים שקשורים ל-AdWords השתנו:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

הסרה של שדות שיצאו משימוש

השדות הבאים שהוצאו משימוש הוסרו:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

השירות Productstatuses

אחזור ורישום

המאפיין product הוסר, יחד עם הפרמטר includeAttributes. כדי לאחזר מאפיינים של המוצר שתואם לסטטוס, משתמשים בשירות Products ובערך של השדה החדש productId.

רשימה

הפרמטר includeInvalidInsertedItems הוסר. עכשיו כל המוצרים מוחזרים, גם אם הם לא תקפים. כלומר, list פועל עכשיו כאילו includeInvalidInsertedItems מוגדר תמיד ל-true.

המשאב ProductStatus

DestinationsStatuses

השדות intention,‏ approvalStatus ו-approvalPending ב-destinationStatuses הוחלפו ב-status, שהיא מחרוזת שיכולה להיות אחת מהאפשרויות הבאות: approved,‏ disapproved או pending.

הסרה של dataQualityIssues

הן הוחלפו על ידי itemLevelIssues.