שנה רישום

v4.9

תכונות חדשות

2026-04-20

‫Review Media Items: עכשיו אפשר לאחזר את ReviewMediaItems כחלק מהביקורות. ReviewMediaItems אפשר לאחזר באמצעות accounts.locations.reviews.get, accounts.locations.reviews.list, ו- accounts.locations.batchGetReviews.

2026-04-07

‫Recurrence Info: עכשיו אפשר לתזמן פוסטים חוזרים על ידי הגדרת RecurrenceInfo כשיוצרים LocalPost

‫Food Menus: עכשיו אפשר לנהל עד 200 תמונות של מנות בתפריטים של מסעדות באמצעות accounts.locations.updateFoodMenus

2026-04-01

‫Review Reply State: ReviewReplyState can now be retrieved as part of reviews. ReviewReplyState אפשר לאחזר באמצעות accounts.locations.reviews.get,‏ accounts.locations.reviews.list ו-accounts.locations.batchGetReviews. הוא מספק יותר שקיפות לגבי סטטוס הבדיקה של התשובות ששלחתם לביקורות.

2021-02-24

MoreHours : אפשר להגדיר עכשיו את MoreHours כחלק מפרופיל העסק. ‫: MoreHourTypes אפשר לאחזר לכל קטגוריה באמצעות categories.batchGet.

שינויים התנהגותיים

הוצאה משימוש של חשבונות בגרסה 4.x
השיטות
accounts, accounts.admins, accounts.invitations, and accounts.locations.admins יצאו משימוש ב-Google My Business API. מידע נוסף זמין במאמר בנושא יציאה משימוש.
פוסטים עם קריאה לפעולה

ברבעון השני של 2021, CallToAction פוסטים עם

הערך GET_OFFER ActionType לא יהיה תקף יותר.

v4.8

תכונות חדשות

Lodging Amenities : Retrieval and update of Lodging Amenities. מידע נוסף : הוספה של נקודת הקצה GetGoogleUpdated למקומות לינה. ‫: נוסף ערך בוליאני canOperateLodgingData ב-LocationState

מאפיינים של ספקי שירותים רפואיים : שליפה ועדכון של HealthProviderAttributes. מידע נוסף: הוספה של ערך בוליאני canOperateHealthData ב-LocationState

רשתות ביטוח: : רשימה רשתות ביטוח שאושרו על ידי המיקומים. מידע נוסף

שינויים התנהגותיים

מזהי ביקורות
מזהי הביקורות הועברו לפורמט חדש. המזהה החדש הזה יוחזר עכשיו בכל תגובות ה-API הרלוונטיות. במשך תקופה קצרה, עדיין תהיה אפשרות להשתמש במזהי ביקורות ישנים כדי לקרוא ל-API, אבל חשוב מאוד לרענן את כל מזהי הביקורות שמאוחסנים במערכת תוך 30 ימים, בהתאם לדרישות המדיניות שלנו, באמצעות קריאה לנקודת הקצה listReviews.
עסק שנותן שירות באזור מוגדר (SAB)

ברבעון הראשון של 2021, הערך Address לא יוחזר יותר ב

אובייקט Location של עסקים CUSTOMER_LOCATION_ONLY.

v4.7

תכונות חדשות

תפריטי אוכל: : שליפה ו עדכון של תפריטי אוכל. מידע נוסף

v4.6

תכונות חדשות

רשימות שירותים

עכשיו אפשר

שליפה ועדכון של השירותים שעסק מציע. מידע נוסף

הוספה של ערך בוליאני canModifyServiceList ב-LocationState

מציין אם מיקום עומד בדרישות לשינוי רשימות השירותים מידע נוסף

ServiceTypes מוגדרות מראש לקטגוריות

סוגי שירותים מוגדרים מראש נכללים עכשיו באובייקט categories. מידע נוסף

CategoryView

אפשרות לציין תצוגה של BASIC או FULL לקטגוריות. בתצוגה FULL יופיעו פרטים נוספים כמו סוגי שירותים. מידע נוסף

‫Categories.BatchGet Method

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

גרסה 4.5 עדכון 2 בנושא נגיף הקורונה (COVID-19)

תכונות חדשות

סוג הפוסט בנושא התראה בנוגע לנגיף הקורונה (COVID-19)

עכשיו אפשר ליצור COVID_19פוסט באמצעות ה-API.

מידע נוסף

‫v4.5 COVID-19 Update 1

תכונות חדשות

סגור זמנית
עכשיו אפשר להגדיר עסק כ-CLOSED_TEMPORARILY באמצעות ה-API. מידע נוסף.

v4.5

תכונות חדשות

Pub/Sub לשאלות ותשובות
עכשיו אפשר לקבל התראות מ-Google Cloud Pub/Sub על שאלות ותשובות חדשות או מעודכנות לגבי מיקום. מידע נוסף.
Pub/Sub לסטטוס כרטיס המוצר
מעכשיו אפשר לקבל התראות מ-Google Cloud Pub/Sub על שינוי במצב של כרטיס המוצר. מידע נוסף.

v4.4

תכונות חדשות

