שנה רישום

v4.9

תכונות חדשות

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

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

הוצאה משימוש של חשבונות בגרסה 4.x
החל מהיום, ה-API של 'Google עסק שלי' לא תומך יותר ב-
accounts, ב-accounts.admins, ב-accounts.invitations וב-accounts.locations.admins. מידע נוסף זמין ביומן השינויים בנושא הוצאה משימוש.
פוסטים עם קריאה לפעולה
ברבעון השני של שנת 2021, CallToAction פוסטים עם הקוד GET_OFFER ActionType לא יהיו תקפים יותר.

v4.8

תכונות חדשות

שירותי המלון
אחזור ועדכון של שירותי המלון. מידע נוסף
הוספה של נקודת הקצה GetGoogleUpdated לענף 'אירוח'.
הוספת ערך בוליאני canOperateLodgingData ב-LocationState
מאפיינים של ספק שירותי בריאות
אחזור ועדכון של HealthProviderAttributes. מידע נוסף
הוספת ערך בוליאני של canOperateHealthData ב-LocationState
רשתות ביטוח
רשימת רשתות הביטוח שאושרו לפי מיקומים. מידע נוסף

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

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

v4.7

תכונות חדשות

תפריטי מזון
אחזור ועדכון של FoodMenus. מידע נוסף

v4.6

תכונות חדשות

רשימות שירותים
עכשיו אפשר לאחזר ולעדכן את השירותים שהעסק מציע. מידע נוסף
הוספת ערך בוליאני canModifyServiceList ב-LocationState
הערך הזה מציין אם מיקום מסוים עומד בדרישות לשינוי רשימות שירותיםמידע נוסף
ServiceTypes מוגדר מראש לקטגוריות
סוגי שירות מוגדרים מראש כלולים עכשיו באובייקט categories.מידע נוסף
CategoryView
יכולת לציין תצוגה מסוג BASIC או FULL לקטגוריות. בתצוגה FULL יוצגו פרטים נוספים, כמו סוגי השירותים. מידע נוסף
השיטה Categories.BatchGet
השיטה החדשה הזו מאפשרת להזין רשימה של קטגוריות ומחזירה מידע על הקטגוריות האלה בלבד. מידע נוסף

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

תכונות חדשות

סוג הפוסט 'התראה בנוגע לנגיף הקורונה (COVID-19)'
עכשיו אפשר ליצור פוסט COVID_19 דרך ה-API. מידע נוסף

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

תכונות חדשות

סגור זמנית
עכשיו אפשר להגדיר עסק כ-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 של שאלות ותשובות
אפשר לאחזר שאלות, לפרסם תשובות ולספק שאלות נפוצות לגבי המיקומים של העסק. מידע נוסף
קריאת ביקורות בכמות גדולה
אחזור ביקורות על כמה מיקומים בקריאה אחת. מידע נוסף
המלצות ל-GoogleLocations
לראות מיקומים שלא הוגשה עליהם תלונה, שלדעת Google יכולים להיות בבעלותכם. מידע נוסף
דיווח על בעיות ב-GoogleLocation
דיווח על בעיות בתוצאות של RecommendedGoogleLocations או GoogleLocations. מידע נוסף
Service 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.
סינון התראות/הסכמה לקבלת התראות
עכשיו אפשר לסנן את ההתראות שנשלחות לנושאי pubsub. בהתראות עתידיות, המנגנון הזה ישמש לקבלת הסכמה במקום לשלוח את ההתראות לכל המשתמשים.
UPDATED_REVIEW התראות
עכשיו אפשר להירשם לקבלת התראות בזמן אמת על עדכונים בביקורות של לקוחות.
תמיכה בקבוצות של משתמשים
Google My Business API תומך עכשיו בחשבונות מסוג 'קבוצת משתמשים'.

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

  • התמונות, שהיו בעבר שדה של אובייקטים מסוג location, הן עכשיו משאב בקטגוריית המיקום (accounts/account_ID/locations/location_ID/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 במערך הערכים של הבעלות שיצאה משימוש רלוונטי עכשיו רק אם לאותו בעלים ראשי יש גם את המיקום שהעותק הכפול שלו נוצר. בעבר, ההתנהגות הייתה מבוססת על חישוב בעלות מורכב יותר.

v3.1

תכונות חדשות

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

v3

תכונות חדשות

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

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

  • מעכשיו אפשר לעדכן תמונות רק למיקומים שיש להם דף ב-Google+ (בעבר התמונות האלה התקבלו ונמחקו בשקט).

  • השדות location_name ו-category_name הם עכשיו פלט בלבד. משתמשים במזהי קטגוריות רק כשמגדירים קטגוריות.

  • לא צריך לכלול יותר את הקידומת location. במסכות השדות של השדות הכלולים.

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

v2

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

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

    • השם של business_hours בקטע מיקום השתנה ל-regular_hours.