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

必需。营业地点名称应真实反映商家的实际名称,与店面、网站和文具用品上的名称一致并为客户所知。您可以在资源的其他字段中添加任何其他相关信息(例如 AddressCategories)。请勿在姓名中添加不必要的信息(例如,尽量使用“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

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