REST Resource: locations

{
  "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)
    }
  ]
}

string

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

string

不可变。营业地点的语言。在创建期间设置，且不可更新。

string

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

string

必需。营业地点名称应真实反映商家的实际名称，与店面、网站和文具用品上的名称一致，为客户所知。您可以在资源的其他字段中添加任何其他相关信息（例如，Address、Categories）。请勿在名称中添加不必要的信息（例如，首选“Google”，而非“Google Inc. - Mountain View Corporate Headquarters”）。请勿添加营销宣传口号、商店代码、特殊字符、营业时间或已停业/营业状态、电话号码、网站网址、服务/产品信息、位置/地址或路线，或包含信息（例如“杜安里德大通银行的 ATM”）。

object (PhoneNumbers)

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

object (Categories)

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

object (PostalAddress)

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

string

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

object (BusinessHours)

可选。商家的营业时间。

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

可选。一组自由格式的字符串，可让您为自己的商家添加代码。这些标签不会面向用户，只有您自己可以看到。每个标签的长度必须介于 1 到 255 个字符之间。

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

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

对于除住宿类别（如酒店、汽车旅馆、旅社）之外的所有类别，此字段均为必填字段。

object (RelationshipData)

可选。与此商家相关的所有营业地点和连锁店。

object (MoreHours)

可选。为商家的不同部门或特定客户提供更多营业时间。

object (ServiceItem)

可选。商家支持的服务列表。服务包括理发、安装热水器等。系统会自动移除重复的服务内容。