REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

string

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

string

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

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

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

object (Category)

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

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

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

string

仅供输出。直观易懂的类别名称。此字段在读取营业地点时设置。修改位置时，必须设置 category_id。

object (ServiceType)

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

object (MoreHoursType)

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

{
  "serviceTypeId": string,
  "displayName": string
}

string

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

string

仅供输出。服务类型的直观易懂的显示名称。

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

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

string

仅供输出。时间类型的人类可读英文显示名。

string

仅供输出。时间类型的直观易懂的本地化显示名。

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": 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

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

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

object (TimePeriod)

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

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

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 表示指定日期字段结束时的午夜。

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

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

integer

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

integer

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

integer

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

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

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

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

日期中的年份。必须是 1 到 9999 之间的数字，如果使用 0，则可以指定不含年份的日期。

integer

一年中的某月。必须是 1 到 12 之间的数字，如果为 0，则表示不包含月份和日期。

integer

一个月中的第几天。必须是 1 到 31 之间的数字，并且对年份和月份有效，或者为 0 表示单独指定年份，或者在日期不重要的情况下指定年份和月份。

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

必需。表示上门服务商家的 [类型] [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 商家，此字段是必填字段，否则将被忽略。

此处指定的区域可以不同于此商家提供服务的区域对应的区域（例如，在区域之外的区域提供服务的服务区域商家）。

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

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

由地点 ID 表示的区域。最多可输入 20 个地点。

{
  "placeName": string,
  "placeId": string
}

string

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

string

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

{
  "adPhone": string
}

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

enum (OpenForBusiness)

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

boolean

仅供输出。指明此商家是否符合重新标记为营业的条件。

object (Date)

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

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

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 来详细了解为何他们没有商家语音信息。

{
  "description": string
}

string

必需。用您自己的声音描述的地点说明，其他人无法修改。

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

此营业地点与其存在关联的父级营业地点。

object (RelevantLocation)

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

string

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

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

必需。根据 placeID 指定位于关系另一侧的位置。

enum (RelationType)

必需。关系的类型。

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

string

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

object (TimePeriod)

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

{
  "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.
}

object (Money)

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

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

可选。此字段将设置为自由格式服务数据的情形。

{
  "serviceTypeId": string,
  "description": string
}

string

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

string

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

{
  "category": string,
  "label": {
    object (Label)
  }
}

string

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

object (Label)

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

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

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

string

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

string

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

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。