變更記錄

v4.9

新功能

2026-04-07

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

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 Update 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 地圖。

Location States

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

重新開啟旗標

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

屬性

支援網址和列舉屬性。

類別端點

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

v3

新功能

評論

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

屬性

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

尋找相符地點

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

轉移位置

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

首選相片

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

全新搜尋篩選器

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

新位置狀態

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

改善相片網址

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

不具回溯相容性的變更

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