管理 Google 更新

为了确保您的商家资料尽可能准确，Google 会使用各种来源的信息，例如用户报告和已获许可的内容。如果企业主提供的信息被报告为不正确，Google 会通知相应的商家信息所有者。商家信息所有者可以接受或拒绝更新。

作为商家信息所有者，您可以使用 My Business 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。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 相同。同样，还要匹配每个字段的首选值。

接受请求

以下是一个 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 调用之前的响应。