REST Resource: accounts.locations

string

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

string

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

object (Category)

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

object (Category)

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

string

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

string

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

object (ServiceType)

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

object (MoreHoursType)

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

string

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

string

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

string

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

string

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

string

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

integer

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

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

string

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

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

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

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

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

string

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

string

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

object (TimePeriod)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

integer

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

integer

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

integer

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

integer

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

object (SpecialHourPeriod)

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

object (Date)

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

object (TimeOfDay)

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

object (Date)

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

object (TimeOfDay)

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

boolean

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

integer

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

integer

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

integer

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

enum (BusinessType)

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

object (Places)

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

string

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

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

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

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

object (PlaceInfo)

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

string

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

string

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

string

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

number

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

number

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

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

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

string

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

string

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

boolean

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

boolean

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

string

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

object (RelevantLocation)

与此位置有关联的父级位置。

object (RelevantLocation)

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

string

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

string

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

enum (RelationType)

必需。关系的类型。

string

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

object (TimePeriod)

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

object (Money)

可选。表示服务项目的货币价格。我们建议在添加价格时设置 currencyCode 和 units。这将被视为服务项目的固定价格。

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

string

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

string

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

string

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

object (Label)

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

string

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

string

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

string

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

string

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

string (int64 format)

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

integer

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