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 物件。大多數現有欄位已移至「中繼資料」。雖然「Metadata」包含布林值，可用來查看商家是否擁有商家 (商家聲音) 的完整控制權，但與停權和驗證相關的詳細欄位已移至 Verifications API。如要取得商家語音，請在後續步驟中使用 locations.getVoiceOfMerchantState 方法。
  • 端點 googleLocations.report 和 accounts.locations.findMatchingLocations 已淘汰。
  • TransferLocation 端點已移至 Account Management API 下的 locations.transfer。