Package google.maps.booking.v1alpha

string

此操作链接的入口点网址。

string

BCP-47 语言标记，用于标识此 URI 中的内容所支持的语言。

string

ISO 3166-1 alpha-2 国家/地区代码。留空即表示国家/地区范围不限。

ActionPlatform

用于指明应在哪个平台上执行此操作。如果未设置此字段，ACTION_PLATFORM_WEB_APPLICATION 将用作后备平台。

ActionLinkType

预定的操作类型。

OrderOnlineMetadata

在线订单链接的元数据。支持 ActionLinkType 为 ACTION_LINK_TYPE_SHOP_ONLINE 的操作。

FoodOrderingMetadata

订餐链接的元数据。支持操作类型：* ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT 不支持 ACTION_LINK_TYPE_ORDER_FOOD。

Text

通过“通过 Google 预订”功能预订时向用户显示的自定义消息。

Timestamp

预约空档的开始时间。

Duration

预约空档的持续时间

int64

此可用性的总空档数和可用空档数。示例：

• 瑜伽课有 10 个空档，其中 3 个已预订：availability {spots_total: 10, spots_open: 7 ...}
• 按摩椅服务空档已订满：availability {spots_total: 1, spots_open: 0 ...}

注意：如果使用下面指定的可用性压缩格式发送请求，将推断出以下两个字段。

• Recurrence 表示 spots_total=1 和 spots_open=1。
• ScheduleException 表示 spots_total=1 和 spots_open=0。

int64

空缺数量。

string

用于标识可用性空档的可选不透明字符串。如果设置，它将包含在预订/更新/取消预约的请求中。

Resources

当服务中包含不同的工作人员或房间时，用于消除此可用性空档与其他空档之间的歧义的可选资源。

例如，同一瑜伽课程有 2 位老师：

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

ID 列表，其中列出了可用于支付此空档费用的付款方式。实际的付款方式需在商家级别定义，且多个商家可共享付款方式。

该字段将替换服务消息中指定的任何 payment_option_ids。同样，此处指定的 payment_option_ids 无需在服务消息中显示，但必须在商家级别定义。

Recurrence

可用性的重复周期信息，表示多个开始时间。重复周期应包含一个工作日的预约。

ScheduleException

无法安排此服务的时间。如需限制 schedule_exception 消息的数量，请考虑合并相邻的例外情况。

Deposit

适用于此可用性的可选押金。如果指定了押金，则会替换在服务级别定义的押金。

NoShowFee

适用于此可用性的可选违约金。如果指定了违约金，则会替换在服务级别定义的违约金。

RequireCreditCard

表明用户是否必须提供信用卡信息才能预订此可用性空档。如果未设置该值，将从服务级别（如果已在该级别设置）继承。（可选）

string

表示此可用性空档支持的票券类型列表。如果未设置该值，则父级服务中的所有票券类型均适用于此空档。请注意，必须在父级服务中定义此字段的值。示例：

• 具有四种票券类型的服务：TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

如需表示工作日期间的商品目录，请使用：availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}。如需表示节假日期间的商品目录，请使用：availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}。

• 具有三种票券类型的服务：TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

