Method: locations.getGoogleUpdated

傳回 Google 地圖和 Google 搜尋上顯示的指定地點。Google 或使用者原創內容可能已更新這個消費者看到的檢視畫面，因此可能與商家的版本不同。傳回的 GoogleUpdatedLocation 包含遮罩，指出哪些欄位與商家的資訊不同。

HTTP 要求

GET https://mybusinessbusinessinformation.googleapis.com/v1/{name=locations/*}:getGoogleUpdated

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必填。要擷取的地點名稱。

查詢參數

參數
readMask

string (FieldMask format)

必填。讀取遮罩，指定要在回應中傳回哪些欄位。

這是以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。

要求主體

要求主體必須為空白。

回應主體

代表消費者看到的地點檢視畫面，包括目前在 Google 地圖和 Google 搜尋上顯示的最新資訊。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "location": {
    object (Location)
  },
  "diffMask": string,
  "pendingMask": string
}
欄位
location

object (Location)

這個地點的 Google 更新版本。
diffMask

string (FieldMask format)

消費者看到的檢視畫面中，值與商家資訊不同的欄位。如要接受這些變更，請修補地點。如要拒絕，請使用偏好的值進行修補。

這是以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。
pendingMask

string (FieldMask format)

商家已提供更新，但尚未發布至 Google 地圖和 Google 搜尋的欄位。這個遮罩只會追蹤商家自行編輯的狀態，不會追蹤外部變更。

這是以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/business.manage

詳情請參閱OAuth 2.0 Overview。