אימות של עסקים שמספקים שירותים מקומיים
עכשיו אפשר לאמת עסקים שמספקים שירותים מקומיים באמצעות ה-API. מידע נוסף.
מספר העוקבים

עכשיו אפשר לאחזר מטא-נתונים על העוקבים.

מידע נוסף

קבוצות משתמשים וקבוצות לפי מיקום

מעכשיו אפשר ליצור קבוצות משתמשים וקבוצות לפי מיקום באמצעות ה-API. מידע נוסף

הוספה של השדה hasPendingEdits ב-LocationState

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

שינויים בהתנהגות

תאריך פתוח
עכשיו אפשר להגדיר תאריך פתיחה עתידי לכרטיס מידע.

PointRadius : PointRadius הוא עכשיו לקריאה בלבד. כדי לערוך עסקים מקומיים או ליצור אותם, צריך להשתמש ב-Places.

v4.3

תכונות חדשות

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

אחזור ביקורות של כמה מיקומים בקריאה אחת.

מידע נוסף

‫RecommendedGoogleLocations

לראות מיקומים לא מאומתים שלדעת Google יכול להיות שהם בבעלותכם. מידע נוסף

דיווח על בעיות ב-GoogleLocation

אפשר לדווח על בעיות בתוצאות של RecommendedGoogleLocations או של GoogleLocations. מידע נוסף

מניה (Enum) של שירותים בקטע PriceList

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

תיאור המדיה

הוספת כתוביות כשמעלים מדיה חדשה.

מידע נוסף

CHAINS_QUERIES תובנות

אחזור מספר הפעמים שמיקום הוצג כתוצאה מחיפוש של הרשת שהוא שייך לה. מידע נוסף

שינויים בהתנהגות

התראות לחשבונות ארגוניים ולקבוצות מיקומים
חשבונות שהוגדרו לקבלת התראות Pub/Sub יקבלו עכשיו גם את ההתראות האלה על כל כרטיסי המוצר שנכללים בחשבון ארגוני או בקבוצות מיקומים שהם אדמינים שלהם.
‫ListLocations לחשבון ארגוני ולקבוצות לפי מיקום
‫
accounts.locations.list נקראת עם קבוצת משתמשים או חשבון ארגוני, מוצגים עכשיו כל המיקומים שאפשר לגשת אליהם דרך החשבון הזה.

v4.2

תכונות חדשות

