הערות מוצר של Merchant Accounts API

השבוע שמתחיל ב-29 ביוני 2026

• השקת המסנן access שמשמש בנקודת הקצה של רשימת החשבונות. התכונה הזו מאפשרת לסנן חשבונות לפי רמת הגישה שלכם, והערכים האפשריים הם DIRECT, INDIRECT ו-ALL. ההתנהגות שמוגדרת כברירת מחדל היא החזרת כל החשבונות שיש לכם גישה אליהם. מידע נוסף זמין במאמר בנושא סינון החשבונות שאליהם יש לכם גישה.

השבוע שמתחיל ב-20 באפריל 2026

• הוספתי את youtube-affiliate לרשימת השמות הזמינים של התוכניות לתיאור המשאב accounts.programs.
• מפעילים את Program API לתוכנית השותפים של YouTube שופינג. זמין לבודקים נאמנים.

השבוע שמתחיל ב-6 באפריל 2026

• נוסף סטטוס WAITING לסטטוס האישור. בשירותי השוואת מחירים (CSS), הערך WAITING הוא מצב מעבר בין PENDING לבין ESTABLISHED. האפשרות הזו מתאימה למקרים שבהם שירות ה-CSS המקורי צריך זמן כדי לבצע ניקוי נתונים לפני שהחשבון מועבר באופן מלא לשירות ה-CSS החדש.

השבוע שמתחיל ב-16 במרץ 2026

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

השבוע שמתחיל ב-17 בנובמבר 2025

• CreateAndConfigureAccountRequest מציעה עכשיו שירותים חדשים שאפשר להגדיר במהלך הגדרת החשבון. צריך לציין בדיוק אחד מהמאפיינים AccountAggregation,‏ AccountManagement ו-ComparisonShopping. בנוסף, אפשר לציין מספר שרירותי של שירותים מסוג ProductsManagement ו-CampaignsManagement. עם זאת, לא יכולים להיות שני שירותים כאלה עם אותו ספק ואותם מזהים של חשבונות חיצוניים.

• בשיטה AccountsService.CreateAndConfigure יש עכשיו הגדרה שמאפשרת לקבוע אם לשלוח אימייל לאימות.

• ל-CreateAndConfigureAccountRequest.AddAccountService יש עכשיו שדה external_account_id (השדה הזה כבר קיים במשאב AccountService). אפשר לציין אותו יחד עם שירותים מסוג CampaignsManagement ו-ProductsManagement.

• נוסף שירות ComparisonShopping למשאב AccountService. פרטים נוספים זמינים בכתובת https://support.google.com/merchants/answer/12653197.

• עכשיו אפשר להגדיר כינוי לשיוך במהלך יצירת חשבון באמצעות השדה setAlias ב-CreateAndConfigureAccountRequest.

• נוספה שיטת VerifySelf ל-UserService שמאפשרת לעדכן את המצב מ-PENDING ל-VERIFIED עבור משאב User שמייצג את המשתמש שמבצע את הקריאה.

• השקנו את השדה החדש radius_area במטען הייעודי (payload) של Regions API‏ Region, שיאפשר למוֹכרים ליצור אזור באמצעות רדיוס.

השבוע שמתחיל ב-10 בנובמבר 2025

• פרסום גרסת v1alpha של Services API.
• השקת שדה product_filters חדש במטען הייעודי (payload) של CampaignManagement Services API שיאפשר למוכרים לשתף רק קבוצת משנה של הפיד שלהם עם חשבונות Google Ads, על סמך סינון מותנה של מאפייני המוצרים של המוכר. זו תכונה שזמינה רק למספר מוגבל של מוכרים שנמצאים ברשימת ההיתרים.

השבוע שמתחיל ב-25 באוגוסט 2025

• נוספו שיטות חדשות לפעולות מקובצות ל-Regions API:
  • BatchCreateRegions: מאפשר ליצור כמה אזורים בבקשה אחת.
  • ‫BatchUpdateRegions: מאפשר לעדכן כמה אזורים בבקשה אחת.
  • ‫BatchDeleteRegions: מאפשר למחוק כמה אזורים לפי שם בבקשה אחת.

השבוע שמתחיל ב-1 ביולי 2025

• השקת משאב CheckoutSettings שמאפשר למשתמשי API ליצור, לעדכן, למחוק ולקבל checkoutSettings.

השבוע שמתחיל ב-26 במאי 2025

