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

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

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

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

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

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

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

  • נוסף שירות ComparisonShopping למשאב 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) של CampaignManagementServices 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 מוגבל למשתמשי אדמין.

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

  • השקנו את המשאב Online Return Policy (מדיניות החזרת מוצרים אונליין), שמאפשר למשתמשי API ליצור, לעדכן ולמחוק מדיניות החזרת מוצרים.
  • השקנו את OmnichannelSettingsService ואת המשאב OmnichannelSetting, שמאפשרים למשתמשי API לנהל את חוויית השימוש שלהם בכל הערוצים.
  • השקנו את LfpProvidersService ואת המשאב LfpProvider, שמאפשרים למשתמשי API לנהל את השותפות שלהם עם Local Feeds.
  • השקנו את 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, וזה משפיע על ה-methods‏ 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 לאופציונלי בכל ממשקי המשנה של Accounts 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