變更記錄

v4.9

新功能

2026-07-24

review_reply_url：現在可以使用 accounts.locations.reviews.get、accounts.locations.reviews.list 和 accounts.locations.batchGetReviews 擷取 reviewReplyUrl。

2026-07-01

Policy Violation：評論的 ReviewReply 現在包含 PolicyViolation 欄位。PolicyViolation 可使用 accounts.locations.reviews.get、accounts.locations.reviews.list 和 accounts.locations.batchGetReviews 擷取。讓您更清楚瞭解為何評論回覆在審查期間遭到拒絕。

2026-04-20

Review Media Items： 現在可以擷取 ReviewMediaItems 做為評論的一部分。 ReviewMediaItems 可使用 accounts.locations.reviews.get、 accounts.locations.reviews.list 和 accounts.locations.batchGetReviews 擷取。

2026-04-07

Recurrence Info：您現在可以在建立 LocalPost 時設定 RecurrenceInfo，排定重複發布的貼文

Food Menus：現在起，您可以使用 accounts.locations.updateFoodMenus，在菜單中管理最多 200 張菜色照片。

2026-04-01

Review Reply State：現在可擷取ReviewReplyState，做為評論的一部分。ReviewReplyState 可使用 accounts.locations.reviews.get、accounts.locations.reviews.list 和 accounts.locations.batchGetReviews 擷取。方便你進一步瞭解提交的評論回覆審查狀態。

2021-02-24

MoreHours ： 現在可以將 MoreHours 設為商家檔案的一部分。 ：MoreHourTypes 可使用 categories.batchGet 針對每個類別擷取。

行為變更

淘汰 4.x 版帳戶

Google 我的商家 API 現已淘汰

accounts、 accounts.admins、 accounts.invitations 和 accounts.locations.admins。詳情請參閱淘汰項目變更記錄。

行動號召貼文

2021 年第 2 季，CallToAction貼文的

GET_OFFER ActionType 將失效。

v4.8

新功能

住宿設施 ： 擷取 和 更新住宿設施。更多資訊 ： 新增住宿的 GetGoogleUpdated 端點。：在 LocationState 中新增 canOperateLodgingData 布林值

健康照護提供者屬性： : 擷取 和 更新 健康照護提供者屬性。詳細資訊：在 LocationState 中新增 canOperateHealthData 布林值

保險網絡： : 清單 地點接受的保險網絡。更多資訊

行為變更

評論 ID

評論 ID 已改用新格式。所有適用的 API 回應現在都會傳回這個新 ID。在短時間內，使用舊版評論 ID 呼叫 API 時，系統仍會解析這些 ID，但請務必在 30 天內，按照政策規定，呼叫 listReviews 端點，更新系統中儲存的所有評論 ID。

區域服務商家

2021 年第 1 季，系統將不再於Address

地點 物件，適用於 CUSTOMER_LOCATION_ONLY 商家。

v4.7

新功能

餐飲菜單 : 擷取 和 更新 餐飲菜單。更多資訊

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 Update 1

新功能

暫停營業

您現在可以使用 API 將商家設為 CLOSED_TEMPORARILY。更多資訊。

v4.5

新功能

Pub/Sub for Q&A

現在，當地點有新的或更新的問題和答案時，您會收到 Google Cloud Pub/Sub 通知。更多資訊。

Pub/Sub 房源狀態

現在，如果產品資訊狀態有變，您會收到 Google Cloud Pub/Sub 通知。更多資訊。

v4.4

新功能

在地生活服務商家驗證

在地生活服務商家現在可以透過 API 驗證。更多資訊。

追蹤者人數

您現在可以擷取追蹤者的中繼資料。

更多資訊。

使用者群組和營業地點群組

現在可透過 API 建立使用者群組和地區群組。更多資訊

在 LocationState 中新增 hasPendingEdits 欄位

指出地點的屬性是否處於待編輯狀態。更多資訊

行為變更

日期不限行程

現在可以為商家資訊設定未來的開業日期。

PointRadius : PointRadius 現在為唯讀。如要編輯或建立在地生活服務商家，請使用 Places。

4.3 版

新功能

問與答 API

擷取問題、張貼解答，以及提供商家地點的常見問題。更多資訊。

大量閱讀評論

在單一呼叫中擷取多個地點的評論。

更多資訊。

建議的 Google 地點

查看 Google 認為可能屬於你的未聲明地點。更多資訊。

回報 Google 地理位置問題

