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”）。请勿添加营销性宣传口号、商店代码、特殊字符、营业时间或歇业/营业状态、电话号码、网站网址、服务/产品信息、位置/地址或路线或管理信息（例如“杜安里德的大通自动取款机”）。
phoneNumbers

object (PhoneNumbers)

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

object (Categories)

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

object (PostalAddress)

可选。用于描述您的营业地点的准确无误的地址。不接受位于偏远地区的邮政信箱地址或邮箱地址。目前，您最多可以在地址中指定五个 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 更新版本。

patch

 更新指定的营业地点。

updateAttributes

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