ממשקי API לאימות
רשימה של שיטות האימות הזמינות והפעלתן למיקומים שלא אומתו. מידע נוסף.
GoogleLocations API
חיפוש מיקומים קיימים ב-Google כדי לתבוע בעלות, או אחזור קישור לבקשת גישה למיקומים שתבעתם עליהם בעלות. מידע נוסף.
מסנני מיקום מורחבים
אפשרויות נוספות להגבלת התוצאות שמוחזרות מקריאה ל-Locations.List. מידע נוסף.
מינוי לרשת
מציינים אם המיקום הוא חלק מרשת (לדוגמה, Walmart, ‏ Target וכו'). מידע נוסף
פרטי ארגון
המידע על חשבונות ארגוניים יוצג עכשיו כחלק מאובייקטים של חשבונות. מידע נוסף.
תמונת הפרופיל של כותב הביקורת
כתובות ה-URL של תמונות הפרופיל של כותבי הביקורות נכללות עכשיו באובייקט הביקורת. מידע נוסף.

v4.1

תכונות חדשות

מדיה שהלקוח סיפק
עכשיו אפשר לאחזר תובנות לגבי תמונות וסרטונים שנוצרו על ידי משתמשים במיקומים שבבעלותכם ובניהולכם, ולצפות בהן. מידע נוסף.
Admin Management APIs
מעכשיו אפשר לראות את ההזמנות שקשורות לחשבון ולמיקום, ולאשר או לדחות אותן. מידע נוסף.
‫Profile (תיאור שסופק על ידי המוכר)
תארו את העסק במילים שלכם ושתפו עם המשתמשים את הסיפור הייחודי של העסק והמוצרים או השירותים שהוא מציע. מידע נוסף
openingDate שדה

צריך לציין את התאריך שבו המיקום נפתח לעסקים.

מידע נוסף

פוסטים על מבצעים

סוג חדש של פוסט ב-Google, שעוזר למשתמשים למצוא מבצעים שזמינים במיקומים שלכם. מידע נוסף

v4

תכונות חדשות

פוסטים ב-Google
עכשיו אפשר ליצור פוסטים ב-Google ישירות דרך ה-API.
העלאת תמונה
עכשיו אפשר להעלות תמונות ישירות באמצעות ה-API, בנוסף להעלאה באמצעות כתובת URL שקיימת כבר.
סינון התראות/הבעת הסכמה לקבלת התראות
עכשיו אפשר לסנן את ההתראות שנשלחות לנושאים ב-Pub/Sub. התראות עתידיות יתבססו על המנגנון הזה כדי לאפשר למשתמשים להביע הסכמה לקבלת התראות, במקום לשלוח אותן לכל המשתמשים.
UPDATED_REVIEW התראות
עכשיו אפשר להירשם לקבלת עדכונים בזמן אמת על ביקורות של לקוחות.
תמיכה בקבוצות משתמשים
‫Google My Business API תומך עכשיו בחשבונות מסוג קבוצת משתמשים.

שינויים שגורמים לחוסר תאימות לגרסאות קודמות

  • התמונות, שהיו בעבר שדה של אובייקטים מסוג location, הן עכשיו משאב במיקום (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/photos).
  • השדה 'כתובת' Country הוא עכשיו region_code, והשדה sub_locality הוא עכשיו sublocality.
  • הוסר השדה Ownership שהוצא משימוש בעבר.
  • בעבר, אי אפשר היה להבחין בין בעלים שותפים של חשבונות ומיקומים לבין בעלים ראשיים דרך ה-API (כולם הופיעו בתור OWNER). עכשיו, לבעלים ראשיים יוקצה התפקיד OWNER ולבעלים אחרים יוקצה התפקיד CO_OWNER.
  • האפליקציה AccountType.BUSINESS נקראת עכשיו AccountType.LOCATION_GROUP.
  • כשמשתמשים במסכת שדות כדי לעדכן מיקומים, צריך לציין update_mask במקום field_mask הקיים.
  • ההודעה על הקטגוריה שמשמשת ל-primary_category ול-additional_categories כבר לא מכילה את הטופס שקריא למשתמשים. משתמשים צריכים להשתמש בשירות הקטגוריות של Google My Business API כדי לקבל שמות קטגוריות מתורגמים שניתן לקרוא אותם.

v3.3

תכונות חדשות

תפריטים מובנים

עכשיו אפשר להוסיף, לעדכן או למחוק:

  • כמה תפריטים במיקום נתון
  • הוספת כמה קטגוריות לתפריט
  • רשימת פריטים בתפריט עם שם, תיאור, מחיר ותמונות

v3.2

תכונות חדשות

תובנות
עכשיו אפשר לאחזר תובנות על המיקום ומדדי נסיעה באמצעות ה-API.
התראות
עכשיו אפשר להירשם לקבלת התראות בזמן אמת על עדכונים חדשים של Google.

שינויים שגורמים לחוסר תאימות לגרסאות קודמות

  • הוסרו השדות languageCodes ו-platforms של UrlAttributeValue שלא נעשה בהם שימוש בעבר.
  • SAME ב-enum של הבעלות שהוצא משימוש חל עכשיו רק אם למיקום שמשוכפל יש את אותו בעלים ראשי. בעבר, ההתנהגות של המערכת התבססה על חישוב בעלות מורכב יותר.

v3.1

תכונות חדשות

התראות
מעכשיו אפשר להירשם לקבלת התראות בזמן אמת על ביקורות חדשות.
כתובות URL של מפות Google
כתובות URL של מפות Google נכללות בתשובות לגבי מיקומים, כדי לאפשר למשתמשים לקשר למפות Google.
סטטוסים של מיקומים
מצבי מיקום נוספים שמציינים מתי הדף העסקי מתפרסם, מושבת או בהמתנה לאימות.
פתיחה מחדש של סימון
הדגל
canReopen מציין מיקומים שסגורים לצמיתות שאפשר לפתוח מחדש, לעומת מיקומים שאי אפשר לפתוח מחדש.
מאפיינים
תמיכה במאפייני URL ו-Enum.
נקודת קצה של קטגוריה
קבלת רשימה של קטגוריות נתמכות לפי מדינה ושפה (מחליף קובצי CSV).

v3

תכונות חדשות

ביקורות
עכשיו אפשר לאחזר ביקורות על עסקים ולהשיב להן דרך ה-API.
מאפיינים
לספק מידע נוסף על מיקומים, שספציפי לקטגוריה.
חיפוש מיקום תואם
חיפוש מיקומים קיימים במפות ושיוך ידני שלהם למיקום העסק.
מיקום ההעברה
פעולה חדשה ב-Location :transfer. מאפשר להעביר מיקום מחשבון אחד (עסקי או אישי) לחשבון אחר.
התמונה המועדפת
מציינים איזו תמונה רוצים שתופיע ראשונה בחיפוש Google ובמפות Google.
מסנני חיפוש חדשים
מסנני חיפוש חדשים כוללים את any_google_updates,‏ is_suspended ו-is_duplicate.
סטטוסים חדשים של מיקומים
בנוסף, מצבי המיקום ב-
כוללים עכשיו גם את is_verified ואת needs_reverification.
שיפורים בכתובות ה-URL של התמונות
ממשק ה-API מקבל עכשיו כתובות URL של תמונות ללא סיומת של פורמט תמונה.

שינויים שגורמים לחוסר תאימות לגרסאות קודמות

  • עכשיו צריך לציין request_id בקריאות ל-CreateLocation המזהה הזה צריך להיות ייחודי לכל מיקום, והוא עוזר למנוע יצירה של מיקומים כפולים בחשבון. ניסיונות ליצור מיקום שבו מזהה הבקשה תואם למיקום שנוצר בעבר יחזירו את המיקום הקיים, וימנעו יצירת כפילות בחשבון.
  • business_hours במיקום שונה לregular_hours.