管理 Google 更新

為盡可能確保商家檔案資訊正確無誤，Google 會使用多種來源的資訊， 使用者回報和授權內容如果將業主提供的資訊回報為 不正確，Google 會通知商家資訊擁有者。接著，商家資訊擁有者就可以接受或拒絕 更新。

身為商家資訊擁有者，My Business Business Information API 可讓您查看這些更新內容，確保 以及正確的商家資訊。本指南說明如何接受或拒絕更新內容。

如要管理 Google 資訊更新，請完成下列步驟：

  1. 尋找有待更新的地點
  2. 查看更新後的欄位
  3. 接受或拒絕更新
  4. 查看結果

尋找有待更新的地點

接受或拒絕更新之前，您必須先確認哪些地點有 Google 更新 廣告。如要取得位置的 Google 資訊更新，最好的方法是： 透過以下應用程式管理即時通知： Cloud Pub/Sub：如果收到 GOOGLE_UPDATE 通知到 Pub/Sub 主題 如果變更項目已準備就緒，通知中的 locationName 欄位 為 Google 更新提供位置的資源名稱。

你也可以看到 locations.get 並查看 Metadata ，藉此查看 hasGoogleUpdated 標記。如果是 "isGoogleUpdated": true， 與這個地點相關聯的地點 ID 有更新。

要求

以下是 locations.get 要求範例：

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

要求

以下是 locations.get 回應範例：

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

查看更新內容欄位

如要查看有 Google 更新的特定欄位，請呼叫 locations.getGoogleUpdated。 diffMask詳細說明 Google 更新的欄位 「回應主體」。

要求

以下是 locations.getGoogleUpdated 要求範例：

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

回應

以下是 locations.getGoogleUpdated 回應範例。phoneNumbers.primaryPhone 欄位中會顯示可用的更新。在 這個回應是建議的更新值：

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

接受或拒絕更新

如要接受或拒絕更新，請執行 locations.patch 並將 updateMask 欄位設為與您在 diffMask 中 達到 1,000。此外，也請將每個欄位的偏好值配對。

接受請求

以下是 locations.patch 要求範例：

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

回應

以下是 locations.patch 回應範例：

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

拒絕要求

以下是 locations.patch 要求範例：

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

回應

以下是 locations.patch 回應範例：

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

查看結果

如果位置已成功修補，diffMask 中的 locations.getGoogleUpdated 回應會將值顯示為 "diffMask": ""。此外， Metadata 中的 "hasGoogleUpdated" 會顯示 false，或是沒有值。

如果欄位值不清楚 聯繫 支援團隊，針對「getGoogleUpdated」提出的要求與回覆。 要求必須包含回應 locations.patch 呼叫、修補呼叫和 getGoogleUpdated 呼叫。