管理 Google 更新

Google 會採用使用者回報和授權內容等來源的資訊，盡可能確保商家檔案正確無誤。如果業主提供的資訊遭檢舉有誤，Google 會通知商家資訊擁有者。商家資訊擁有者便可接受或拒絕更新。

如果你是商家資訊擁有者，可以使用 My Business Information 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 呼叫。