• עכשיו אפשר לסנן חשבונות לפי capabilities. בשלב הזה, הערך האפשרי היחיד הוא CAN_UPLOAD_PRODUCTS. המסנן הזה מאפשר לאחזר חשבונות שאפשר להעלות בהם מוצרים. המשמעות היא שאפשר להשתמש עכשיו בסעיפים הבאים ברמת החשבון:

  • capabilities:CAN_UPLOAD_PRODUCTS
  • -capabilities:CAN_UPLOAD_PRODUCTS
  • NOT capabilities:CAN_UPLOAD_PRODUCTS מידע נוסף זמין במדריך הסינון.

• השקת הרשאת גישה לקריאה בלבד. משתמשים עם הרשאת גישה לקריאה בלבד יכולים לראות את נתוני המוכר, אבל לא לשנות אותם.

השבוע שמתחיל ב-19 במאי 2025

• עדכנו את התיעוד של Program API והסרנו את ההצהרה השגויה שלפיה השימוש בשיטות Enable/Disable מוגבל למשתמשי Admin.

השבוע שמתחיל ב-12 במאי 2025

• השקנו משאב של מדיניות החזרת מוצרים אונליין שמאפשר למשתמשי API ליצור, לעדכן ולמחוק מדיניות החזרת מוצרים.
• השקנו את OmnichannelSettingsService ואת המשאב OmnichannelSetting, שמאפשרים למשתמשי API לנהל את חוויית השימוש שלהם בכל הערוצים.
• השקנו את LfpProvidersService ואת המשאב LfpProvider, שמאפשרים למשתמשי API לנהל את הקשר שלהם עם שותפים מקומיים להפצת פידים.
• השקנו את GbpAccountsService ואת המשאב GbpAccount, שמאפשרים למשתמשי API לנהל את פרופיל העסק שלהם ב-Google.
• מפעילים את סוג השירות LocalListingManagement ב-AccountService, שמקשר קבוצת עסקים שמשמשת לפרסום מודעות מלאי של חנויות מקומיות או כרטיסים חינמיים למוצרים מקומיים.

Week of Apr 28, 2025

• השקנו את המשאבים AccountService ו-AccountRelationship, שמאפשרים למשתמשי API לנהל קשרים ולהגדיר שירותים לספקי שירותים.

השבוע שמתחיל ב-14 באפריל 2025

• ‫TermsOfServiceService.AcceptTermsOfService מחזירה עכשיו את TermsOfServiceAgremeentState שאושרה, עטופה בסוג תגובה.

• הפועל של הפעולה TermsOfServiceService.AcceptTermsOfService הוא עכשיו POST (היה GET).

• הוספנו הבהרה שלפיה צריך לקרוא ל-AccountsService.ListSubAccounts באמצעות הפורמט accounts/... (ולא providers/...). זאת כדי למנוע מצב שבו השיטה הזו לא נכללת בהיקף של accounts (כלומר GET accounts/123:listSubAccounts ולא GET providers/123:listSubAccounts).

השבוע שמתחיל ב-31 במרץ 2025

• לגבי סינון חשבונות, הודענו על הוצאה משימוש של המסנן externalAccountId בשבוע שמתחיל ב-2 בדצמבר 2024, והוא לא זמין יותר. המשמעות היא שעכשיו אפשר לסנן לפי externalAccountId רק ברמה service. מסנן כמו relationship(externalAccountId = "foo") לא יפעל יותר וצריך להשתמש במקומו ב-relationship(service(externalAccountId = "foo")).

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

השבוע שמתחיל ב-3 במרץ 2025

– accounts.onlineReturnPolicies#SeasonalOverride עבר שינוי מבנה כדי לשפר את הבהירות והעקביות. העדכונים האלה כוללים:

• שינוי שם השדה:
  • ‫begin נקרא עכשיו start_date.
  • ‫end נקרא עכשיו end_date.
• הסרת שדה:
  • השדה policy שיצא משימוש הוסר.

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

השקה של השירות AutomaticImprovements שבו אפשר להשתמש כדי לנהל את הפעולות הבאות:

• עדכונים של פריטים
• שיפור תמונות
• שיפורים במשלוח

מידע נוסף זמין במאמר בנושא הפעלת שיפורים אוטומטיים.

השבוע שמתחיל ב-17 בפברואר 2025

הוסר התנאי callerHasAccessToProviderFilter() ממסנן החשבון.

השבוע שמתחיל ב-10 בפברואר 2025

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

• הוספנו הגדרת תפוגה של 10 דקות כברירת מחדל לכל שיטות ה-RPC.

