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

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

• השקנו משאב של מדיניות החזרת מוצרים באינטרנט, שמאפשר למשתמשי 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() ממסנן החשבון.

Week of Feb 10, 2025

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

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

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

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

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

‫AccountsService.ListAccounts (and transitively 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

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

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

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

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

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

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

הופכים את update_mask לאופציונלי בכל ממשק ה-API המשני של Accounts (למשל: זהות העסק, פרטי העסק, דף הבית וכו') וגם באופן רטרואקטיבי עבור משאב 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