回報「RecommendedGoogleLocations」或「GoogleLocations」結果的問題。更多資訊。

「PriceList」區段的服務列舉

將 PriceList 區段標示為包含食品或提供的服務。更多資訊。

媒體說明

上傳新媒體時提供說明。

更多資訊。

CHAINS_QUERIES 洞察

擷取某個地點在所屬連鎖店的搜尋結果中顯示的次數。更多資訊。

行為變更

機構帳戶和地點群組的通知

設定接收 Pub/Sub 通知的帳戶，現在也會收到其所管理機構帳戶或地點群組中任何商家資訊的通知。

ListLocations 機構帳戶和地區群組

accounts.locations.list 現在使用使用者群組或機構帳戶呼叫時，會顯示該帳戶可存取的所有地點。

4.2 版

新功能

驗證 API

列出並觸發未經驗證營業地點的可用驗證方法。更多資訊。

GoogleLocations API

在 Google 上搜尋現有地點來聲明擁有權，或擷取連結來要求存取已聲明擁有權的地點。更多資訊。

展開位置篩選器

限制從 Locations.List 呼叫傳回結果的其他選項。更多資訊。

連鎖店會員

指出地點是否為連鎖商店 (例如 Walmart、Target 等)。更多資訊。

機構資訊

「機構帳戶」的資訊現在會顯示為帳戶物件的一部分。更多資訊。

評論者個人資料相片

評論物件現在會包含評論者的個人資料相片網址。更多資訊。

v4.1

新功能

客戶提供的媒體

現在你可以擷取並查看你擁有及管理的地點，使用者產生相片和影片的洞察資料。更多資訊。

管理 API

您現在可以列出、接受及拒絕帳戶和地點相關的帳戶邀請。更多資訊。

Profile (商家提供的說明)

用自己的話描述商家，向使用者分享商家和產品的獨特故事。更多資訊。

openingDate 欄位

提供營業地點的開業日期。

更多資訊。

優惠類型貼文

Google 貼文的新類型，可協助使用者尋找你店面提供的優惠。更多資訊。

v4

新功能

Google 搜尋貼文

現在可以直接透過 API 在 Google 搜尋貼文。

上傳相片

現在除了現有的網址上傳方式，還可直接使用 API 上傳相片。

篩選/選擇接收通知

你現在可以篩選要傳送至 Pub/Sub 主題的通知。日後通知將採用這項機制，使用者必須選擇接收通知，而非向所有使用者發送通知。

UPDATED_REVIEW 則通知

你現在可以訂閱顧客評論的即時通知。

支援使用者群組

Google My Business API 現在支援使用者群組類型的帳戶。

不相容的回溯變更

• 相片先前是 location 物件的欄位，現在是位置資訊 (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/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，現在只有在重複的營業地點具有相同的主要擁有者時，才適用於已淘汰的 Ownership 列舉。先前，這項行為是根據更複雜的擁有權計算方式。

v3.1

新功能

通知

你現在可以訂閱新評論的即時通知。

地圖網址

位置資訊回應會包含 Google 地圖網址，方便使用者連結至 Google 地圖。

位置狀態

其他地點狀態，指出商家資訊發布、停用或待驗證的時間。

重新開啟旗標

canReopen 旗標會指出永久歇業的地點是否可以重新啟用。

屬性

支援網址和列舉屬性。

類別端點

依國家/地區和語言取得支援的類別清單 (取代 CSV 檔案)。

v3

新功能

評論

您現在可以透過 API 擷取及回覆商家評論。

屬性

提供地點的額外資訊，並依類別分類。

尋找相符地點

找出現有地圖位置，並手動與商家所在地點建立關聯。

轉移位置

對 Location :transfer 執行新動作。允許將地點從一個帳戶 (商家或個人) 轉移至另一個帳戶。

首選相片

指出您希望在 Google 地圖和搜尋中優先顯示的相片。

全新搜尋篩選器

新搜尋篩選器包括 any_google_updates、 is_suspended 和 is_duplicate。

新位置狀態

位置狀態現在也包含 is_verified 和 needs_reverification。

相片網址改善

API 現在接受不含圖片格式字尾的相片網址。

不相容的回溯變更

• 您現在必須在 CreateLocation 呼叫中指定 request_id。每個地點的 ID 都不得重複，以免帳戶中建立重複的地點。如果嘗試建立的地點與先前建立的地點有相同的要求 ID，系統會傳回現有地點，避免在帳戶中建立重複地點。
• 「位置」中的「business_hours」已重新命名為「regular_hours」。