• הוספתי את רשימת שמות התוכניות הזמינות לתיאור המשאב accounts.programs.

• הערך User.accessRights הוא עכשיו REQUIRED, וזה משפיע על השיטות UserService.Create ו-AccountsService.CreateAndConfigure.

השבוע שמתחיל ב-27 בינואר 2025

‫AccountsService.ListAccounts (ובאופן טרנזיטיבי AccountsService.ListSubAccounts) מחזירות עכשיו חשבונות באופן עקבי בסופו של דבר, ולא כקריאה חזקה.

השבוע שמתחיל ב-20 בינואר 2025

השדה users של CreateAndConfigureAccountRequest הוצא משימוש והוחלף ב-user חדש. השדה CreateUserRequest שאליו הייתה הפניה מכיל את השדה parent שלא נדרש בהקשר של CreateAndConfigureAccountRequest.

השבוע שמתחיל ב-6 בינואר 2025

השדה user של ההודעה CreateUserRequest מסומן עכשיו בצורה נכונה כ-OPTIONAL.

השדה domain בשגיאות שמוחזרות מאוכלס עכשיו בערך merchantapi.googleapis.com במקום global

השבוע שמתחיל ב-2 בדצמבר 2024

כשמסננים חשבונות, פרדיקט externalAccountId מועבר מרמה relationship לרמה service. לכן, מסנן relationship(externalAccountId = "foo") צריך להיכתב עכשיו כ-relationship(service(externalAccountId = "foo")). הפורמט הישן עדיין נתמך לצורך תאימות לאחור, אבל הוא הוצא משימוש ויחזיר שגיאה בעתיד הקרוב. בכל המסמכים יצוין רק הפורמט החדש.

השבוע שמתחיל ב-18 בנובמבר 2024

הספק בשדה CreateAndConfigureAccountRequest.service.provider יכול להיות גם אחד מהערכים providers/GOOGLE_ADS או providers/GOOGLE_BUSINESS_PROFILE. חשבונות אחרים צריכים להיות מסומנים כ-providers/123 (ולא כ-accounts/123). המשמעות היא שהשדה לא מסומן יותר כהפניה לחשבון. עם זאת, עדיין אפשר להשתמש בשמות חשבונות כמו accounts/123 לצורך תאימות לדורות קודמים.

הספק ב-ListSubAccountsRequest צריך להיות עכשיו בפורמט providers/123, אבל כדי לשמור על תאימות לאחור, עדיין אפשר להשתמש ב-accounts/123.

השבוע שמתחיל ב-4 בנובמבר 2024

סימון promotions_consent REQUIRED (מ-OPTIONAL) במשאב BusinessIdentity. השינוי הזה משפיע רק על שיטת העדכון. העדכון הזה נועד להבהיר שאי אפשר לעדכן את promotions_consent ל-UNSPECIFIED. הפעולה הזו לא הייתה אפשרית גם קודם, אבל עכשיו השגיאה יותר תיאורית והשדה מסומן בצורה נכונה.

השבוע שמתחיל ב-28 באוקטובר 2024

שיפור התיעוד של משאבים שונים ב-Accounts sub-API, כמו User,‏ Homepage,‏ BusinessInfo וכן הלאה.

השבוע שמתחיל ב-21 באוקטובר 2024

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

נוסף קישור למרכז העזרה של Google לעסק שלי עבור ספקים נתמכים למסמך החיצוני של משאב ShippingSettings

השבוע שמתחיל ב-14 באוקטובר 2024

סימון של provider כREQUIRED ב-AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

להפוך את update_mask לאופציונלי בכל ממשק המשנה של API לחשבונות (למשל: זהות עסקית, פרטי עסק, דף בית וכו') וגם באופן רטרואקטיבי במשאב ConversionSources.

הפרמטר overwrite נוסף אל ClaimHomepageRequest.

השבוע שמתחיל ב-30 בספטמבר 2024

השקת הפרמטר 'force' לשיטה 'Accounts.delete'.

השבוע שמתחיל ב-23 בספטמבר 2024

סימון של region_code ו-kind כ-REQUIRED ב-RetrieveLatestTermsOfServiceRequest.

השבוע שמתחיל ב-16 בספטמבר 2024

הסוג של הפרמטר time_zone השתנה למחרוזת ב-ListAccountIssuesRequest

השבוע שמתחיל ב-12 באוגוסט 2024

נוסף שדה korean_business_registration_number למשאב BusinessInfo.

השבוע שמתחיל ב-27 במאי 2024

השקת גרסת בטא של Accounts sub-API