Business Information API

יומן שינויים

v1

גישה ל-API

צריך להפעיל את Business Information API ממסוף GCP. היקף ההרשאות של OAuth לא השתנה.

כתובת URL של נקודת קצה (endpoint)

אפשר לגשת לנקודות הקצה (endpoints) של כל פרטי העסק, המאפיינים, הקטגוריות, הרשתות או המיקומים בחיפוש ב-https://mybusinessbusinessinformation.googleapis.com/v1/, במקום ב-https://mybusiness.googleapis.com/v4/

שם הנתיב של נקודות הקצה של מיקומים השתנה מ-accounts/accountId/locations/locationId ל-locations/locationId

עדכוני מיקום

  • השם של locationName השתנה ל-title.
  • השם של websiteUrl השתנה ל-websiteUri.
  • ל-accounts.locations.list ול-locations.get נדרשת עכשיו ReadMask.
  • primaryPhone ו-additionalPhones שייכים עכשיו ל-PhoneNumbers.
  • primaryCategory ו-additionalCategories שייכים עכשיו ל-קטגוריות.
  • השם של address השתנה ל-storefrontAddress.
  • השדה accounts.locations.clearAssociation עודכן ועכשיו הוא locations.clearLocationAssociation.
  • serviceItems נקראים עכשיו ומעודכנים ישירות מהאובייקט 'מיקום'.

מאפיינים

  • אובייקט Attributes חדש ונקודת הקצה locations.attributes.getGoogleUpdated התואמת כדי לקבל את הגרסה המעודכנת של Google.
  • ל-attributes.list יש פרמטר show_all שמאפשר ללקוחות לראות את כל המאפיינים השונים שאפשר להגדיר לשילוב מסוים של קטגוריה ואזור.

עסקים באזור שירות

  • עסקים מסוג CUSTOMER_LOCATION_ONLY כבר לא נדרשים למלא כתובת.
  • הוספה של regionCode ב-ServiceAreaBusiness. חובה להגדיר אותה לעסקים מסוג CUSTOMER_LOCATION_ONLY.

נקודות קצה ואובייקטים שהוצאו משימוש

  • הסרת אובייקט LocationKey. השדות הקיימים הועברו לקטע Metadata.
  • הסרת אובייקט PriceLists. הוא הוחלף ב-Foodmenus וב-ServiceLists.
  • הסרת אובייקט LocationState. רוב השדות הקיימים הועברו למטא-נתונים. המטא-נתונים מכילים ערך בוליאני שמאפשר לראות אם למוכר יש שליטה מלאה בעסק (קול של מוכר), אבל שדות מפורטים יותר שקשורים להשעיה ואימות הועברו ל-Authentications API. בשלבים הבאים צריך להשתמש בשיטה locations.getVoiceOfMerchantState כדי להשמיע את קול המוכר.
  • נקודות הקצה googleLocations.report ו-accounts.locations.findMatchingLocations הוצאו משימוש.
  • נקודת הקצה TransferLocation הועברה אל locations.transfer במסגרת Account Management API.