REST Resource: locations

资源：Location

营业地点。如需详细了解这些字段，请参阅帮助中心文章；如需查看有效业务类别的列表，请参阅类别端点。

JSON 表示法 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
字段
name

string

标识符。此营业地点的 Google 标识符，格式为：locations/{locationId}。
languageCode

string

不可变。营业地点所用的语言。在创建期间设置，无法更新。
storeCode

string

可选。此营业地点的外部标识符，它在指定账号中必须是唯一的。这表明可将此营业地点与您自己的记录相关联。
title

string

必需。营业地点名称应反映商家的实际名称，与实体店、网站和办公用品上使用的名称一致，并且是客户所熟知的名称。任何其他信息（如果相关）都可以包含在资源的其他字段中（例如 Address、Categories）。请勿在名称中添加不必要的信息（例如，首选“Google”，而不是“Google Inc. - Mountain View Corporate Headquarters”）。请勿包含营销宣传口号、商店代码、特殊字符、营业时间或营业/停业状态、电话号码、网站网址、服务/商品信息、位置/地址或路线，或包含信息（例如“Duane Reade 内的 Chase ATM”）。
phoneNumbers

object (PhoneNumbers)

可选。客户可用于与商家联系的不同电话号码。
categories

object (Categories)

可选。描述商家的不同类别。
storefrontAddress

object (PostalAddress)

可选。用于描述您的营业地点的准确无误的地址。不接受位于偏远地区的邮政信箱地址或邮箱地址。目前，您最多可在地址中指定 5 个 addressLines 值。此字段只能为有店面的商家设置。不应为类型为 CUSTOMER_LOCATION_ONLY 的位置设置此字段，但如果设置了此字段，则提供的任何值都将被舍弃。
websiteUri

string

可选。此商家的网址。如果可以，请使用能代表具体营业地点的网址，而不是能代表所有营业地点或品牌的通用网站/网址。
regularHours

object (BusinessHours)

可选。商家的营业时间。
specialHours

object (SpecialHours)

可选。商家的特殊营业时间。通常包括节假日营业时间以及除正常营业时间之外的其他时间。这些值将覆盖正常营业时间。如果未设置常规营业时间，则无法设置此字段。
serviceArea

object (ServiceAreaBusiness)

可选。上门服务商家在客户所在地提供服务。如果商家是上门服务商家，则此字段描述的是该商家提供服务的区域。
labels[]

string

可选。一组任何形式的字符串，用于为自己的商家添加代码。这些标签不会向用户公开，只有您能看到。每个标签的长度必须介于 1 到 255 个字符之间。
adWordsLocationExtensions

object (AdWordsLocationExtensions)

可选。AdWords 中显示的附加信息。
latlng

object (LatLng)

可选。用户提供的纬度和经度。创建营业地点时，如果成功对提供的地址进行地理编码，系统会忽略此字段。只有在创建期间接受了用户提供的 latlng 值，或通过 Google 商家资料网站更新了 latlng 值，才会针对 get 请求返回此字段。此字段只能由获批的客户端更新。
openInfo

object (OpenInfo)

可选。一个标记，指明营业地点当前是否正常营业。
metadata

object (Metadata)

仅限输出。用户不可修改的其他信息。
profile

object (Profile)

可选。利用极具个性色彩的语言描述您的商家，并与用户分享您的商家和服务的独特故事。

除住宿类别（例如酒店、汽车旅馆、旅馆）外，所有类别都必须填写此字段。
relationshipData

object (RelationshipData)

可选。与此营业地点相关的所有营业地点和连锁店。
moreHours[]

object (MoreHours)

可选。商家不同部门或特定客户的更多营业时间。
serviceItems[]

object (ServiceItem)

可选。商家支持的服务列表。服务可以是理发、安装热水器等。重复的服务项目将被自动移除。

方法

delete

 删除营业地点。

get

 返回商家最后设置的指定营业地点。

getAttributes

 检索商家最后一次设置的营业地点属性。

getGoogleUpdated

 返回在 Google 地图和 Google 搜索中显示的指定营业地点。

patch

 更新指定的营业地点。

updateAttributes

 更新指定营业地点的属性。