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

15 בנובמבר 2024

שירות מוצרים

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

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 יום כשהם מגדירים שירות משלוח בתוך n יום.

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 לשירות הדוחות.

עכשיו אפשר לשלוח שאילתות לשירות הדוחות לגבי הנושאים הבאים:

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

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

7 בנובמבר 2022

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

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

14 בספטמבר 2022

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

9 באוגוסט 2022

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

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

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

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

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

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

פרטים נוספים זמינים בפוסט בבלוג תווית הפיד מחליפה את מדינת היעד ב-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 שמייצגים: ערוצי מכירות אונליין, מודלים עסקיים ומספר טלפון של שירות לקוחות.

שיטה חדשה לעדכון של BuyOnGoogleProgramStatus

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

6 בספטמבר 2021

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

משאב חשבון

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

30 באוגוסט 2021

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

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

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

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

New order cancellation reason 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
• Shippingsettings

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

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

• חשבונות
• Accountstatuses
• פידים של נתונים
• 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 הוסרו ב-targets והוחלפו בשדות country,‏ language,‏ includedDestinations ו-excludedDestinations.

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

פידים מסוג 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). לא ניתן להשתמש יותר בפסיקים.

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

CustomGroups הוחלף ב-customAttributes רסורסיבי

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

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

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

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

בגרסה 2.1, מאפיינים מותאמים אישית לא יכללו יותר את השדות type ו-unit. במקום זאת, צריך לצרף את היחידות ל-value (אם הוא קיים) והסוגים אמורים להתגלות באופן אוטומטי. לדוגמה, אפשר להשתמש ב-value בתור '1.23 EUR' או '5.6 ס"מ' בגרסה 2.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.