Method: locations.getGoogleUpdated

返回在 Google 地图和 Google 搜索中显示的指定营业地点。此面向消费者的视图可能已由 Google 或用户生成的内容更新,并且可能与商家的版本不同。返回的 GoogleUpdatedLocation 包含掩码,用于指明哪些字段与商家的信息不同。

HTTP 请求

GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/{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。