REST Resource: accounts.locations

• 资源：Location
  • JSON 表示法
  • PhoneNumbers
    • JSON 表示法
  • 类别
    • JSON 表示法
  • 类别
    • JSON 表示法
  • ServiceType
    • JSON 表示法
  • MoreHoursType
    • JSON 表示法
  • PostalAddress
    • JSON 表示法
  • BusinessHours
    • JSON 表示法
  • TimePeriod
    • JSON 表示法
  • DayOfWeek
  • TimeOfDay
    • JSON 表示法
  • SpecialHours
    • JSON 表示法
  • SpecialHourPeriod
    • JSON 表示法
  • 日期
    • JSON 表示法
  • ServiceAreaBusiness
    • JSON 表示法
  • BusinessType
  • 地点
    • JSON 表示法
  • PlaceInfo
    • JSON 表示法
  • AdWordsLocationExtensions
    • JSON 表示法
  • LatLng
    • JSON 表示法
  • OpenInfo
    • JSON 表示法
  • OpenForBusiness
  • 元数据
    • JSON 表示法
  • 商家资料
    • JSON 表示法
  • RelationshipData
    • JSON 表示法
  • RelevantLocation
    • JSON 表示法
  • RelationType
  • MoreHours
    • JSON 表示法
  • ServiceItem
    • JSON 表示法
  • StructuredServiceItem
    • JSON 表示法
  • FreeFormServiceItem
    • JSON 表示法
  • Label
    • JSON 表示法
  • Money
    • JSON 表示法
• 方法

资源：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) 可选。商家支持的服务列表。服务可以是理发、安装热水器等。重复的服务项目将被自动移除。

PhoneNumbers

商家的电话号码集合。在更新期间，必须同时设置这两个字段。客户不得仅使用更新掩码来更新主要电话号码或备用电话号码。最好采用国际电话号码格式，例如“[phone]”，如需了解详情，请参阅 (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 的列表以及与人类可读名称的映射，请参阅 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

表示邮政地址，例如邮政递送地址或付款地址。有了邮政地址，邮政服务就可以将物品递送到房屋、邮政信箱或类似地点。邮政地址不适用于对道路、城镇或山脉等地理位置进行建模。

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

有关输入或修改地址的建议：

• 使用支持国际化的地址 widget，例如 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 可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。对于西班牙，这是省份，而不是自治区（例如，应为“Barcelona”，而不是“Catalonia”）。许多国家在邮政地址中不使用行政区划。例如，在瑞士，此字段应留空。
locality	string 可选。通常指地址的城市或乡镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。在世界上某些地区，如果地方行政区划不明确或不适合此结构，请将 locality 留空，并使用 addressLines。
sublocality	string 可选。地址的子级市行政区。例如，这可以是街区、市镇或区。
addressLines[]	string 描述详细地址的非结构化地址行。 由于 addressLines 中的值不包含类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此请务必确保行顺序清晰。地址行的顺序应为地址所在国家或地区的“信封顺序”。在可能存在差异的地方（例如日本），address_language 用于明确指定（例如，“ja”表示从大到小的顺序，“ja-Latn”或“en”表示从小到大的顺序）。这样，系统就可以根据语言选择最具体的地址行。 地址的最小允许结构化表示形式由 regionCode 组成，所有其余信息都放在 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 表示指定日期字段结束时的午夜。注意：在 Proto3 JSON 映射中，默认零值 (00:00) 会被省略，从而为 openTime 生成 {}。
closeDay	enum (DayOfWeek) 必需。表明此时间段结束时的 day of the week。
closeTime	object (TimeOfDay) 必需。有效值为 00:00-24:00，其中 24:00 表示指定日期字段结束时的午夜。注意：在 Proto3 JSON 映射中，默认零值 (00:00) 会被省略，从而为 closeTime 生成 {}。

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 且小于或等于 999,999,999。

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 中指定的日期会被视为营业地点全天停业。

日期

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

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

相关类型：

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

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) 必需。表明上门服务商家的 [类型][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 必需。要在 Google Ads 附加地址信息中显示的备用电话号码（而非营业地点的主要电话号码）。

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, "isParticularlyPersonalPlace": boolean }

字段
hasGoogleUpdated	boolean 仅限输出。指明与此营业地点相关联的地点 ID 是否有需要由客户端更新或拒绝的更新。如果设置了此布尔值，您应调用 getGoogleUpdated 方法来查找需要验证的信息。
hasPendingEdits	boolean 仅限输出。指明此营业地点的任何属性是否处于“修改内容正在等待审核”状态。
canDelete	boolean 仅限输出。指明是否可以使用 API 删除营业地点。
canOperateLocalPost (deprecated)	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，以获取有关他们没有商家发言权的原因的详细信息。
isParticularlyPersonalPlace	boolean 仅限输出。指明营业地点是否被归类为特别私密地点。这意味着位置记录功能会受到限制。如果您认为我们的处理有误，请参阅帮助中心文章。

个人资料

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

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 必需。通过地点 ID 指定关系另一侧的地点。
relationType	enum (RelationType) 必需。关系的类型。

RelationType

要指定的类型关系。

枚举
RELATION_TYPE_UNSPECIFIED	未指定类型。
DEPARTMENT_OF	这表示两个营业地点之间的关系，它们共用一个实体区域、属于同一品牌/上级管理层/组织，但具有不同的关键属性，例如营业时间或电话号码。例如，Costco 药房是 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) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "structuredServiceItem": { object (StructuredServiceItem) }, "freeFormServiceItem": { object (FreeFormServiceItem) } // End of mutually exclusive fields. }

字段
price	object (Money) 可选。表示服务项目的货币价格。我们建议您在添加价格时设置 currencyCode 和 units。此值将被视为服务项目的固定价格。
应始终设置以下字段之一。以下是互斥字段的列表。在响应中，最多只能设置其中一个字段：
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

表示商家提供的自由形式服务。这些服务不会作为结构化服务数据的一部分公开。商家可以使用 geomerchant 界面手动输入此类服务的名称。

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 语言代码。只能为每种语言设置一组标签。

Money

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

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

字段
currencyCode	string 采用 ISO 4217 标准定义的三位字母货币代码。
units	string (int64 format) 金额的整数单位。例如，如果 currencyCode 是 "USD"，则 1 单位就是一美元。
nanos	integer 以纳单位 (10^-9) 表示的金额数量。取值范围必须在 -999,999,999 至 +999,999,999 之间（含边界值）。如果 units 是正数，nanos 必须是正数或零。如果 units 为零，nanos 可以是正数、零或负数。如果 units 是负数，nanos 必须是负数或零。例如，$-1.75 表示为 units=-1 和 nanos=-750,000,000。

方法
create	创建将由登录用户拥有的新营业地点。
list	列出指定账号的营业地点。