變更記錄

v4.9

新功能

MoreHours
你現在可以在商家資訊中設定「更多營業時間」MoreHours。
您可以使用 categories.batchGet 擷取每個類別的 MoreHourTypes。

行為變更

v4.x 帳戶淘汰
accounts、accounts.admins、accounts.invitations 和 accounts.locations.admins 現已在 Google My Business API 中淘汰。詳情請參閱淘汰變更記錄。
行動號召貼文
CallToAction內容中包含 GET_OFFER ActionType 的貼文將於 2021 年第 2 季失效。

v4.8

新功能

住宿設施
擷取住宿設施及更新。更多資訊
新增用於住宿的 GetGoogleUpdated 端點。
在 LocationState 中新增 canOperateLodgingData 布林值
健康提供者屬性
HealthProviderAttributes 的擷取及更新。更多資訊
在 LocationState 中新增 canOperateHealthData 布林值
保險網路
列出各地點接受的保險網絡。更多資訊

行為變更

評論 ID
評論 ID 已改用新格式。從現在起，系統會在所有適用的 API 回應中傳回這個新 ID。短期內，系統仍會在呼叫 API 時解決舊的評論 ID，但請務必根據政策呼叫 listReviews 端點，在 30 天內重新整理儲存在系統中的所有評論 ID。
區域服務商家
自 2021 年第 1 季起，CUSTOMER_LOCATION_ONLY 商家的 Location 物件將不再傳回 Address。

v4.7

新功能

菜單
FoodMenus 的擷取及更新。更多資訊

v4.6

新功能

服務清單
您現在可以擷取及更新商家提供的服務。更多資訊
在 LocationState 中加入 canModifyServiceList 布林值
指出某個地點是否符合修改服務清單的資格瞭解詳情
類別的預先定義ServiceTypes
類別物件現已包含預先定義的服務類型。瞭解詳情
CategoryView
可針對類別指定 BASIC 或 FULL 檢視畫面。FULL 檢視畫面會傳回其他詳細資料 (例如服務類型)。更多資訊
Categories.BatchGet 方法
這個新方法可讓您輸入類別清單，並只傳回這些類別的資訊。更多資訊

v4.5 COVID-19 更新 2

新功能

COVID-19 警報貼文類型
您現在可以透過 API 建立 COVID_19 貼文。更多資訊。

v4.5 COVID-19 更新 1

新功能

暫停營業
你現在可以透過 API 將商家設為 CLOSED_TEMPORARILY。更多資訊。

v4.5

新功能

透過 Pub/Sub 進行問與答活動
您現在可以收到 Google Cloud Pub/Sub 通知，瞭解您在哪裡出現新問題/有更新資訊的問題和答案。更多資訊。
列出狀態的 Pub/Sub
您現在可以接收 Google Cloud Pub/Sub 清單狀態異動的通知。更多資訊。

v4.4

新功能

在地生活服務商家驗證
在地生活服務商家現在可以透過 API 驗證。更多資訊。
追蹤者人數
您現在可以擷取追蹤者的中繼資料。更多資訊。
使用者群組和地區群組
現在可以透過 API 建立使用者群組和地區群組。更多資訊
在 LocationState 中加入 hasPendingEdits 欄位
指出地點的房源是否處於編輯待處理狀態。更多資訊

行為變更

日期不限行程
您現在可以為商家資訊設定未來的開幕日期。
PointRadius
PointRadius 現已設為唯讀。要編輯或建立在地生活服務商家，就必須使用 Places。

v4.3

全新功能

問答 API
在商家所在地點上找問題、張貼解答，以及提供常見問題。更多資訊。
大量閱讀評論
在單次呼叫中擷取多個地點的評論。更多資訊。
建議的 Google 地點
查看 Google 認為可能擁有的未聲明擁有權地點。更多資訊。
回報 Google 定位問題
回報「RecommendedGoogleLocations」或「GoogleLocations」結果的問題。更多資訊。
PriceList 區段的服務列舉
找出 PriceList 部分含有提供的 FOOD 商品或「服務」。更多資訊。
媒體說明
上傳新媒體時提供字幕。更多資訊。
CHAINS_QUERIES 項洞察結果
擷取某個地點因所屬連鎖店而顯示的次數。更多資訊。

行為變更

