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

השבוע שמתחיל ב-28 בספטמבר 2026

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

השבוע שמתחיל ב-3 באוגוסט 2026

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

השבוע שמתחיל ב-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 ליצור, לעדכן, למחוק ולקבל את הגדרות הדף 'תשלום'.

השבוע שמתחיל ב-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

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