變更記錄

v4.9

新功能

MoreHours

MoreHours 現已可在商家資訊中設定。

MoreHourTypes 可透過 categories.batchGet 為每個類別擷取。

行為變更

淘汰 v4.x 帳戶

accounts、accounts.admins、accounts.invitations 和 accounts.locations.admins 現已淘汰，不再支援 Google My Business API。詳情請參閱淘汰異動記錄。

CallToAction 貼文

2021 年第 2 季起，CallToAction含有 GET_OFFER ActionType 的貼文將不再有效。

v4.8

新功能

住宿設施

擷取及更新住宿設施。更多資訊

為住宿類型新增 GetGoogleUpdated 端點。

在 LocationState 中新增 canOperateLodgingData 布林值

醫療服務提供者屬性

擷取及更新 HealthProviderAttributes。更多資訊

在 LocationState

中新增 canOperateHealthData 布林值

保險網路

列出各地區接受的保險網絡。瞭解詳情

行為變更

評論 ID

評論 ID 已遷移至新格式。這組新 ID 現已可在所有適用的 API 回應中傳回。在短時間內，舊的評論 ID 仍可用於呼叫 API，但請務必根據我們的政策，在 30 天內呼叫 listReviews 端點，以便更新系統中儲存的所有評論 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。

4.3 版

新功能

問與答 API

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

大量閱讀評論

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

建議的 GoogleLocations

查看 Google 認為你可能擁有的未認領位置。更多資訊。

回報 GoogleLocation 問題

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

PriceList 區段的服務列舉

找出 PriceList 區段，判斷該區段是否包含食物項目或提供的服務。更多資訊。

媒體說明

上傳新媒體時提供說明文字。更多資訊。

CHAINS_QUERIES 洞察

擷取某個地點在搜尋屬於該地點的連鎖店時，顯示的次數。更多資訊。

行為變更

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

現在，已設定 Pub/Sub 通知的帳戶也會收到任何商家資訊的通知，這些商家資訊包含機構帳戶或管理員所在的營業地點群組。

ListLocations (機構帳戶和地區群組)

使用使用者群組或機構帳戶呼叫

accounts.locations.list 時，現在會顯示該帳戶可存取的所有地點。

4.2 版

新功能

Verification API

列出未驗證地點的可用驗證方法，並觸發驗證程序。更多資訊。

GoogleLocations API

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

已展開的位置篩選器

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

連鎖會籍

指出商家是連鎖店的一部分 (例如 Walmart、Target 等)。更多資訊。

機構資訊

機構帳戶的資訊現在會顯示在帳戶物件中。更多資訊。

評論者個人資料相片

評論者個人資料相片的網址現在已納入評論物件。更多資訊。

v4.1

新功能

客戶提供的媒體

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

管理員管理 API

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

Profile (商家提供的說明)

以自己的聲音介紹商家，向使用者分享商家和產品/服務的獨特故事。更多資訊。

openingDate 欄位

提供營業地點的開幕日期。更多資訊。

優惠類型貼文

這是一種全新的 Google 貼文類型，可協助使用者在你的所在地區找到優惠。更多資訊。

v4

新功能

Google 搜尋貼文

您現在可以直接透過 API 在 Google 上建立貼文。

上傳相片

除了現有的網址上傳功能外，現在也可以直接透過 API 上傳相片。

通知篩選/選擇加入

您現在可以篩選要傳送至 pubsub 主題的通知。日後的通知會使用這個機制，讓使用者選擇是否接收，而非傳送給所有使用者。

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 欄位已移除。

• 已淘汰的 Ownership 列舉中的 SAME 現在只會在重複項目的位置有相同的主要擁有者時才套用。先前，這項行為是根據更複雜的擁有權計算方式。

v3.1

新功能

通知

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

地圖網址

Google 地圖網址會納入位置回應，方便使用者輕鬆連結至 Google 地圖。

位置狀態

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

重新開啟標記

canReopen 標記可用來指出哪些永久停業的地點可重新開啟，哪些則無法。

屬性

支援網址和列舉屬性。

類別端點

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

v3

新功能

評論

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

屬性

提供位置的其他類別專屬資訊。

尋找相符的地點

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

轉移位置

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

首選相片

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

新的搜尋篩選器

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

新位置狀態

Location states 現已包含 is_verified 和 needs_reverification。

相片網址改善

API 現在接受不含圖片格式副檔名的相片網址。

回溯不相容的變更

• 相片現在只能更新有 Google+ 專頁的地點 (這些地點先前已接受並悄悄刪除)。

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

• 欄位遮罩應不再包含所包含欄位的 location. 前置字串。

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

v2

回溯不相容的變更

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

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