Business Information API

變更記錄檔

v1

API 存取權

但需透過 GCP 控制台啟用 Business Information API。OAuth 範圍則維持不變。

端點網址

所有商家資訊、屬性、類別、連鎖店和地點搜尋的端點都可透過 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 現在可直接從 Location 物件讀取及更新。

屬性

• 新增 Attributes 物件和對應的 locations.attributes.getGoogleUpdated 端點，以取得 Google 更新版本。
• attributes.list 提供 show_all 參數，可讓用戶端查看為特定類別和區域組合設定的所有屬性。

區域服務商家

• CUSTOMER_LOCATION_ONLY 類型的商家不再需要填寫地址。
• 在 ServiceAreaBusiness 中新增 regionCode。必須為CUSTOMER_LOCATION_ONLY類型的商家設定此模式。

已淘汰的端點和物件

• 移除 LocationKey 個物件。現有欄位已移至中繼資料中。
• 移除 PriceLists 個物件。已由 FoodMenus 和 ServiceLists 取代。
• 移除 LocationState 個物件。大部分現有欄位已移至中繼資料頁面。雖然中繼資料內的布林值可指出商家是否擁有商家的完整控制權 (商家語音)，但詳細的停權資訊和驗證相關欄位已移至 Verifications API。使用 locations.getVoiceOfMerchantState 方法完成後續步驟，以便接收商家的語音。
• 端點 googleLocations.report 和 accounts.locations.findMatchingLocations 已淘汰。
• TransferLocation 端點已移至 Account Management API 下的 locations.transfer。