機構帳戶和地區群組的通知
現在，針對已設定 Pub/Sub 通知的帳戶，只要他們擔任機構帳戶或地區群組所含的每項商家資訊，都會收到這類通知。
機構帳戶和地區群組：ListLocations
使用者群組或機構帳戶呼叫了accounts.locations.list，現在會顯示該帳戶可以存取的所有地點。

v4.2

全新功能

驗證 API
列出及觸發未經驗證的地點可用的驗證方法。更多資訊。
GoogleLocations API
在 Google 上搜尋現有地點以聲明擁有權，或擷取連結以要求存取已聲明擁有權的地點。更多資訊。
更廣泛的位置篩選器
限制 Locations.List 呼叫傳回結果的其他選項。更多資訊。
鏈結成員資格
指出某地點屬於連鎖商店的會員，例如 Walmart、Target 等等。更多資訊。
機構資訊
機構帳戶的資訊現在會顯示在帳戶物件中。更多資訊。
評論者個人資料相片
評論對象的個人資料相片網址現在會包含於評論物件中。 更多資訊。

v4.1

全新功能

客戶提供的媒體
你現在可以擷取及查看使用者針對自己擁有和管理的地點所產生的相片和影片深入分析。更多資訊。
Admin Management API
你現在可以列出、接受和拒絕帳戶，以及與地點相關的邀請。更多資訊。
Profile (商家提供的說明)
你可以親自介紹商家，並向使用者分享商家與產品的獨特故事。更多資訊。
openingDate 欄位
提供營業地點的營業日期。更多資訊。
優惠類型貼文
這是一種全新的 Google 搜尋貼文類型，可協助使用者尋找實體店面提供的優惠。更多資訊。

v4

全新功能

Google 搜尋貼文
您現在可以直接透過 API 在 Google 上建立貼文。
上傳相片
除了現有網址上傳之外，現在您也可以透過 API 直接上傳相片。
篩選/選擇啟用通知
您現在可以篩選要傳送至 Pub/Sub 主題的通知。日後的通知將使用這項機制讓使用者選擇加入，而非傳送給所有使用者。
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 資訊更新。

回溯不相容的變更

  • 已移除 UrlAttributeValue 先前未使用的 languageCodes 和 platforms 欄位。

  • 現在，只有在這個重複項目的位置具有相同的主要擁有者時，系統才會套用已淘汰擁有權列舉中的 SAME。在此之前，行為是以更複雜的擁有權計算為基礎。

v3.1

全新功能

通知
您現在可以訂閱新評論的即時通知。
地圖網址
地點回應中會包含 Google 地圖網址，方便使用者輕鬆連結到 Google 地圖。
地點狀態
額外位置狀態，表示商家資訊的發布時間、停用中和尚未完成驗證。
重新開啟標記
canReopen 標記表示可恢復營業的永久停業地點，以及不能恢復營業的地點。
屬性
支援網址和 Enum 屬性。
類別端點
依國家/地區和語言取得支援類別清單 (取代 CSV 檔案)。

v3

全新功能

評論
您現在可以透過 API 擷取及回覆商家評論。
屬性
提供地點的其他類別專屬資訊。
尋找相符的地區
找出現有地圖地點與你的商家地點，並手動建立關聯。
轉移位置
「Location :transfer」的新動作。允許將位置從一個帳戶 (企業或個人) 轉移到另一個帳戶。
首選相片
指定你希望在 Google 地圖和 Google 搜尋中優先顯示哪一張相片。
新搜尋篩選器
新的搜尋篩選器包括 any_google_updates、is_suspended 和 is_duplicate。
新位置狀態
位置狀態現在也包含 is_verified 和 needs_reverification。
相片網址改善項目
這個 API 現在接受不含圖片格式後置字元的相片網址。

回溯不相容的變更

  • 目前您只能針對設有 Google+ 專頁的地點更新相片 (之前已接收並無訊息地移除)。

  • location_name 和 category_name 欄位現在僅限輸出。設定類別時請僅使用類別 ID。

  • 欄位遮罩不應在所含欄位中加入 location. 前置字元。

  • 建立/更新作業現在會接受位置做為主體酬載，其他參數則移至查詢字串。

v2

回溯不相容的變更

  • 您現在必須在 CreateLocation 呼叫中指定 request_id。每個地點的 ID 不得重複；這有助於避免帳戶中建立重複的地點。嘗試建立要求 ID 與先前建立的地點相符時，只會傳回現有位置，避免在帳戶中建立重複。

    • 位置中的 business_hours 已重新命名為 regular_hours。