管理 Google 資訊更新

Google 會採用使用者回報的資訊和授權內容等多種來源的資訊，以盡量確保商家檔案的正確性。如果有人回報業主提供的資訊不正確，Google 會通知商家檔案擁有者。商家資訊擁有者隨後可接受或拒絕更新。

身為商家資訊擁有者，您可以透過 Google 我的商家商家資訊 API 查看這些更新內容，確保商家資訊正確無誤。本指南說明如何接受或拒絕更新。

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

  1. 查看有待更新的位置
  2. 查看已更新的欄位
  3. 接受或拒絕更新
  4. 查看結果

找出待更新的營業地點

您必須先瞭解哪些地區提供 Google 更新，才能接受或拒絕更新。如要取得 Google 位置更新，最佳做法是使用 Cloud Pub/Sub 管理即時通知。如果您收到 Pub/Sub 主題的 GOOGLE_UPDATE 通知，表示有變更項目可供您查看。通知中的 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。回應主體中會包含詳細說明 Google 更新的欄位的 diffMask。

要求

以下是 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 相同。並且也要符合每個欄位的偏好值。

接受要求

以下是 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"
     },
    ...
}

查看結果

如果您的位置資訊已成功修補，locations.getGoogleUpdated 回應中的 diffMask 欄位會顯示 "diffMask": "" 值。此外，Metadata 中的標記 "hasGoogleUpdated" 會顯示 false 值，或不顯示任何值。

如果欄位值不清楚，請與支援團隊聯絡，並提供 getGoogleUpdated 的請求和回應。要求必須在 locations.patch 呼叫、修補呼叫和 getGoogleUpdated 呼叫之前，先包含回應。