Business Information API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יומן שינויים
v1
גישה ל-API
צריך להפעיל את Business Information API דרך מסוף GCP. היקף הרשאת ה-OAuth לא ישתנה.
כתובת URL של נקודת קצה
נקודות הקצה לחיפוש של כל פרטי העסק, המאפיינים, הקטגוריות, הרשתות והמיקומים זמינות בכתובת https://mybusinessbusinessinformation.googleapis.com/v1/ במקום בכתובת https://mybusiness.googleapis.com/v4/
שם הנתיב של נקודות הקצה של מיקומים השתנה מ-accounts/accountId/locations/locationId ל-locations/locationId
עדכוני מיקום
- השם של
locationName השתנה ל-title.
- השם של
websiteUrl השתנה ל-websiteUri.
- עכשיו נדרש readMask עבור
accounts.locations.list ו-locations.get.
primaryPhone ו-additionalPhones נכללים עכשיו בקבוצה PhoneNumbers.primaryCategory ו-additionalCategories נכללים עכשיו בקטגוריות.- השם של
address השתנה ל-storefrontAddress.
- הפרטים של
accounts.locations.clearAssociation עודכנו ל-locations.clearLocationAssociation.
serviceItems נקרא ומתעדכן עכשיו ישירות מאובייקט המיקום.
מאפיינים
- אובייקט
Attributes חדש ונקודת הקצה (endpoint) התואמת locations.attributes.getGoogleUpdated כדי לקבל את הגרסה המעודכנת של Google.
- ל-
attributes.list יש פרמטר show_all שמאפשר ללקוחות לראות את כל המאפיינים השונים שאפשר להגדיר לשילוב ספציפי של קטגוריה ואזור.
עסקים שנותנים שירות באזור מוגדר
- עסקים מסוג
CUSTOMER_LOCATION_ONLY כבר לא צריכים למלא כתובת.
- הוספת
regionCode ב-ServiceAreaBusiness.
צריך להגדיר אותו לעסקים מסוג CUSTOMER_LOCATION_ONLY.
אובייקטים ונקודות קצה (endpoint) שהוצאו משימוש
- הסרת האובייקט
LocationKey. השדות הקיימים הועברו אל מטא-נתונים.
- הסרת האובייקט
PriceLists. הוא הוחלף ב-FoodMenus וב-ServiceLists.
- הסרת האובייקט
LocationState. רוב השדות הקיימים הועברו אל מטא-נתונים. המטא-נתונים מכילים ערך בוליאני שקובע אם למוכרים יש שליטה מלאה בעסק (קול המוכרים), אבל שדות מפורטים יותר שקשורים להשעיה ולאימות הועברו ל-Verifications API. כדי לקבל את הקול של המוכר, משתמשים בשיטה locations.getVoiceOfMerchantState בשלבים הבאים.
- נקודות הקצה
googleLocations.report ו-accounts.locations.findMatchingLocations הוצאו משימוש.
- נקודת הקצה (endpoint)
TransferLocation הועברה אל locations.transfer במסגרת Account Management API.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["The Business Information API now uses `https://mybusinessbusinessinformation.googleapis.com/v1/` as the base endpoint and requires enabling in the GCP Console."],["Location data structure has been updated, renaming or relocating fields like `locationName`, `websiteUrl`, `primaryPhone`, `primaryCategory`, and `address`."],["A new `Attributes` object and `getGoogleUpdated` endpoint have been introduced for managing business attributes, and `attributes.list` now includes a `show_all` parameter."],["Service area businesses (`CUSTOMER_LOCATION_ONLY`) no longer require an address but need a `regionCode`, while `LocationKey`, `PriceLists`, and `LocationState` objects are deprecated."],["Some endpoints have been moved or deprecated, including `googleLocations.report`, `accounts.locations.findMatchingLocations`, and `TransferLocation`."]]],["The Business Information API requires enabling in the GCP Console, with a new endpoint URL: `https://mybusinessbusinessinformation.googleapis.com/v1/`. Location endpoints' path changed to `locations/locationId`. Updates include renaming fields like `locationName` to `title` and incorporating `PhoneNumbers` and `Categories`. `Attributes` now includes a `getGoogleUpdated` endpoint, with `show_all` parameter. Service area businesses (type `CUSTOMER_LOCATION_ONLY`) now require `regionCode`. Deprecated objects include `LocationKey`, `PriceLists`, `LocationState`, and removed endpoints `googleLocations.report`, `accounts.locations.findMatchingLocations`, and `TransferLocation` moved.\n"]]