如需表示这三种票券类型均适用于此时间空档，请使用 availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} 或 `availability {...}'（请勿在此空档内设置 ticket_type_id）。

（可选）

DurationRequirement

显示空档时长和/或结束时间的要求。如果空档不可用，系统将忽略此字段。不用于推荐活动类别。（可选）

SchedulingRuleOverrides

可用性时间安排规则。如果填充了字段，则这些字段将覆盖服务级 SchedulingRules 上任何相应的时间安排规则。

ConfirmationMode

表示预订此可用性时使用哪种确认模式。使用 CONFIRMATION_MODE_SYNCHRONOUS 的确认模式创建可用性的预订时，必须立即确认或拒绝。如果尝试使用 CONFIRMATION_MODE_ASYNCHRONOUS 的确认模式创建可用性的预订，则必须立即拒绝或创建状态为 PENDING 的预订。

Timestamp

可用性重复截止时间的时间戳，需包含最大时间单位的世界协调时间 (UTC)。

Duration

定义连续可用性空档之间的时间。

示例：一个可用性的 duration 为 20 分钟、repeat_every 为 30 分钟、start_time 为上午 9:00、repeat_until 为上午 11:00，该可用性将在上午 9:00-9:20、上午 9:30-9:50、上午 10:00-10:20、上午 10:30-10:50 和上午 11:00-11:20 生成空档。（必填）

TimeRange

例外情况的时间范围。由重复周期描述且与此已打烊-营业中时间范围重叠的任何空档都将被视为不可用。

示例：如果重复周期指定时长为 20 分钟、repeat_every 为 30 分钟、start_time 为上午 9:00 且 repeat_until 为上午 11:00，则 time_range 为上午 9:45-11:00 的 ScheduleException 会使上午 9:30-9:50、上午 10-10:20 和上午 10:30-10:50 的空档不可用。

请注意，由于时间范围为已打烊-营业中，因此，从上午 11 点开始的空档不会受到影响。

int64

可预订此空档的最后时间（以秒为单位）。此时间戳必须在空档的 start_sec 之前（如需支持用户在开始时间后进行预订，请使用服务级 SchedulingRules.min_booking_before_end_time）。如果存在，则将覆盖相应服务的 SchedulingRules 的 min_booking_buffer 中任何指定的内容。

int64

能够预订此空档的最早时间（以秒为单位）。此时间戳必须在空档的 start_sec 或 last_bookable_sec（如果指定）之前。

int64

如果设置，则可通过“通过 Google 预订”取消此特定预约空档的最后时间（以自 Unix 纪元以来的秒数表示）。此字段将覆盖任何服务级别的取消规则。（可选）

string

资源名称，格式为 partners/{partner_id}/feeds/{feed_name}。

GenericDeleteRecord

要删除的记录。一个 API 调用中最多允许 1000 条记录。

string

资源名称，格式为 partners/{partner_id}/feeds/{feed_name}。

GenericRecord

要插入和/或更新的记录。一个 API 调用中最多允许 1000 条记录。

string

格式为 partners/{partner_id}。

ExtendedServiceAvailability

扩展的服务可用性，用于替换现有可用性空档。

ExtendedServiceAvailability

成功更新的已扩展服务可用性消息，用于替换现有可用性空档。

string

预订的资源名称：partners/{partner ID}/bookings/{booking ID}

string

空档的商家 ID

string

商家服务的 ID

Timestamp

预约空档的开始时间

Duration

预约空档的持续时间

ClientInformation

进行预约的客户的个人信息

BookingStatus

预订状态

PaymentInformation

与预订相关的付款交易信息。

int64

预订的就餐人数

Cause

预订失败的原因。（必填）

CreditCardType

（仅当原因为 PAYMENT_ERROR_CARD_TYPE_REJECTED 时才需要）

string

该可选字段适用于仅出于调试目的添加其他信息的合作伙伴。（可选）

PaymentFailureInformation

与付款失败相关的信息。

ThreeDS1Parameters

供 RwG 集合商家用以启动 3DS1 用户身份验证协议的参数。除非 BookingFailure.cause 设置为 PAYMENT_REQUIRES_3DS1，否则系统会忽略此参数。

string

可加载供用户进行身份验证的表单的网址。

string

PaymentAuthentication 请求。将发布到 ACSUrl 表单（如果提供）。

string

ACS 提供商所用的标识符。将发布到 ACSUrl 表单（如果提供）。

string

商家数据。将发布到 ACSUrl 表单（如果提供）。

RefundCondition

适用于政策的零或多个退款条件。

Duration

服务开始前的时段，在该时间范围内取消预订的客户可以收到有关 refund_percent 中指定的部分服务费用的退款。如果将该字段设置为 0（默认值），用户将可随时取消相应服务。

uint32

只要在服务开始时间前至少 min_duration_before_start_time 取消预订，将退还的服务费用百分比，值的范围为 [0, 100]。将该字段设置为 0（默认值）表示相应服务不支持退款。如果设置为 100，则该服务可全额退款。

string

客户的名字

string

客户的姓氏

PostalAddress

客户的地址

string

客户的电话号码

string

客户的电子邮件地址

string

拥有此商家的合作伙伴的父级资源名称，格式为 partners/{partner_id}。

string

要用于此商家的商家 ID。

Merchant

要创建的商家。

string

拥有此服务的商家的父级资源名称，格式为 partners/{partner_id}/merchants/{merchant_id}。

string

要用于此服务的服务 ID。

Service

要创建的服务。

CreditCardType

受支持的信用卡列表。留空表示不支持任何信用卡。

string

要删除的商家的资源名称。格式为：partners/{partner_id}/merchants/{merchant_id}

string

要删除的服务的资源名称。格式为 partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

存款金额。

int64

至少需要提前多久取消预订才会退回押金。

PriceType

定义如何根据可用性确定押金。

Text

我们会建议用户仅通过下列付款方式付款。

Duration

时长下限。

Duration

时长上限。

string

这是必填字段，用于指定以下可用性消息所属的商家。

string

这是必填字段，用于指定以下可用性消息所属的服务。

Timestamp

如果提供，我们会将提供的可用性实体视为 [start_time_restrict, end_time_restrict] 的完整概况。也就是说，如果符合以下条件，系统将会删除所有现有的可用性：

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

如果设置了 duration 消息，系统会进一步对条件进行限制：

  availability.duration == duration_restrict

如果设置了 resources_restrict 消息，系统会进一步对条件进行限制：

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

这些字段通常用于对特定时间范围内的可用性进行完整的更新。

已设置 start_time_restrict 但未设置 end_time_restrict 时，表示所有时间均从 start_time_restrict 开始。

Timestamp

已设置 end_time_restrict 但未设置 start_time_restrict 时，表示所有时间均不超过 end_time_restrict。

Duration

设置持续时间可进一步限制为仅更新与持续时间匹配的可用性。

Resources

设置 resources_restrict 可进一步限制为仅更新此组资源。资源的所有 ID 字段必须完全匹配。

Availability

新的可用性列表。

int64

此 Feed 新添加的项。内容可以是商家、服务或可用性空档，具体取决于 Feed 的类型。

int64

现有项，根据需要根据 Feed 中的较新信息进行更新。

int64

此 Feed 中已不存在的商品，并因此而被移除。

string

Feed 资源的名称，格式为

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

此 Feed 的处理状态。

string

如果我们无法处理此 Feed，人类可读的字符串用于提供更多详细信息。

FeedStatistics

特定于此 Feed 的统计信息。

FeeDetails

在商品总金额的基础上向用户收取的费用的详细信息。针对不同类型的费用（例如服务费、配送费等）重复。

AdvanceOrderDetails

有关高级订购支持（也称为提前下单）的详细信息，该功能允许用户在晚于当前时间下单履单。

Duration

固定时长。例如：30 分钟。

DurationRange

时长范围。示例：* 30 分钟至 45 分钟 * 超过 30 分钟 * 少于 50 分钟

bool

如果支持提前订单（也称为提前下单），则为 True。（必填）

FeeType

费用类型。（必填）

FeeAmount

以单位货币和/或购物车价值百分比表示的费用金额。（必填）

QuantitativeValue

以购物车价值百分比表示的费用。支持范围（有界限和无界限）或固定百分比。值应介于 0 到 100 之间。例如：* 固定 5.5% * 至少为 5.5% * 最大为 5.5% * 4.5% 至 5.5%

Money

固定金额。例如 USD 3.5。

MoneyRange

金额范围。示例：* 3.5 美元 - 5.5 美元 * 最低 3.5 美元 * 最高 5.5 美元

bool

未知金额。

FulfillmentType

必需。履单类型。

AvailableDay

必需。此履单方法有货的日期列表（最好提供至少 2 天）。

FeeDetails

必需。履单方法的费用详情。

Price

必需。与操作链接关联的 fulfillment 方法的最低顺序。

Date

必需。履单方法的可用日期。假定采用商家所在的时区。

Timestamp

必需。Unix 时间戳。用户上次可在 fulfillment_date之前订购和接收商品的时间。换句话说，在 last_ordering_time 之后，fulfillment_date 将不再显示为可用。

例如，如果 fulfillment_date 为 2020-08-10: - last_ordering_time 值为 2020-08-10 18:00，则表示客户必须在当天下午 6 点之前下单，才能在 2020 年 8 月 10 日收到订单。如果 last_ordering_time 值为 2020-08-08 20:00，则表示客户必须在两天前 8 点之前下单，才能在 2020 年 8 月 10 日收到订单。

NoFee

履单方法免费。

MinimumFee

与履单方法相关的基本费用。

FixedFee

与履单方法相关的固定费用。

Price

必需。履单方法的固定费用金额。

Price

必需。履单方法的基本费用金额。

Timestamp

必需。此时间戳用于确定对广告资源应用删除操作的顺序。

bytes

适用于并非基于 proto 的 Feed。

Any

适用于基于 proto 的 Feed。

Timestamp

必需。此时间戳用于确保商品目录更新按正确的顺序排列。

bytes

适用于并非基于 proto 的 Feed。

Any

适用于基于 proto 的 Feed。

double

纬度（以度为单位）。（可选）

double

经度（以度为单位）。（可选）

PostalAddress

营业地点的邮政地址（首选）。

string

非结构化地址也可用作备用地址。例如：“北京市海淀区中关村东路 1 号院”

string

必需。资源名称，格式为：partners/{partner_id}/merchants/{merchant_id}/status。

string

Feed 资源的名称，格式为

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

此家政服务所属的高级类别。例如：管道工、电工等

string

给定家政服务所属类别下的职位类型。例如：unclog_drain 和 install_faucet 是“管道工”类别下的作业类型。

string

要使资源失效的资源的名称。

例如，对于自提资源，名称应采用 partners/{partner_id}/pickups/{pickup_id} 格式。实现必须移除已识别资源的缓存版本。

string

商家服务的 ID。

int64

预约空档的开始时间，以自 Unix 纪元以来的世界协调时间（以秒为单位）表示。

int64

预约空档的时长（以秒为单位）。

OrderedTickets

按票券类型订购的票券数量。

Price

此订单项的总价格（不含税）。

BookingStatus

订单项的状态。

string

票券类型的 ID。

int32

订购的此类门票的数量。

string

必需。拥有此商家状态集合的父级。格式：partners/{partner_id}/merchants

int32

必需。需要返回的最大项数。 请注意，服务器可能会缩减页面大小。

string

可选。从上一个 ListMerchantStatusResponse 返回的 nextPageToken 值（如果有）。

BookingInventoryStatus

可选。按预订商品目录状态过滤结果的可选限制。

WaitlistInventoryStatus

可选。用于按候位名单商品目录状态过滤结果的可选限制。

GeoMatchingStatus

可选。按地理位置匹配状态过滤结果的可选限制。

MerchantStatus

满足过滤条件的商家状态的列表。

string

用于检索下一页结果的令牌。如果为空，则列表中无其他结果。

string

Feed 资源的名称，格式为

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

需要返回的最大项数。

string

从上一个 List 请求返回的 next_page_token 值（如果有）。

State

用于按 Feed 状态过滤结果的可选限制。

TimeRange

用于按上限和下限过滤结果的可选限制。如果未设置 start_time，则默认以 UNIX 时间为开始时间。如果未设置 end_time，则默认为现在。

FeedStatus

按时间倒序排列的已上传 Feed 的状态列表。返回的最大项数取决于请求中的 page_size 字段。

string

用于检索下一页结果的令牌。如果为空，则列表中无其他结果。

string

IETF BCP 47 语言代码，例如 en、mas、zh-Hant、de-CH-1901。请参阅 http://www.w3.org/International/articles/language-tags/。

string

采用上述语言区域的消息 (UTF-8)。

string

Google Places 数据库中和 Google 地图上某个地点的地点 ID。如需详细了解地点 ID，请参阅 https://developers.google.com/places/web-service/place-id。如果提供，Google 会将营业地点与此地点进行匹配。

string

营业地点的名称、电话、网址和地理位置用于将营业地点与 Google 地图上已有的地点进行匹配。

此字段是可选的，但在某些情况下可能是必需的。例如，没有名称的 Service.location 不会与商家实体匹配，即使这两个实体位于同一地址也是如此。（可选）

string

包含国家/地区代码的营业地点公开电话号码，例如 +14567891234。 （可选）

string

营业地点公共网站的网址。（可选）

GeoCoordinates

营业地点的地理位置信息，包括纬度、经度和地址。（可选）

LocationType

如果为服务提供了此营业地点，则必须提供该营业地点的类型。

string

服务中对营业地点的唯一引用。此 ID 可用于在其他服务字段中引用此营业地点。例如：在自定义信息录入表单中，可以使用一组营业地点 ID 来指定自提地点选项。如果已设置，此 ID 在同一服务中应具有唯一性。（可选）

string

商家资源名称，格式为 partners/{partner_id}/merchants/{merchant_id}。

string

merchant_name、telephone、url 和 geo 用于将合作伙伴商品目录与 Google 地图上已有的商家进行匹配。此信息不会显示。

商家的名称。

string

商家的公开电话号码（包括国家/地区代码和区号），例如+14567891234。

string

商家公开网站的网址。

GeoCoordinates

商家的地理位置信息，包括纬度、经度和地址。

string

集合商家平台中商家的类别。

int64

该字段已弃用。

uint32

商家的税率（以 0.01% 为基准点）。例如，如果税率为 7.5%，应将该字段设置为 750。

如果未设置或将该字段设置为 0，对于由此商家提供的任何服务，向用户收取的总费用为 Service.price 所指定的确切价格。该服务价格被视为无需缴纳税费或已包含适用税费。系统不会将税费作为单独的订单项向用户显示。

如果将该字段设置为任何非零值，对于由此商家提供的任何服务，向用户收取的总费用将包含服务价格以及使用此处提供的税率计算得出的税费。最小货币单位的小数部分（例如，1 美分的小数部分）将四舍五入为最接近的偶数。系统会将税费作为单独的订单项向用户显示。

此字段已弃用，请改用 tax_rate。

TaxRate

商家的税率。如果存在该字段，该字段将替换已弃用的 tax_rate_basis_points 字段。空白消息（即 tax_rate { }）会将适用税率重置为零。

PaymentRestrictions

对此商家所接受付款方式的限制。如果未设置此字段，则假定不存在任何限制。

PaymentOption

此商家所支持的付款方式。此商家的服务将能够单独限制其允许的付款方式。

PaymentProcessorConfig

适用于令牌化付款处理方的配置（如果商家支持）。

TokenizationConfig

适用于令牌化付款处理方的配置（如果商家支持）。

Terms

特定商家的条款及条件，在用户使用“通过 Google 预订”功能预订服务时显示。此外，这些集合商家合作伙伴的条款及条件会始终向用户显示，且不得在此处提供。

string

不透明的字符串，用于在显示合作伙伴属性时标识面向消费者的品牌。此字段允许拥有多个面向消费者的品牌的合作伙伴在同一 Feed 中提供所有品牌的商家。

品牌由面向消费者的属性（例如名称、徽标、服务条款及隐私权政策）组成。

如果只有一个面向消费者的合作伙伴品牌，则无需设置该字段，且可将其忽略。

如果合作伙伴…

没有多个面向消费者的品牌？--> 请忽略此字段

配置了多个品牌？

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

请注意，大多数合作伙伴都不需要设置该字段。如果合作伙伴要使用该字段，必须先与我们联系以配置单独的品牌（包括默认品牌）。

MerchantMatchingHints

可帮助 Google 将商家与 Google 地图上的地点进行匹配的提示。请注意：大多数合作伙伴都不需要设置该字段，因为 Google 会使用上述信息将商家与 Google 地图上的地点进行匹配。（可选）

ServiceAttribute

用于描述此商家的服务的任何服务属性的定义。（可选）

ActionLink

可选。一个操作网址，包含相关语言、支持的国家/地区列表、类型以及可选平台，用于指明应在哪个平台上执行此操作。

Advisement

可选。特定商家针对通过“通过 Google 预订”加入等候名单的用户提供的一般建议。建议中各个文本字段的长度应限制为 100 个字节。

string

Google Places 数据库中和 Google 地图上某个地点的地点 ID。如需详细了解地点 ID，请参阅 https://developers.google.com/places/web-service/place-id。

string

商家状态资源名称，格式为 partners/{partner_id}/merchants/{merchant_id}/status

string

合作伙伴提供的商家名称。

GeoCoordinates

合作伙伴提供了商家的地理位置信息。

ProcessingStatus

商家处理状态。

BookingStatus

与端到端预订集成相关的状态。

WaitlistStatus

与候位名单集成相关的状态。

PlaceInfo

此商家的匹配地理位置信息。如果商家与地理位置不匹配，则为空。

LocalServicesMatchInfo

此商家的本地生活服务广告匹配项。如果不是本地服务商家或与任何提供商都不匹配，则为空。

DirectUrl

一个网址列表，演示当前商家商品目录的内容。请注意，这并不意味着广告资源实际上处于投放状态，网址可能与公开显示的网址不同。

bool

如果商家在接下来的 30 天内有商品目录，则为“true”。并不保证商家实际会得到投放。

UrlType

此网址的类型。

string

可能会显示此商家的网址。

MatchedProvider

匹配的服务提供商。一个商家可以与多个服务提供商相匹配。

int64

Google 本地生活服务外部客户 ID。

string

本地生活服务类别（行业）。例如：“管道工”和“carpet_cleaning”

string

地点的名称。

string

以当地语言显示的格式化地址。

string

此地点的 Google 地点 ID。可用于构建 Google 地图网址或提取地点的更多详细信息。如需查看用法示例，请参阅 https://developers.google.com/places/web-service/place-id。

bool

如果商家提供候位名单服务，则为 true。并不保证商家实际会得到投放。

Money

最低金额。

Money

最高金额。

Price

用户未按时赴约时向其收取的费用金额。

PriceType

定义如何根据可用性确定费用。

string

订单的资源名称：partners/{partner ID}/orders/{order ID}

ClientInformation

下单客户的个人信息。

PaymentInformation

与订单相关的付款交易信息。

string

此订单中所有服务所属的商家的 ID。

LineItem

此订单中的订单项。

FulfillmentOption

在线订单操作链接的可用履单选项。

PrepaymentStatus

预订的预付款状态。如果 prepayment_status 为 PREPAYMENT_PROVIDED 或 PREPAYMENT_REFUNDED，则 payment_transaction_id 包含相关联的唯一交易 ID。

string

与预订关联的付款交易的唯一标识符。如果不适用，则为空。

string

此 ID 用于标识此付款方式。

此 ID 适用于所有集合商家，而且如果多个商家重复使用同一个值，则可允许用户在向这些商家付款时都可以使用相应的付款方式。

当多个商家重复使用某个 ID 时，更新某个商家所接受付款方式的任何值后，其他商家使用相同 ID 所标识的付款方式也会一并更新。因此，最好为所有付款方式使用同一 ID，并始终将其更新为相同的值，避免出现非确定性行为。

string

付款方式的名称。此信息可向用户显示。

string

付款方式的说明。此信息可向用户显示。

Price

付款方式的价格。

TaxRate

此付款方式的税率。如果存在该字段，该字段将替换商家或服务中显示的 tax_rate 字段。空白消息（即 tax_rate { }）会将适用税率重置为零。

PaymentOptionType

此付款方式的类型。针对临时用户可一次性使用，对套餐可多次使用，对会员而言则无限制。

int64

此付款方式可用于多少次会话。仅适用于多会话 / 套餐，其值应为 >1.

TimeRange

可在此时间范围内购买付款方式。

TimeRange

可在此时间范围内使用付款方式（例如，2017 年 1 月特惠价格）。如果存在，此字段将替换 valid_duration 和 activate_type。

Duration

付款方式的有效期限（例如 30 天的会员资格有效期）。

ActivationType

定义如何确定此付款方式的有效开始日期。

UserPurchaseRestriction

有资格购买此付款方式的用户需满足的限制条件。可用于将促销付款方式的限制为部分用户。如果未设置，则所有用户均符合条件。

Processor

指定此配置所适用的付款处理方合作伙伴。

string

用于通过付款处理方识别此商家的密钥。

如需了解 Stripe，请访问 https://stripe.com/docs/dashboard#api-keys。如需了解 Braintree，请访问 https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

随付款请求一起发送给付款处理方的 API 版本号。

CreditCardRestrictions

对此商家所接受的信用卡的限制。如果未设置该字段，我们会默认接受所有信用卡。请注意，CreditCardType 支持的卡的列表会不断增加，这意味着如果留空，则相应配置需要适应将来的更改。

Price

可能因配送方式而异的费用。

Price

处理用户付款方式的费用。

Price

针对服务评估的额外费用。

Price

进入场馆/设施的费用。

Price

每张门票的税费。

string

国家/地区，使用其 ISO 3166-1 alpha-2 国家/地区代码指定，例如“US”（必填）

string

市行政区（例如“秦淮区”）。（必填）

string

地区（例如“南京市”）。只有在地区通常是地址的一部分的国家/地区才需要填写此字段。（可选）

string

邮政编码，例如“210006”。（必填）

string

街道地址（例如“中山南路 1 号”）。（必填）

int64

以微观的货币单位表示的价格。最小货币单位的小数部分将四舍五入为最接近的偶数。（例如，2.5 美分四舍五入为 2 美分，3.5 美分四舍五入为 4 美分，0.5 美分四舍五入为 0 美分，2.51 美分四舍五入为 3 美分）。

string

ISO 4217 中定义的货币价格。

string

可选且不透明的字符串，用于标识与扩展价格关联的定价选项。

double

奇异值。例如：5.6

RangeValue

也可以是开放式或有界限值的范围。例如：* 至少为 5.5 * 最多为 5.5 * 5.5 至 6.5

double

最小值。

double

最大值。

double

平均评分值（number_of_ratings > 0 时为必填项）。该值必须在 [1, 5] 的范围内，并且当且仅当 number_of_ratings 为零时才能省略。

uint64

计算此值时所用的评分数量（必填）。

string

媒体来源的网址。Google 会抓取托管在此网址上的媒体。

MediaType

此媒体来源的类型。

Text

对支持国际化的媒体的说明，仅支持纯文本格式。所有 HTML 组件均会被删除。（可选）

Attribution

有关媒体来源的提供方信息。请注意，如果提供方信息需要与媒体一同显示，以便注明摄影师或代理机构，则必须设置该字段。（可选）

string

已弃用，建议使用 localized_caption。

Text

用于注明支持国际化的摄影师或代理机构的文本。此文本将与源媒体一同显示。请注意，此字段仅支持纯文本，所有 HTML 组件都将被删除（基于超链接的提供方说明不受支持）。

string

已弃用，建议使用 localized_text。

ServiceAvailability

用于替换现有服务的服务可用性。

string

提供服务的工作人员的可选 ID。此字段用于标识所有商家、服务和可用性记录中的工作人员。此外，考虑到需与之前的预订相关联，此字段需要随着时间的推移保持一致。如果存在 people_name，则必须提供此字段。

string

提供服务的工作人员的可选姓名。办理预订的用户将看到此字段，该字段应该是用户可理解的内容，而非不透明的标识符。如果存在 people_id，则必须提供此字段。

string

服务所在房间的可选 ID。此字段用于标识所有商家、服务和可用性记录中的房间。此外，考虑到需与之前的预订相关联，此字段需要随着时间的推移保持一致。如果存在 room_name，则必须显示此字段。

string

服务所在房间的可选名称。办理预订的用户将看到此字段，该字段应该是用户可理解的内容，而非不透明的标识符。（可选，但如果存在 Room_id，则为必需属性）在用餐中，房间名称应仅用于休息区（例如酒吧或露台），而不应用于固定价格的菜单、特殊活动或任何其他非客房值（例如预订或晚餐）。强烈建议不要在默认休息区没有关联的会议室。

int32

仅适用于餐饮服务：此时间空档内可容纳的就餐人数。一家餐馆可以同时与多个空档相关联，每个空档可指定不同的 party_size，例如可预订 2 人、3 人或 4 人座位。

int64

网上取消预订应至少提前通知的时间（以秒为单位）。（可选）

Price

在至少应提前通知的期限内取消时应支付的费用。

Price

未取消预订时应付的违约金。

AdmissionPolicy

适用于此服务的准入政策。如果未设置，默认为 TIME_STRICT。（可选）

CancellationPolicy

时间表规则取消政策。（对于推荐活动而言是必需的）

int64

从上次预订时间到可用性空档开始时间的时长（以秒为单位）。

int64

从上次预订时间到可用性空档结束时间的时长（以秒为单位）。如果设置了此字段，则“admission_policy”字段必须设置为 TIME_FLEXIBLE，以指明用户可以在空档开始后使用所购票券。

string

服务资源名称，格式为 partners/{partner_id}/merchants/{merchant_id}/services/{service_id}。

string

服务的名称，例如“男士理发”。已弃用，请改用 localized_service_name。

Text

服务的名称，例如“男士理发”。可能在多个语言区域。

string

可供用户查看的服务简介。已弃用，请改用 localized_description。

Text

可供用户查看的服务简介。

此字段同时支持纯文本格式及类似于 HTML 的格式。与纯文本部分不同，自定义布局的创建可使用标题、段落、列表和一些词组标记。请仔细阅读以下说明和注意事项，确保提供最佳的用户体验。

支持的类似于 HTML 的格式标记：

标题标记：<h1>、<h2>、<h3>、<h4>、<h5>、<h6>
标题标记可用于显示标题和副标题。例如，<h1>行程</h1>会将内嵌文本显示为该部分最重要的标题。请注意，所有内部 HTML 标记、样式或属性都将被忽略。例如，<h1 style=".."> 与 <h1> 的处理方式相同。仅保留纯文本。

段落标记：<p>
段落标记可用于突出显示详细信息或内容。任何内部标记、样式或属性都将被忽略，但存在以下几种例外情况：<br>、<strong> 和 <em>。如需了解详情，请参阅下面的词组标记部分。

列表标记：<ul>、<ol>、<li>
<ul> 标记可与 <li> 标记用于显示无序列表，<ol> 标记可与 <li> 标记用于显示有序列表。这是显示核对清单、时间表或任何其他适合您的用例的列表的好方法。
示例：如需显示游轮旅行的一系列特色，请执行以下操作：
<ol>
<li>绝美海景，有机会与野生动物一起玩耍。</li>
<li>精心设计旅行安排和服务。</li>
<li>保证最低价。</li>
</ol>
请注意，只有<li><ul> 岁以下的儿童或 <ol>代码将被转换。所有其他子级内容都会被舍弃。此外，所有内部标记、属性和样式都会被忽略，只保留纯文本内容。

分区标记：<div>
系统会根据上述规则对 <div> 标记受支持的所有内部标记进行解析，<div> 标记本身并不意味着在此进行任何分组或缩进。此外，所有内部属性和样式都会被忽略。

词组标记：<br>、<strong>、<em>
仅支持以上 3 种标记。<br> 用于对段落中的内容进行分行，<strong>/<em> 用于突出显示重要文本。所有其他词组标记都会被忽略。

不受支持的标记：

• 不允许使用 <html>、<header> 和 <body> 标记。
• 上面未提及的所有其他标记均不受支持（例如 <table>、<td> 等标记）。
  任何网址、锚标记和链接都会被删除，且任何时候都不会向最终用户显示。如果您想通过图片来打造丰富的用户体验，请通过下面的“related_media”字段发送图片的网址。
  

重要注意事项：

• 请勿使用上述受支持的标记以外的其他标记，因为不受支持的标记中的内容会被删除，用户体验也可能会受到影响。
  
• 尽量避免使用深层嵌套结构，例如 3 个以上的不同标题级别或嵌套列表。确保结构简单明了，从而打造更优质的用户体验。
  
• 如果目前支持的布局无法满足您的使用情形，请与“通过 Google 预订”团队联系。
  
• 建议的大小上限为 32000 个字符。

Price

服务的价格。

PriceInterpretation

说明价格的解析方式和面向用户显示的方式。可用于除餐饮和推荐活动之外的任何行业来配置服务价格的显示方式。

SchedulingRules

预约/取消预约的规则。

PrepaymentType

预付款是必需项、可选项还是不支持预付款。

PrepaymentTerms

与预付款完成相关的条款。

ServiceIntakeForm

已弃用。请使用 intake_form 和 per_ticket_intake_form。

ServiceIntakeForm

在用户预订此服务时，用于请求用户提供更多信息的表单。（可选）

ServiceIntakeForm

在用户预订此服务时，用于请求用户提供更多信息的表单。用户预订每张票券时均需填写一次该表单。（可选）

TaxRate

服务的税率。如果存在，则该字段将替换在商家级别设置的任何 tax_rate。空白消息（即 tax_rate { }）会将适用税率重置为零。

string

ID 列表，其中列出了可用于支付此服务费用的付款方式。实际的付款方式需在商家级别定义，且多个商家可共享付款方式。

Deposit

指定向用户收取押金的方式。如果指定了押金，则会替换在服务级别定义的押金。如果将该字段留空，系统会移除服务级别的所有押金。（可选）

NoShowFee

指定可能需要向用户收取的违约金。如果指定了违约金，则会替换在服务级别定义的违约金。如果将该字段留空，系统会移除服务级别的所有违约金。（可选）

RequireCreditCard

指明用户是否必须提供信用卡信息才能预订相应服务。可在可用性级别替换该字段。（可选）

ActionLink

与服务相关的操作链接。如果存在操作链接，则必须在服务中设置类型（见下文）。

ServiceType

服务的预定义类型。（可选）

TicketType

可预订/购买的服务票券类型（如果支持票券）。（可选）

RelatedMedia

与服务相关的图片。Google 会抓取并存储媒体，用于确保以最有效的方式向最终用户展示。（可选）

ServiceAttributeValueId

适用于相应服务的服务属性值（可选）。对于在相应商家中定义的每个服务属性，每项服务都可能具有零个或多个值。（可选）

WaitlistRules

加入等候名单需遵循的规则。

TicketingVerticalSpecificData

特定于活动门票行业的其他信息。（可选）

IntegrationType

我们所支持的集成深度。（可选）不适用于采用初级集成的合作伙伴。对于此类合作伙伴，“端到端”将始终处于停用状态。

PerOrderFee

用于购买相应服务的订单级费用。（可选）

ToursAndActivitiesContent

特定于“游览”和“活动”的内容字段。

Location

与服务相关的地点。重要注意事项：如果有多个与服务相关的已访问地点，或者 START_LOCATION 与 VISITED_LOCATION 不同，则必须指定 START_LOCATION。示例：- 对于途径 3 个地点的有向导的骑行之旅，需指定第一个地点。- 对于要在酒店大厅集合，然后前往参观地点的观光巴士之旅，需要指定会议地点。

Rating

此服务的用户评分，是针对所有评价的汇总指标。

HomeServiceData

家政服务行业特有的额外信息。（可选）

VirtualSession

可选。有关虚拟会话的信息。必须具有此权限才能启用虚拟服务。

DirectMerchantPayment

可选。当服务要求用户直接向商家付款时需要添加的其他信息。重要提示：RwG 不会参与此交易。如果定义了 virtual_session 但服务不是免费服务，或者 prepayment_type 未设置为 REQUIRED，则必须提供此值。

ChargeTiming

相对于购买时间的扣款时间。

int64

服务开始时间前，系统向用户收取费用的时间（以秒为单位）。只有在 ChargeTiming 为 CHARGE_LATER 时才应设置此字段。

string

用于唯一标识同一商家的此服务属性与其他服务属性的标识符，例如“account-type”。

string

此属性的用户可见名称，例如“账号类型”。

Value

此服务属性的所有可能值。

string

用于在此服务属性中唯一标识该值的标识符，例如“personal”。

string

值的用户可见名称，例如“个人”。

string

Merchant.service_attribute 中定义的属性的 ID，例如“service-type”

string

此属性值的 ID，例如“理发”。必须与服务属性定义中的 value_id 相匹配。

string

要将此参数应用到的服务资源的名称。格式为 partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

如果提供，我们会将提供的可用性实体视为 [start_time_restrict, end_time_restrict] 的完整概况。也就是说，如果符合以下条件，系统将会删除所有现有的可用性：

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

如果设置了 duration 消息，系统会进一步对条件进行限制：

  availability.duration == duration_restrict

如果设置了 resources_restrict 消息，系统会进一步对条件进行限制：

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

这些字段通常用于对特定时间范围内的可用性进行完整的更新。

已设置 start_time_restrict 但未设置 end_time_restrict 时，表示所有时间均从 start_time_restrict 开始。

Timestamp

已设置 end_time_restrict 但未设置 start_time_restrict 时，表示所有时间均不超过 end_time_restrict。

Duration

设置持续时间可进一步限制为仅更新与持续时间匹配的可用性。

Resources

设置 resources_restrict 可进一步限制为仅更新此组资源。资源的所有 ID 字段必须完全匹配。

Availability

新的可用性列表。

ServiceIntakeFormField

将向用户显示的字段。

bool

如果值为 true，系统将向新客户显示此表单。已弃用。信息录入表单不支持此功能。

bool

如果值为 true，系统将向回头客显示此表单。已弃用。信息录入表单不支持此功能。

string

集合商家合作伙伴提供的字符串，用于唯一标识表单字段。此 ID 应与相应表单字段回答中的 ID 相同，且必须在服务级别和单张票券信息录入表单中具有唯一性。（必填）

FieldType

此字段的类型。

string

该字段中向用户显示的文本。已弃用，请改用 localized_label。

Text

该字段中向用户显示的文本。可面向多个语言区域提供。（必填）

string

当且仅当字段类型为 LOCATION_SEARCH 时设置。请使用“location_id”在“位置”字段以指定地理位置值。

Text

当且仅当字段类型是 MULTIPLE_CHOICE、CHECKBOXES 或 DROPDOWN 时设置。用于枚举可能的选项。

bool

指明用户是否必须回答此字段。

bool

指明是否允许在预定义的答案之外使用自定义值。仅当字段类型为 LOCATION_SEARCH 时，此字段才适用。（可选）

Text

除所提供的值外，提供的其他选项。仅在字段类型为 LOCATION_SEARCH 时适用。例如：除了提供的地点列表外，您还可以使用“稍后与供应商联系”选项。（可选）

string

如果仅应在用户预订某些类型的票券时显示此问题，则应将此字段设置为一组适用的票券类型 ID。如果问题始终适用，请将此字段留空。

Text

输入的提示文本，以文本占位符的形式显示。这仅在字段类型为 SHORT_ANSWER 或 PARAGRAPH 时适用。（可选）

int32

一种税率，以百万分之一计，精确到小数点后 6 位。例如，如果税率为 7.253%，则应将该字段应设置为 7253000。

如果未设置或将该字段设置为 0，对于由此商家提供的任何服务，向用户收取的总费用为 Service.price 所指定的确切价格。该服务价格被视为无需缴纳税费或已包含适用税费。系统不会将税费作为单独的订单项向用户显示。

如果将该字段设置为任何非零值，对于由此商家提供的任何服务，向用户收取的总费用将包含服务价格以及使用此处提供的税率计算得出的税费。最小货币单位的小数部分（例如，1 美分的小数部分）将四舍五入为最接近的偶数。系统会将税费作为单独的订单项向用户显示。

string

（可选）指向条款及条件的网址。

string

将向用户显示的文字。请使用下面的 localized_text 进行新的集成。

Text

要向用户显示的本地化文本。

string

语言区域未知的文本值。当且仅当 localized_value 为空时为必填项。此值的语言区域可能取决于合作伙伴或服务提供商，不应将其假定为任何特定语言。

LocalizedString

每个语言的文本值。可选。

string

票券 ID 用于区分同一服务的不同票券类型，且仅在服务内是唯一的。

string

对 TicketType 的简要说明。

此内容可面向用户显示，例如“成人”、“儿童”、“退伍军人”和“Row J”等。该字段是必填字段，每种票券类型都应附有面向用户的说明。已弃用，请改用 localized_short_description。

Text

对支持国际化的 TicketType 的简要说明。

此内容可面向用户显示，例如“成人”、“儿童”、“退伍军人”和“Row J”等。该字段是必填字段，每种票券类型都应附有面向用户的说明。可分别针对不同语言区域提供不同的值。

Price

单张此类票券的价格，不含任何税费。服务税率适用于门票的税率。

PerTicketFee

购买此票券需支付的额外费用。（可选）

string

对此票券类型所代表的任何其他选项的说明（如有）。已弃用，请改用 localized_option_description。

Text

对此票券类型所代表的任何其他选项的说明（如有）。可分别针对不同语言区域提供不同的值。

当票券类型表示多个维度时，其他选项非常有用。

示例 1：将不同类型（例如“成人”、“儿童”）和语言作为附加选项的票券，TicketType 列表可如下所示：- { ticket_type_id: "ticket_type_1" localized_short_description { value: "成人" } localized_option_description { value: "英语" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "成人" } localized_option_description { value: "西班牙语" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "儿童" } localized_option_description { value: "英语" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "儿童" } localized_option_description { value: "西班牙语" } }

示例 2：具有防水袋附加选项且租借时长可长达数小时的皮划艇租借服务，其中 short_description 可以为“3 个小时”，而 option_description 可以为“包含防水袋”或“不含防水袋”：- { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 个小时" } localized_option_description { value: "英语" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 个小时" } localized_option_description { value: "西班牙语" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 个小时" } localized_option_description { value: "英语" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 个小时" } localized_option_description { value: "西班牙语" } }

可选，但如果服务的所有票券类型均已设置该字段，则应为其他所有票券类型设置该字段（可以使用默认的 option_description）。例如 [{ticket_type_1, 成人, 英语}, {ticket_type_1, 成人, ''}] 并非有效列表。

仅支持两种 HTML 格式标记： 和
。这两种标记用于指定同时包含标题和详细说明的选项，例如“高级座位
享受私人包厢，提供全包式座椅、专享电视和送餐到座服务。可在此欣赏如画般的田野风景。”

EventCategory

活动所属的类别。仅在活动属于某个预定义的类别时设置该字段。（可选）

string

合作伙伴网站上的活动网址。（可选）

Entity

与活动相关的实体列表。（可选）

AttendanceMode

必需。活动参加类型。

string

可选。可观看活动的网址。

Text

可选。活动的组织者。

string

可选。举办活动的组织者的网址。

OrganizerType

可选。组织者的类型。

string

必需。活动信息或说明所在网页的网址。

EventState

可选。事件的状态。

string

合作伙伴数据库中实体的唯一标识符。（可选）

string

实体的名称。（必填）

string

对实体进行明确描述的网页的网址。这是相应实体在合作伙伴网站上的网页（如有）；对于实体的其他公共网址，请使用 public_identification_data 中的 relevant_url。（可选）

EntityType

实体的类型。（可选）

EntityRole

实体在活动中的角色。（可选）

PublicIdentificationData

实体的公共引用。（可选）

string

内容主要涉及相应主题的任何网页的公共网址。包括官方网站、Discogs、社交媒体平台、维基百科或 IMDb 页面，例如 https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan。（可选）

string

艺术家或其他音乐实体的 36 个字符的 MusicBrainz 标识符（如适用）。如需了解详情，请访问 https://musicbrainz.org/doc/MusicBrainz_Identifier。（可选）

Timestamp

时间范围的下限。

Timestamp

时间范围的上限。

map<string, string>

令牌化配置通常会有一个 tokenization_parameter，其键为“gateway”，其值为处理方的名称。

其余参数取决于处理方。如需了解详情，请参阅 Google Pay 的文档。

Braintree 示例：tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe 示例：tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen 示例：tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

在付款令牌中添加用户在 Google Pay 中输入的结算信息（请参阅上文）。将此字段留空等同于指定 MIN。