REST Resource: accounts.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)

可选。商家支持的服务列表。例如理发、安装热水器等。系统会自动移除重复的服务项目。

PhoneNumbers

商家的电话号码集合。更新期间，必须同时设置这两个字段。客户端不能只使用更新掩码更新主要电话号码或其他电话号码。首选国际电话号码格式，例如“+1 415 555 0132”。如需了解详情，请参阅 (https://developers.google.com/style/phone-numbers#international-phone-numbers)。

JSON 表示法 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
字段
primaryPhone

string

必需。具体营业地点的电话号码，最好是直拨电话。请尽可能使用本地电话号码，而不是呼叫中心热线服务号码。
additionalPhones[]

string

可选。除了主要电话号码以外，最多还可以填写 2 个商家联系电话号码（仅限手机或固话号码，不得使用传真号码）。

类别

描述商家的类别集合。更新期间，必须同时设置这两个字段。禁止客户端使用更新掩码单独更新主要类别或其他类别。

JSON 表示法 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
字段
primaryCategory

object (Category)

必需。最能准确描述此营业地点涉及的核心业务的类别。
additionalCategories[]

object (Category)

可选。用于描述您的业务的其他类别。类别可帮助客户针对他们感兴趣的服务找到准确具体的结果。为确保您的商家信息准确有效，请务必使用尽可能少的类别来描述您的整体核心业务。选择尽可能具体并可代表您的主要业务的类别。

类别

用于描述商家性质（而非具体介绍商家的业务）的类别。如需查看有效类别 ID 的列表，以及这些 ID 与直观易懂的名称的映射，请参阅 categories.list。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
字段
name

string

必需。此类别的稳定 ID（由 Google 提供）。修改类别（创建或更新营业地点）时必须指定此值。
displayName

string

仅限输出。人类可读的类别名称。这是在读取位置信息时设置的。修改位置时，必须设置 category_id。
serviceTypes[]

object (ServiceType)

仅限输出。适用于此业务类别的所有服务类型的列表。
moreHoursTypes[]

object (MoreHoursType)

仅限输出。更多适用于此业务类别的营业时间类型。

ServiceType

用于描述商家提供的服务类型的消息。

JSON 表示法 
{
  "serviceTypeId": string,
  "displayName": string
}
字段
serviceTypeId

string

仅限输出。此服务类型的稳定 ID（由 Google 提供）。
displayName

string

仅限输出。人类可读的服务类型的显示名称。

MoreHoursType

除了正常营业时间外，商家可以提供的其他营业时间类型。

JSON 表示法 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
字段
hoursTypeId

string

仅限输出。Google 针对此营业时间类型提供的稳定 ID。
displayName

string

仅限输出。营业时间类型的直观易懂的英文显示名。
localizedDisplayName

string

仅限输出。简单易懂的营业时间类型的本地化显示名。

PostalAddress

表示邮政地址，例如邮政递送或付款地址。给定邮政地址时，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。此对象不模拟地理位置（道路、城镇、山区）。

在典型的使用场景中，地址将通过用户输入或导入现有数据来创建，具体取决于进程的类型。

有关输入/修改地址的建议：- 使用支持国际化的地址微件，例如 https://github.com/google/libaddressinput。不应向用户显示用于输入或修改该字段的其他国家/地区对应的界面元素。

如需详细了解如何使用此架构，请参阅：https://support.google.com/business/answer/6397478

JSON 表示法 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
字段
revision

integer

PostalAddress 的架构修订版本。必须将其设置为 0，也就是最新版本。

所有新版本必须向后兼容旧版本。
regionCode

string

必需。地址的国家/地区的 CLDR 地区代码。系统不会推断此字段，该值由用户确保正确。如需了解详情，请参阅 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地区代码为“CH”。
languageCode

string

选填。此地址内容的 BCP-47 语言代码（如果已知）。这通常是输入表单的界面语言，或者与地址的“国家/地区”中使用的某种语言或其转换后的其他语言相匹配。这可能会影响某些国家/地区的格式，但对数据的正确性并不重要，也不会影响任何验证或其他与格式无关的操作。

如果此值未知，则应省略（而不是指定可能不正确的默认值）。

示例：“zh-Hant”、“ja”、“ja-Latn”、“en”。
postalCode

string

可选。地址的邮政编码。并非所有国家/地区都使用或要求使用邮政编码，但在使用邮政编码时，它们可能会触发地址其他部分的额外验证（例如美国的州/邮政编码验证）。
sortingCode

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。在使用它的地方，此值可以是一个类似“CEDEX”的字符串，后面可能会跟一个数字（例如“CEDEX 7”），或者只有一个数字，代表“管制区代码”（牙买加），“投递区域指标”（马拉维）或“邮局指标”（例如科特迪瓦）。
administrativeArea

string

可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。具体来说，对于西班牙，此值为省而非自治区（例如此值为“巴塞罗那”而非“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如对于瑞士，此字段应留空。
locality

string

可选。一般是指地址的城市/城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义 locality 或者其无法很好地对应这个结构的区域，应将 locality 留空并使用 address_lines。
sublocality

string

可选。地址的子级市行政区。例如，此值可以是社区、自治市/镇/区、行政区。
addressLines[]

string

描述详细地址的非结构化地址行。

由于 addressLines 中的值没有类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此清楚的行顺序很重要。地址行的顺序应该是地址的国家/地区的“信封顺序”。在某些地方，此顺序有可能不同（例如日本），address_language 有助于使其明确（例如，“ja”表示从大到小排序，“ja-Latn”或“en”表示从小到大排序）。这样就可以根据语言选择地址的具体行。

地址的最小结构化表示形式由 regionCode 和 addressLines 组成，其中所有其他信息都放在 addressLines 中。可以在没有地理编码的情况下非常近似地设置此地址的格式，但是在至少部分完成之前，不能对任何地址组成部分进行语义推理。

创建仅包含 regionCode 和 addressLines 的地址，然后进行地理编码是处理完全非结构化地址的推荐方法（而不是猜测地址的哪些部分是城市/市镇或行政区）。
recipients[]

string

可选。此地址的收件人。在某些情况下，该字段可能包含多行信息。例如，它可能包含“转交”信息。
organization

string

可选。地址对应的组织的名称。

BusinessHours

表示此营业地点正常营业的时间段。存储 [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] 实例的集合。

JSON 表示法 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
字段
periods[]

object (TimePeriod)

必需。此营业地点正常营业的时间段。每个时间段都表示营业地点在一周内正常营业的时段。

TimePeriod

表示商家营业的时间范围，从指定的开始营业日期/时间开始，到指定的结束营业日期/时间结束。结束营业时间必须在开始营业时间之后，例如当天晚些时候或次日。

JSON 表示法 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
字段
openDay

enum (DayOfWeek)

必需。指明此时间段开始的 day of the week。
openTime

object (TimeOfDay)

必需。有效值为 00:00-24:00，其中 24:00 表示指定日期字段结束时的午夜。
closeDay

enum (DayOfWeek)

必需。指示此时间段结束的 day of the week。
closeTime

object (TimeOfDay)

必需。有效值为 00:00-24:00，其中 24:00 表示指定日期字段结束时的午夜。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

TimeOfDay

表示一天中的某个时间。日期和时区不重要，或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Date 和 google.protobuf.Timestamp。

JSON 表示法 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
字段
hours

integer

一天中的小时（采用 24 小时制）。值应为 0 到 23。对于业务结束时间等场景，API 可以选择允许“24:00:00”一值。
minutes

integer

一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。
seconds

integer

时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒，则 API 可以允许 60 一值。
nanos

integer

秒数的小数部分（以纳秒为单位）。值必须是介于 0 和 999999999 之间的数字。

SpecialHours

表示营业地点的营业时间与其正常营业时间不同的一组时间段。

JSON 表示法 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
字段
specialHourPeriods[]

object (SpecialHourPeriod)

必需。商家正常营业时间的例外情况列表。

SpecialHourPeriod

表示营业地点的营业时间与其正常营业时间不同的一个时间段。采用特殊营业时间的时长不得超过 24 小时。openTime 和 startDate 必须早于 closeTime 和 endDate。closeTime 和 endDate 可以推迟到指定 startDate 后一天的上午 11:59。例如，以下输入有效：

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

以下输入无效：

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON 表示法 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
字段
startDate

object (Date)

必需。此特殊时段的开始日期。
openTime

object (TimeOfDay)

可选。有效值为 00:00-24:00，其中 24:00 表示指定日期字段结束时的午夜。如果 closed 为 false，则必须指定。
endDate

object (Date)

可选。此特殊时段的结束日期。如果未设置 endDate 字段，则默认为 startDate 中指定的日期。如果设置，此字段必须等于或最多为 startDate 之后 1 天。
closeTime

object (TimeOfDay)

可选。有效值为 00:00-24:00，其中 24:00 表示指定日期字段结束时的午夜。如果 closed 为 false，则必须指定。
closed

boolean

可选。如果为 true，则系统会忽略 endDate、openTime 和 closeTime，并将 startDate 中指定的日期视为该营业地点全天歇业。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

ServiceAreaBusiness

上门服务商家在客户所在地提供服务（例如锁匠或管道工）。

JSON 表示法 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
字段
businessType

enum (BusinessType)

必需。表示 [type] 上门服务商家的 [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType]。
places

object (Places)

此商家提供服务的区域由一组地点定义。
regionCode

string

不可变。上门服务商家所在国家/地区的 CLDR 地区代码。如需了解详情，请参阅 http://cldr.unicode.org/ 和 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地区代码为“CH”。

对于 CUSTOMER_LOCATION_ONLY 商家，此字段是必填字段，否则会被忽略。

此处指定的地区可以与该商家服务区域中的地区不同（例如，在所在地区以外的地区提供服务的上门服务商家）。

如果此营业地点创建后需要验证，则提供的用于验证的地址必须位于该区域内，且企业主或其授权代表必须能够通过提供的验证地址接收邮政信件。

BusinessType

指明此商家是仅在客户所在地提供现场服务（例如拖车），还是同时在地址和现场提供服务（例如，带用餐区的披萨店，并提供送餐服务）。

枚举
BUSINESS_TYPE_UNSPECIFIED 仅限输出。未指定。
CUSTOMER_LOCATION_ONLY 仅在周边地区（而非商家地址）提供服务。如果商家正在从 CUSTOMER_AND_BUSINESS_LOCATION 更新为 CUSTOMER_LOCATION_ONLY，则营业地点更新必须包含字段掩码 storefrontAddress，并将该字段设置为空。
CUSTOMER_AND_BUSINESS_LOCATION 在商家地址和周边地区提供服务。

地点

定义由一组地点表示的区域集合。

JSON 表示法 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
字段
placeInfos[]

object (PlaceInfo)

由地点 ID 表示的区域。上限为 20 个地点。

PlaceInfo

定义由地点 ID 表示的区域。

JSON 表示法 
{
  "placeName": string,
  "placeId": string
}
字段
placeName

string

必需。地点的本地化名称。例如 Scottsdale, AZ。
placeId

string

必需。地点的 ID。必须与区域相对应。(https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

AdWords 中显示的附加信息。

JSON 表示法 
{
  "adPhone": string
}
字段
adPhone

string

必需。要在 AdWords 附加地址信息中显示的备用电话号码（而非营业地点的主要电话号码）。

LatLng

表示纬度/经度对的对象。该对象以一对双精度数表示，分别代表纬度度数和经度度数。除非另有说明，否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
字段
latitude

number

纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。
longitude

number

经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。

OpenInfo

与商家营业状态相关的信息。

JSON 表示法 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
字段
status

enum (OpenForBusiness)

必需。指明营业地点目前是否正常营业。默认情况下，所有营业地点均正常营业，除非已更新为停业。
canReopen

boolean

仅限输出。指明此商家是否符合重新开业的条件。
openingDate

object (Date)

可选。营业地点首次开业的日期。如果不知道确切日期，只能提供月份和年份。该日期必须是过去的日期，或者不超过未来一年内的日期。

OpenForBusiness

指明营业地点的状态。

枚举
OPEN_FOR_BUSINESS_UNSPECIFIED 未指定。
OPEN 指明营业地点正常营业。
CLOSED_PERMANENTLY 指明营业地点已永久停业。
CLOSED_TEMPORARILY 指明营业地点已临时停业。

元数据

与营业地点相关且用户不可修改的其他信息。

JSON 表示法 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}
字段
hasGoogleUpdated

boolean

仅限输出。指明与此营业地点相关联的地点 ID 是否有需要更新或被客户端拒绝的更新。如果已设置此布尔值，则应调用 getGoogleUpdated 方法来查找需要验证的信息。
hasPendingEdits

boolean

仅限输出。指明此营业地点的任何属性是否处于修改待审核状态。
canDelete

boolean

仅限输出。指明是否可以使用 API 删除营业地点。
canOperateLocalPost

boolean

仅限输出。指明商家信息是否可以管理本地帖子。
canModifyServiceList

boolean

仅限输出。指明商家信息是否可以修改服务列表。
canHaveFoodMenus

boolean

仅限输出。指明商家信息是否可以显示食品菜单。
canOperateHealthData

boolean

仅限输出。指明营业地点是否可以对健康数据执行操作。
canOperateLodgingData

boolean

仅限输出。指明营业地点是否可以处理住宿数据。
placeId

string

仅限输出。如果此营业地点显示在 Google 地图上，将在此字段中填充该营业地点的地点 ID。此 ID 可用于各种 Places API。

此字段可在调用 Create 期间设置，但不能在调用 Update 期间设置。
duplicateLocation

string

仅限输出。此营业地点重复的营业地点资源。
mapsUri

string

仅限输出。指向 Google 地图上营业地点的链接。
newReviewUri

string

仅限输出。指向 Google 搜索上可供客户对营业地点进行评价的页面的链接。
canHaveBusinessCalls

boolean

仅限输出。指明商家信息是否符合商家致电的条件。
hasVoiceOfMerchant

boolean

仅限输出。指明商家信息是否具有商家语音。如果此布尔值为 false，您应调用 locations.getVoiceOfMerchantState API，以详细了解他们没有 Voice of Merchant 的原因。

个人资料

与营业地点的商家资料有关的所有信息。

JSON 表示法 
{
  "description": string
}
字段
description

string

必需。使用您自己的语音对地点的说明，其他任何人都无法修改。

RelationshipData

与此营业地点相关的所有父级营业地点和子级营业地点的信息。

JSON 表示法 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
字段
parentLocation

object (RelevantLocation)

与此位置有关联的父级位置。
childrenLocations[]

object (RelevantLocation)

与此位置有关联的子位置的列表。
parentChain

string

此营业地点所属连锁店的资源名称。[如何查找连锁店 ID] [Locations.SearchChains]

RelevantLocation

与当前营业地点相关的另一个营业地点的信息。关系可以是 DEPARTMENT_OF 或 INDEPENDENT_ESTABLISHMENT_OF 中的任意一项，且此处指定的位置可以位于该位置的任一一侧（父/子）。

JSON 表示法 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
字段
placeId

string

必需。通过 placeID 指定位于关系另一端的位置。
relationType

enum (RelationType)

必需。关系的类型。

RelationType

需要指定的类型关系。

枚举
RELATION_TYPE_UNSPECIFIED 未指定类型。
DEPARTMENT_OF 这代表着两个营业地点之间的关系，这些营业地点共用一个物理区域，同一品牌/高层管理人员/组织，但具有不同的关键属性（如商店营业时间或电话号码）。例如，Costco Pharmacy 是 Costco Wholesale 的一个部门。
INDEPENDENT_ESTABLISHMENT_IN 这代表两个营业地点位于同一实际地点，但来自不同公司的情况（例如，Safeway 的星巴克、购物中心内的商店）。

MoreHours

营业地点针对特定类型的商家营业的时间段。

JSON 表示法 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
字段
hoursTypeId

string

必需。营业时间类型。客户应调用 {#link businessCategories:BatchGet} 以获取其营业地点类别支持的营业时间类型。
periods[]

object (TimePeriod)

必需。此营业地点正常营业的时间集合。每个时间段都表示营业地点在一周内正常营业的时段。

ServiceItem

描述单个服务项目的消息。用于描述商家提供的服务类型。例如，理发是一项服务。

JSON 表示法 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
字段
price

object (Money)

可选。表示服务项目的货币价格。我们建议在添加价格时设置 currencyCode 和 units。这将被视为服务项目的固定价格。
联合字段 service_item_info。应始终设置以下某个字段。service_item_info 只能是下列其中一项：
structuredServiceItem

object (StructuredServiceItem)

可选。此字段将设置为结构化服务数据的大小写。
freeFormServiceItem

object (FreeFormServiceItem)

可选。此字段将设置自由格式的服务数据的大小写。

StructuredServiceItem

表示商家提供的结构化服务。例如：toilet_installation。

JSON 表示法 
{
  "serviceTypeId": string,
  "description": string
}
字段
serviceTypeId

string

必需。serviceTypeId 字段是 Google 提供的唯一 ID，可在 ServiceType 中找到。此信息由 categories.batchGet RPC 服务提供。
description

string

可选。结构化服务项目的说明。字符数不能超过 300 个。

FreeFormServiceItem

表示商家提供的自由形式服务。这些服务不会作为结构服务数据的一部分公开。商家通过地理位置商家平台手动输入此类服务的名称。

JSON 表示法 
{
  "category": string,
  "label": {
    object (Label)
  }
}
字段
category

string

必需。此字段表示类别名称（即类别的固定 ID）。category 和 serviceTypeId 应与 Category 消息中提供的可能组合一致。
label

object (Label)

必需。项的带语言标记的标签。我们建议商品名称不超过 140 个字符，说明不超过 250 个字符。仅当输入为自定义服务项目时，才应设置此字段。应通过 serviceTypeId 更新标准化服务类型。

标签

显示价格列表、部分或商品时使用的标签。

JSON 表示法 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
字段
displayName

string

必需。价格列表、部分或商品的显示名。
description

string

可选。价格列表、部分或商品的说明。
languageCode

string

可选。这些字符串所适用的 BCP-47 语言代码。只能为每种语言设置一组标签。

金钱

表示含有货币类型的金额。

JSON 表示法 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
字段
currencyCode

string

ISO 4217 中定义的由三个字母组成的货币代码。
units

string (int64 format)

金额的整数单位。例如，如果 currencyCode 为 "USD"，则 1 单位就是一美元。
nanos

integer

金额的纳诺 (10^-9) 单位数。这个值必须在 -999999999（含）和 +999999999（含）之间。如果 units 是正数，nanos 必须是正数或零。如果 units 为零，nanos 可以是正数、零或负数。如果 units 为负数，则 nanos 必须为负数或零。例如 $-1.75 表示为 units=-1 和 nanos=-750,000,000。

方法

create

 创建将由登录用户拥有的新营业地点。

list

 列出指定账号的营业地点。