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

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

• פרסום גרסה v1alpha של Services API.
• השקת השדה החדש product_filters במטען הייעודי (payload) של CampaignManagementServices 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

• עדכנו את התיעוד של 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 ומשפיע על השיטות 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.

Week of Nov 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