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

השבוע של 26 באוקטובר 2026

• הבהרנו את מסמכי התיעוד של השיטה accounts.homepage.unclaim ואת השדה claimed של המשאב Homepage. אם חשבון יורש את תביעת הבעלות על דף הבית מהחשבון המתקדם שלו, unclaim מחזירה תגובה מוצלחת, אבל תביעת הבעלות על דף הבית נשארת. אם החשבון עצמו פטור מהצהרה, unclaim מחזיר שגיאת FAILED_PRECONDITION.

השבוע של 28 בספטמבר 2026

• הוספנו את youtube_affiliate_management כסוג שירות למשאב AccountService ב-v1alpha. הערה: הגישה לתכונה "ניהול שותפים עצמאיים ב-YouTube" מוגבלת.

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

• הוספנו את השדה home_page_uri לקריאה בלבד למשאב accounts כדי להחזיר את ה-URI של דף הבית של החנות.

השבוע של 3 באוגוסט 2026

• הוספנו את ucp_checkout_management כסוג שירות למשאב של שירות החשבון. הערה: הגישה לתכונה "דף תשלום בפלטפורמת התשלומים המאוחדת" מוגבלת.
• הוספנו תמיכה בתוכנית ucp-integration (גישה מוגבלת).
• הוספנו תמיכה בסוג התנאים וההגבלות ucp_integration.

השבוע של 29 ביוני 2026

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

השבוע של 20 באפריל 2026

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

השבוע של 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) של Region ב-Regions API, שיאפשר למוכרים ליצור אזור באמצעות רדיוס.

‫השבוע של 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 מוגבלות למשתמשים עם הרשאת אדמין.

השבוע של 12 במאי 2025

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

השבוע של 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 מועבר לרמה service מהרמה relationship. לכן, מסנן כמו 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