索引
AdsAccountLinkingService(界面)BookingNotification(界面)Feed(界面)InvalidationService(界面)InventoryStatus(界面)InventoryUpdate(界面)ActionLink(消息)ActionLink.ActionLinkType(枚举)ActionLink.EventMetadata(消息)ActionLink.EventMetadata.Surface(枚举)ActionPlatform(枚举)AdsAccountLink(消息)AdsAccountLink.State(枚举)Advisement(消息)Availability(消息)Availability.ConfirmationMode(枚举)Availability.DurationRequirement(枚举)Availability.LinkoutRequiredReason(枚举)Availability.Recurrence(消息)Availability.ScheduleException(消息)Availability.SchedulingRuleOverrides(消息)BatchDeleteGenericRecordsRequest(消息)BatchPushGenericRecordRequest(消息)BatchReplaceServiceAvailabilityRequest(消息)BatchReplaceServiceAvailabilityResponse(消息)Booking(消息)BookingFailure(消息)BookingFailure.Cause(枚举)BookingFailure.PaymentFailureInformation(消息)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters(消息)BookingStatus(枚举)CallMerchant(消息)CancellationPolicy(消息)CancellationPolicy.RefundCondition(消息)ClientInformation(消息)CreateAdsAccountLinkRequest(消息)CreateMerchantRequest(消息)CreateServiceRequest(消息)CreditCardRestrictions(消息)CreditCardRestrictions.CreditCardType(枚举)DeleteAdsAccountLinkRequest(消息)DeleteMerchantRequest(消息)DeleteServiceRequest(消息)Deposit(消息)DirectMerchantPayment(消息)DurationRange(消息)EconomicOperator(消息)ExtendedServiceAvailability(消息)FeedStatistics(消息)FeedStatus(消息)FeedStatus.State(枚举)FoodOrderingMetadata(消息)FoodOrderingMetadata.AdvanceOrderDetails(消息)FoodOrderingMetadata.FeeDetails(消息)FoodOrderingMetadata.FeeDetails.FeeAmount(消息)FoodOrderingMetadata.FeeDetails.FeeType(枚举)FulfillmentOption(消息)FulfillmentOption.AvailableDay(消息)FulfillmentOption.FeeDetails(消息)FulfillmentOption.FixedFee(消息)FulfillmentOption.FulfillmentType(枚举)FulfillmentOption.MinimumFee(消息)FulfillmentOption.NoFee(消息)GenericDeleteRecord(消息)GenericRecord(消息)GeoCoordinates(消息)GetAdsAccountLinkRequest(消息)GetMerchantStatusRequest(消息)GetStatusRequest(消息)HomeServiceData(消息)IntegrationType(枚举)InvalidateResourceRequest(消息)LineItem(消息)LineItem.OrderedTickets(消息)ListMerchantStatusesRequest(消息)ListMerchantStatusesRequest.BookingInventoryStatus(枚举)ListMerchantStatusesRequest.GeoMatchingStatus(枚举)ListMerchantStatusesRequest.WaitlistInventoryStatus(枚举)ListMerchantStatusesResponse(消息)ListStatusRequest(消息)ListStatusResponse(消息)LocalizedString(消息)Location(消息)LocationType(枚举)Merchant(消息)MerchantMatchingHints(消息)MerchantStatus(消息)MerchantStatus.BookingStatus(消息)MerchantStatus.DirectUrl(消息)MerchantStatus.DirectUrl.UrlType(枚举)MerchantStatus.LocalServicesMatchInfo(消息)MerchantStatus.LocalServicesMatchInfo.MatchedProvider(消息)MerchantStatus.PlaceInfo(消息)MerchantStatus.ProcessingStatus(枚举)MerchantStatus.WaitlistStatus(消息)MoneyRange(消息)NoShowFee(消息)Order(消息)OrderOnlineMetadata(消息)PaymentInformation(消息)PaymentOption(消息)PaymentOption.ActivationType(枚举)PaymentOption.PaymentOptionType(枚举)PaymentProcessorConfig(消息)PaymentProcessorConfig.Processor(枚举)PaymentRestrictions(消息)PerOrderFee(消息)PerTicketFee(消息)PostalAddress(消息)Prepayment(消息)PrepaymentStatus(枚举)Price(消息)PriceInfo(消息)PriceInterpretation(枚举)PriceRange(消息)PriceType(枚举)QuantitativeValue(消息)QuantitativeValue.RangeValue(消息)Rating(消息)RelatedMedia(消息)RelatedMedia.Attribution(消息)RelatedMedia.MediaType(枚举)ReplaceServiceAvailabilityRequest(消息)RequireCreditCard(枚举)Resources(消息)SchedulingRules(消息)SchedulingRules.AdmissionPolicy(枚举)Service(消息)Service.PrepaymentTerms(消息)Service.PrepaymentTerms.ChargeTiming(枚举)Service.PrepaymentType(枚举)Service.ServiceType(枚举)ServiceAttribute(消息)ServiceAttribute.Value(消息)ServiceAttributeValueId(消息)ServiceAvailability(消息)ServiceIntakeForm(消息)ServiceIntakeFormField(消息)ServiceIntakeFormField.FieldType(枚举)TaxRate(消息)Terms(消息)Text(消息)TicketType(消息)TicketType.InventoryType(枚举)TicketType.PriceDisplayType(枚举)TicketingVerticalSpecificData(消息)TicketingVerticalSpecificData.AttendanceMode(枚举)TicketingVerticalSpecificData.Entity(消息)TicketingVerticalSpecificData.Entity.EntityRole(枚举)TicketingVerticalSpecificData.Entity.EntityType(枚举)TicketingVerticalSpecificData.EventCategory(枚举)TicketingVerticalSpecificData.EventCreator(消息)TicketingVerticalSpecificData.EventState(枚举)TicketingVerticalSpecificData.OrganizerType(枚举)TicketingVerticalSpecificData.PublicIdentificationData(消息)TimeRange(消息)TokenizationConfig(消息)TokenizationConfig.BillingInformationFormat(枚举)ToursAndActivitiesContent(消息)UnsupportedPartySizeOption(消息)UpdateAdsAccountLinkRequest(消息)UpdateBookingRequest(消息)UpdateMerchantRequest(消息)UpdateOrderRequest(消息)UpdateServiceRequest(消息)UriTemplate(消息)UserPurchaseRestriction(消息)VirtualSession(消息)VirtualSession.VirtualPlatformInfo(消息)VirtualSession.VirtualPlatformInfo.Platform(枚举)WaitlistRules(消息)
AdsAccountLinkingService
用于管理 Google Ads 与合作伙伴中心之间的账号关联的服务。
| CreateAdsAccountLink | 
|---|
| 
                   
 创建 Google Ads 账号关联。这将在 Google Ads 账号与合作伙伴中心之间建立关联。在 Google Ads 门户获得批准之前,该关联将处于  
  | 
              
| DeleteAdsAccountLink | 
|---|
| 
                   
 删除 Google Ads 账号关联。这会解除 Google Ads 账号与合作伙伴中心账号之间的关联。 
  | 
              
| GetAdsAccountLink | 
|---|
| 
                   
 获取 Google Ads 账号关联。 
  | 
              
| UpdateAdsAccountLink | 
|---|
| 
                   
 更新 Google Ads 账号与产品目录项的关联。这会使用提供的广告资源项更新 Google Ads 账号关联。 
  | 
              
BookingNotification
接收有关来自外部时间安排合作伙伴的预约通知。合作伙伴应根据合作伙伴是实现基于预订的 RPC(例如 CreateBooking 和 CheckAvailability)还是基于订单的 RPC(例如 CreateOrder 和 CheckOrderFulfillability)来调用 UpdateBooking 或 UpdateOrder。
| UpdateBooking | 
|---|
| 
                   
 更新现有  
  | 
              
| UpdateOrder | 
|---|
| 
                   
 更新现有  
  | 
              
Feed
获取由外部集合商家合作伙伴上传的 Feed 的处理状态。
| GetStatus | 
|---|
| 
                   
 检索指定的集合商家之前所上传 Feed 的  
  | 
              
| ListStatus | 
|---|
| 
                   
 检索指定的集合商家之前上传的多个商家 Feed、服务 Feed 或可用性 Feed 的  
  | 
              
InvalidationService
接收来自外部合作伙伴的资源失效请求。
| InvalidateResource | 
|---|
| 
                   
 使现有资源失效。 如果请求的资源未订阅 Google 服务,系统会忽略该请求。 支持的资源类型:- 自提 
  | 
              
InventoryStatus
检索已上传商家的商品目录和匹配状态。
| GetMerchantStatus | 
|---|
| 
                   
 获取  
  | 
              
| ListMerchantStatuses | 
|---|
| 
                   
 列出符合过滤条件的合作伙伴的所有  
  | 
              
InventoryUpdate
接收来自外部集合商家的商品目录更新。
| BatchDeleteGenericRecords | 
|---|
| 
                   
 删除指定 Feed 类型的记录。仅执行基本验证(例如请求格式错误),然后立即向合作伙伴返回适当的响应。Google 会异步对请求执行业务逻辑验证。此批量调用不保证原子性。 
  | 
              
| BatchPushGenericRecord | 
|---|
| 
                   
 插入和/或更新指定 Feed 类型的记录。仅执行基本验证(例如格式错误的请求),之后会立即将适当的响应返回给合作伙伴。Google 会异步对请求执行业务逻辑验证。此批量调用不保证原子性。 
  | 
              
| BatchReplaceServiceAvailability | 
|---|
| 
                   
 替换现有  
  | 
              
| CreateMerchant | 
|---|
| 
                   
 创建由指定的集合商家管理的新  
  | 
              
| CreateService | 
|---|
| 
                   
 创建由指定的集合商家管理的商家的新  
  | 
              
| DeleteMerchant | 
|---|
| 
                   
 删除由指定的集合商家管理的现有  
  | 
              
| DeleteService | 
|---|
| 
                   
 删除由指定的集合商家管理的商家的现有  
  | 
              
| ReplaceServiceAvailability | 
|---|
| 
                   
 替换由指定的集合商家管理的商家现有  
  | 
              
| UpdateMerchant | 
|---|
| 
                   
 更新由指定的集合商家管理的现有  
  | 
              
| UpdateService | 
|---|
| 
                   
 更新由指定的集合商家管理的商家的现有  
  | 
              
ActionLink
一个操作网址,包含所用语言、支持的国家/地区列表以及可选平台(表示应在哪个平台上执行此操作)。
| 字段 | |
|---|---|
url | 
                
                   
 此操作链接的入口点网址。  | 
              
language | 
                
                   
 BCP-47 语言标记,用于标识此 URI 中的内容所支持的语言。  | 
              
restricted_ | 
                
                   
 ISO 3166-1 alpha-2 国家/地区代码。留空即表示国家/地区范围不限。  | 
              
platform | 
                
                  
                   用于指明应在哪个平台上执行此操作。如果未设置此字段,ACTION_PLATFORM_WEB_APPLICATION 将用作后备平台。  | 
              
action_ | 
                
                  
                   预定的操作类型。  | 
              
order_ | 
                
                  
                   在线订单链接的元数据。支持 ActionLinkType 为 ACTION_LINK_TYPE_SHOP_ONLINE 的操作。  | 
              
food_ | 
                
                  
                   订餐链接的元数据。支持操作类型:*   | 
              
event_ | 
                
                  
                   有关活动行业独有的操作链接的其他信息。  | 
              
ActionLinkType
与操作链接相关的预定操作类型。
| 枚举 | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED | 
                操作链接类型未指定。 | 
ACTION_LINK_TYPE_BOOK_APPOINTMENT | 
                操作链接类型为预约。 | 
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT | 
                操作链接类型为在线预约。 | 
ACTION_LINK_TYPE_ORDER_FOOD | 
                操作链接类型为下送餐订单和/或外带订单。 | 
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY | 
                操作链接类型为下送餐订单。 | 
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT | 
                操作链接类型为下外带订单。 | 
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION | 
                操作链接类型为用餐预订。 | 
ACTION_LINK_TYPE_SHOP_ONLINE | 
                操作链接类型为购物订单,可以是送货或自提,也可以同时是这两种方式。 | 
EventMetadata
有关活动类别特有的操作链接的更多信息。
| 字段 | |
|---|---|
surface | 
                
                  
                   与操作链接相关的预定事件界面。该维度仅用于“事件”类别。  | 
              
Surface
与操作链接关联的预定事件 surface。该维度仅用于“事件”类别。
| 枚举 | |
|---|---|
SURFACE_UNSPECIFIED | 
                未指定 surface。 | 
SURFACE_SEARCH | 
                操作链接是在 Google 搜索中预订活动门票。 | 
SURFACE_YOUTUBE | 
                操作链接是在 YouTube 中预订活动门票。 | 
SURFACE_ADS | 
                操作链接是指点击相应活动的广告。 | 
ActionPlatform
用于指明在哪个平台上执行此操作。Web 应用是通用的后备平台。建议您至少拥有一个包含 ACTION_PLATFORM_WEB_APPLICATION 的 ActionLink。如果链接将 Android 和 iOS 作为平台,该链接仅适用于对应的系统。
| 枚举 | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED | 
                平台未指定。 | 
ACTION_PLATFORM_WEB_APPLICATION | 
                通用操作平台为 Web 应用。 | 
ACTION_PLATFORM_MOBILE_WEB | 
                操作平台为移动设备上的 Web 应用。 | 
ACTION_PLATFORM_ANDROID | 
                操作平台为 Android 操作系统。 | 
ACTION_PLATFORM_IOS | 
                操作平台为 iOS 操作系统。 | 
AdsAccountLink
AdsAccountLink 是 Google Ads 账号与 Partner Center 账号以及广告资源项之间的关联。
| 字段 | |
|---|---|
name | 
                
                   
 标识符。AdsAccountLink 的资源名称。格式:  | 
              
item_ | 
                
                   
 必需。要与 Google Ads 账号相关联的产品目录项 ID 的列表。  | 
              
state | 
                
                  
                   仅限输出。Google Ads 账号关联的状态。  | 
              
州
Google Ads 账号关联的状态。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED | 
                未知状态。 | 
LINKED | 
                账号已在合作伙伴中心和 Google Ads 门户之间建立关联。 | 
PENDING | 
                账号正在等待 Partner Center 或 Google Ads 门户的批准。 | 
DELETED | 
                账号关联已删除。 | 
REJECTED | 
                账号关联请求被合作伙伴中心或 Google Ads 门户拒绝。 | 
建议
通过“通过 Google 预订”功能预订时向用户显示的建议。
| 字段 | |
|---|---|
text | 
                
                  
                   通过“通过 Google 预订”功能预订时向用户显示的自定义消息。  | 
              
可用性
商家服务的可用性空档,用于表示时间和空档数。
| 字段 | |
|---|---|
start_ | 
                
                  
                   预约空档的开始时间。  | 
              
duration | 
                
                  
                   预约空档的持续时间  | 
              
spots_ | 
                
                   
 此可用性的总空档数和可用空档数。示例: 
 注意:如果使用下面指定的可用性压缩格式发送请求,将推断出以下两个字段。 
  | 
              
spots_ | 
                
                   
 可用的空档数。  | 
              
availability_ | 
                
                   
 用于标识可用性空档的可选不透明字符串。如果设置,它将包含在预订/更新/取消预约的请求中。  | 
              
resources | 
                
                  
                   当服务中包含不同的工作人员或房间时,用于消除此可用性空档与其他空档之间的歧义的可选资源。 例如,同一瑜伽课程有 2 位老师:  | 
              
payment_ | 
                
                   
 ID 列表,其中列出了可用于支付此空档费用的付款方式。实际的付款方式需在商家级别定义,且多个商家可共享付款方式。 该字段将替换服务消息中指定的任何 payment_option_ids。同样,此处指定的 payment_option_ids 无需在服务消息中显示,但必须在商家级别定义。  | 
              
recurrence | 
                
                  
                   可用性的重复周期信息,表示多个开始时间。重复周期应包含单个工作日内的可预约项。  | 
              
schedule_ | 
                
                  
                   无法安排此服务的时间。如需限制 schedule_exception 消息的数量,请考虑合并相邻的例外情况。  | 
              
deposit | 
                
                  
                   适用于此可用性的可选押金。如果指定了押金,则会替换在服务级别定义的押金。  | 
              
no_ | 
                
                  
                   适用于此可用性的可选违约金。如果指定了违约金,则会替换在服务级别定义的违约金。  | 
              
prepayment | 
                
                  
                   可选。适用于此可用性的可选预付款信息。  | 
              
require_ | 
                
                  
                   表明用户是否必须提供信用卡信息才能预订此可用性空档。如果未设置该值,将从服务级别(如果已在该级别设置)继承。(可选)  | 
              
ticket_ | 
                
                   
 表示此可用性空档支持的票券类型列表。如果未设置该值,则父级服务中的所有票券类型均适用于此空档。请注意,必须在父级服务中定义此字段的值。示例: 
 如需表示工作日期间的商品目录,请使用: 
 如需表示这三种票券类型均适用于此时间空档,请使用  (可选)  | 
              
duration_ | 
                
                  
                   显示时段时长和/或结束时间的要求。如果播出信息不适用,系统会忽略此字段。不用于推荐活动类别。(可选)  | 
              
scheduling_ | 
                
                  
                   可用性时间安排规则。如果填充了字段,则这些字段将覆盖服务级 SchedulingRules 上任何相应的时间安排规则。  | 
              
confirmation_ | 
                
                  
                   表示预订此可用性时使用哪种确认模式。使用 CONFIRMATION_MODE_SYNCHRONOUS 的确认模式创建可用性的预订时,必须立即确认或拒绝。如果尝试使用 CONFIRMATION_MODE_ASYNCHRONOUS 的确认模式创建可用性的预订,则必须立即拒绝或创建状态为 PENDING 的预订。  | 
              
linkout_ | 
                
                  
                   可选。此槽位需要链出的原因。如果已设置,此广告位的 Merchant 资源必须具有有效的 LinkoutTemplate。(可选)  | 
              
ConfirmationMode
预订可用性时使用的确认模式。
| 枚举 | |
|---|---|
CONFIRMATION_MODE_UNSPECIFIED | 
                未指定确认模式。系统将进行同步确认。 | 
CONFIRMATION_MODE_SYNCHRONOUS | 
                系统将同步确认对此可用性的预订。 | 
CONFIRMATION_MODE_ASYNCHRONOUS | 
                系统将异步确认对此可用性的预订。 | 
DurationRequirement
此枚举指明用户需满足哪些要求才能确认或查看所请求的空档时长/结束时间。
| 枚举 | |
|---|---|
DURATION_REQUIREMENT_UNSPECIFIED | 
                未指定结束时间的处理方法。这是默认值。 | 
DO_NOT_SHOW_DURATION | 
                系统不会向用户显示结束时间。 | 
MUST_SHOW_DURATION | 
                必须先向用户显示结束时间,然后才能进行预约。 | 
LinkoutRequiredReason
广告位提供链接体验的原因。
| 枚举 | |
|---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED | 
                默认值:请勿使用,等同于“未知”。 | 
PAYMENT_REQUIRED | 
                空档需要在合作伙伴平台中付款才能预订。 | 
周期性
重复周期消息是可选的,但允许以更紧凑的方式表示持续重复的可用性空档。它们通常表示一天的工作安排。其中,可使用 ScheduleException 消息来表示工作日内已预订/不可用的时间范围。
要求:
- 可用性空档或重复周期的扩展不得创建相同的空档。如果 ID、start_time、duration 和 resource 相匹配,则将相应空档视为相同的空档。
 - 请勿在单个服务的空档内将标准的可用性格式与重复周期混合使用。重复周期更适合提供预约的商家/服务。标准格式适用于定期安排课程的商家/服务。
 - 重复周期不得超过 24 小时。
 
| 字段 | |
|---|---|
repeat_ | 
                
                  
                   可用性重复截止时间的时间戳,需包含最大时间单位的世界协调时间 (UTC)。  | 
              
repeat_ | 
                
                  
                   定义连续可用性空档之间的时间。 示例:一个可用性的 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 生成空档。(必填)  | 
              
ScheduleException
ScheduleException 消息表示工作日内已预订/不可用的时间范围,它是上述重复周期的例外情况。时间空档被预订后,应更新例外情况列表,以反映新的不可用的时间范围。不应修改重复周期本身。
| 字段 | |
|---|---|
time_ | 
                
                  
                   例外情况的时间范围。由重复周期描述且与此已打烊-营业中时间范围重叠的任何空档都将被视为不可用。 示例:如果重复周期指定时长为 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 点开始的空档不会受到影响。  | 
              
SchedulingRuleOverrides
可用性级别时间安排规则。
| 字段 | |
|---|---|
last_ | 
                
                   
 可预订此空档的最后时间(以秒为单位)。此时间戳必须在空档的 start_sec 之前(如需支持用户在开始时间后进行预订,请使用服务级 SchedulingRules.min_booking_before_end_time)。如果存在,则将覆盖相应服务的 SchedulingRules 的 min_booking_buffer 中任何指定的内容。  | 
              
first_ | 
                
                   
 能够预订此空档的最早时间(以秒为单位)。此时间戳必须在空档的 start_sec 或 last_bookable_sec(如果已指定)之前。  | 
              
last_ | 
                
                   
 如果已设置,则表示可通过“通过 Google 预订”功能取消此特定预约空档的最后时间(以 Unix 纪元为起始值,以秒为单位)。此字段将替换任何服务级取消规则。(可选)  | 
              
BatchDeleteGenericRecordsRequest
用于删除指定 Feed 类型的记录的批量请求。
| 字段 | |
|---|---|
parent | 
                
                   
 资源名称,格式为   | 
              
records[] | 
                
                  
                   要删除的记录。一次 API 调用最多可包含 1,000 条记录。  | 
              
BatchPushGenericRecordRequest
用于插入和/或更新请求网址中指定的 Feed 类型的记录的批量请求。
| 字段 | |
|---|---|
parent | 
                
                   
 资源名称,格式为   | 
              
records[] | 
                
                  
                   要插入和/或更新的记录。一个 API 调用中最多允许 1000 条记录。  | 
              
BatchReplaceServiceAvailabilityRequest
用于替换多个 Service 的可用性空档的批量请求。
| 字段 | |
|---|---|
parent | 
                
                   
 格式为   | 
              
extended_ | 
                
                  
                   扩展的服务可用性,用于替换现有可用性空档。  | 
              
BatchReplaceServiceAvailabilityResponse
用于替换多个 Service 的可用性空档的批量响应。此消息仅包含成功更新的空档
| 字段 | |
|---|---|
extended_ | 
                
                  
                   成功更新的已扩展服务可用性消息,可用于替换现有可用性空档。  | 
              
预订
对商品目录空档的预订
| 字段 | |
|---|---|
name | 
                
                   
 预订的资源名称:  | 
              
merchant_ | 
                
                   
 空档所属商家的 ID  | 
              
service_ | 
                
                   
 商家服务的 ID  | 
              
start_ | 
                
                  
                   预约空档的开始时间  | 
              
duration | 
                
                  
                   预约空档的持续时间  | 
              
client_ | 
                
                  
                   进行预约的客户的个人信息  | 
              
status | 
                
                  
                   预订状态  | 
              
payment_ | 
                
                  
                   与预订相关的付款交易信息。  | 
              
party_ | 
                
                   
 预订的就餐人数  | 
              
BookingFailure
用于说明异步预订处理失败的原因的状态数据。BookingFailure 主要用于捕获业务逻辑错误。
| 字段 | |
|---|---|
cause | 
                
                  
                   预订失败的原因。(必填)  | 
              
rejected_ | 
                
                  
                   (仅当原因为 PAYMENT_ERROR_CARD_TYPE_REJECTED 时才需要)  | 
              
description | 
                
                   
 该可选字段适用于仅出于调试目的添加其他信息的合作伙伴。(可选)  | 
              
payment_ | 
                
                  
                   与付款失败相关的信息。  | 
              
原因
对失败原因的枚举。
| 枚举 | |
|---|---|
CAUSE_UNSPECIFIED | 
                默认值:请勿使用;金额为“未知错误” | 
SLOT_UNAVAILABLE | 
                引用的可用性空档不再可用。 | 
SLOT_ALREADY_BOOKED_BY_USER | 
                用户已预订引用的可用性空档。 | 
LEASE_EXPIRED | 
                租借(如果已提供)已过期,无法再用于完成所请求的预订。 | 
OUTSIDE_CANCELLATION_WINDOW | 
                由于商家取消政策的时间限制,目前无法执行所请求的取消。 | 
PAYMENT_ERROR_CARD_TYPE_REJECTED | 
                处理付款时出现错误,因为商家不接受所提供的信用卡类型。信用卡类型必须在 rejected_card_type 中提供。 | 
PAYMENT_ERROR_CARD_DECLINED | 
                处理付款时出现错误,因为所提供的信用卡被拒。 | 
PAYMENT_OPTION_NOT_VALID | 
                用于支付预订费用的礼包/会员身份出现错误,可能是已失效或已过期等原因所致。 | 
PAYMENT_ERROR | 
                处理此预订的付款时出现错误。仅当错误与上述特定的付款错误不匹配时,才可使用该值来指明与付款相关的一般错误。 | 
USER_CANNOT_USE_PAYMENT_OPTION | 
                用户无法使用已指定的付款方式(例如用户在第二次付款时尝试使用新客户价格)。 | 
BOOKING_ALREADY_CANCELLED | 
                用户尝试取消的预订已被取消。 | 
BOOKING_NOT_CANCELLABLE | 
                用户尝试取消的预订不可取消。 | 
OVERLAPPING_RESERVATION | 
                用户的现有预订与此次预订的时间太过接近。 | 
USER_OVER_BOOKING_LIMIT | 
                由于用户超出了集合商家的每位用户预订限制,因此预订失败。 | 
PAYMENT_REQUIRES_3DS1 | 
                当付款被拒时设置该字段,被拒原因是您在经过 3DS1 挑战/响应之后请求再次尝试交易。请注意,当前交易仍将保持失败状态。重试将会完全单独进行。 当失败原因为此原因时,必须设置 payment_failure.3DS1_parameters。如果不是,则将 PAYMENT_ERROR 视为当前的失败原因。  | 
              
PaymentFailureInformation
与付款失败相关的信息。
| 字段 | |
|---|---|
threeds1_ | 
                
                  
                   供 RwG 集合商家用以启动 3DS1 用户身份验证协议的参数。除非将 BookingFailure.cause 设置为 PAYMENT_REQUIRES_3DS1,否则系统会忽略该字段。  | 
              
ThreeDS1Parameters
请求 RwG 执行 3DS1 挑战的参数。
这些参数由 EMVCo 对 3DS1 协议的说明设置。
| 字段 | |
|---|---|
acs_ | 
                
                   
 可加载供用户进行身份验证的表单的网址。  | 
              
pa_ | 
                
                   
 PaymentAuthentication 请求。将发布到 ACSUrl 表单(如果已提供)。  | 
              
transaction_ | 
                
                   
 ACS 提供商所用的标识符。将发布到 ACSUrl 表单(如果已提供)。  | 
              
md_ | 
                
                   
 商家数据。将发布到 ACSUrl 表单(如果提供)。  | 
              
BookingStatus
预订状态
| 枚举 | |
|---|---|
BOOKING_STATUS_UNSPECIFIED | 
                未指定。 | 
CONFIRMED | 
                预订已确认 | 
PENDING_MERCHANT_CONFIRMATION | 
                预订正在等待商家确认,经商家确认后才能转为“已确认”状态(目前尚不支持) | 
PENDING_CLIENT_CONFIRMATION | 
                预订正在等待客户确认,经客户确认后才能转为“已确认”状态(目前尚不支持) | 
CANCELED | 
                已代表用户取消预订。 | 
NO_SHOW | 
                客户未按时赴约 | 
NO_SHOW_PENALIZED | 
                客户未按时赴约,违反了取消政策。 | 
FAILED | 
                预订操作处理失败,无法完成预订。 | 
DECLINED_BY_MERCHANT | 
                预订被商家异步拒绝。 | 
CallMerchant
此类型没有字段。
要在 UnsupportedPartySizeOption 中使用的空消息,设置此选项后,系统会向用户显示一个用于致电商家进行预订的选项。
CancellationPolicy
服务的取消政策。
| 字段 | |
|---|---|
refund_ | 
                
                  
                   政策中的零或多个退款条件。  | 
              
RefundCondition
指定单个退款条件。您可使用多个退款条件来描述服务开始时间前各个时段的“退款步骤”。
| 字段 | |
|---|---|
min_ | 
                
                  
                   服务开始前的时段,在该时间范围内取消预订的客户可以收到有关   | 
              
refund_ | 
                
                   
 只要在服务开始时间前至少   | 
              
ClientInformation
预订者的个人信息
| 字段 | |
|---|---|
given_ | 
                
                   
 客户的名字  | 
              
family_ | 
                
                   
 客户的姓氏  | 
              
address | 
                
                  
                   客户的地址  | 
              
telephone | 
                
                   
 客户的电话号码  | 
              
email | 
                
                   
 客户的电子邮件地址  | 
              
CreateAdsAccountLinkRequest
AdsAccountLinkingService.CreateAdsAccountLink 的请求消息。
| 字段 | |
|---|---|
parent | 
                
                   
 必需。将在其中创建此 Google Ads 账号关联的父级资源。此 ID 与合作伙伴中心账号 ID 相同。格式:partners/{partner}  | 
              
ads_ | 
                
                   
 必需。用于 Google Ads 账号关联的 ID。此 ID 与 Google Ads 客户 ID 相同。有关详情,请参阅https://support.google.com/google-ads/answer/1704344格式:xxx-xxx-xxxx。  | 
              
ads_ | 
                
                  
                   必需。要创建的 AdsAccountLink。  | 
              
CreateMerchantRequest
创建 Merchant 的请求。
| 字段 | |
|---|---|
parent | 
                
                   
 拥有此商家的合作伙伴的父级资源名称,格式为   | 
              
merchant_ | 
                
                   
 要用于此商家的商家 ID。  | 
              
merchant | 
                
                  
                   要创建的商家。  | 
              
CreateServiceRequest
创建新 Service 的请求。
| 字段 | |
|---|---|
parent | 
                
                   
 拥有此服务的商家的父级资源名称,格式为   | 
              
service_ | 
                
                   
 此服务的服务 ID。  | 
              
service | 
                
                  
                   要创建的服务。  | 
              
CreditCardRestrictions
对此商家所接受的信用卡类型的限制。
| 字段 | |
|---|---|
credit_ | 
                
                  
                   受支持的信用卡列表。留空表示不支持任何信用卡。  | 
              
CreditCardType
信用卡类型。
| 枚举 | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED | 
                未使用。 | 
VISA | 
                Visa 信用卡。 | 
MASTERCARD | 
                Mastercard 信用卡。 | 
AMERICAN_EXPRESS | 
                美国运通信用卡。 | 
DISCOVER | 
                Discover 信用卡。 | 
JCB | 
                JCB 信用卡。 | 
DeleteAdsAccountLinkRequest
AdsAccountLinkingService.DeleteAdsAccountLink 的请求消息。
| 字段 | |
|---|---|
name | 
                
                   
 必需。要删除的 AdsAccountLink 的名称。格式:partners/{partner}/adsAccountLinks/{ads_account_link}  | 
              
DeleteMerchantRequest
用于删除 Merchant 的请求。
| 字段 | |
|---|---|
name | 
                
                   
 要删除的商家的资源名称。格式为:partners/{partner_id}/merchants/{merchant_id}  | 
              
DeleteServiceRequest
用于删除 Service 的请求。
| 字段 | |
|---|---|
name | 
                
                   
 要删除的服务的资源名称。格式为   | 
              
押金
一种保证金,可直接向用户收取,也可冻结用户信用卡中的部分额度。
| 字段 | |
|---|---|
deposit | 
                
                  
                   押金金额。  | 
              
min_ | 
                
                   
 至少需要提前多久取消预订才会退回押金。  | 
              
deposit_ | 
                
                  
                   定义如何根据可用性确定押金。  | 
              
DirectMerchantPayment
有关用户如何直接向商家付款(而非通过 RwG 预付服务费用)的信息。
| 字段 | |
|---|---|
payment_ | 
                
                  
                   建议用户仅通过下述付款方式付款。  | 
              
DurationRange
可有界限或无界限的时长范围的封装容器。至少需要 min_duration 和 max_duration 时长之一。
| 字段 | |
|---|---|
min_ | 
                
                  
                   时长下限。  | 
              
max_ | 
                
                  
                   时长上限。  | 
              
EconomicOperator
集合商家的经济运营商信息。
| 字段 | |
|---|---|
text | 
                
                  
                   必需。经济运营商的名称、地址、电话号码和电子邮件地址,即制造商、授权代表、进口商、分销商、履单服务提供商,或承担与产品的制造、提供或投入服务相关的义务的任何其他自然人或法人。economic_operator 的自由格式字符串表示法。这些信息可以使用“”和“\n”。  | 
              
ExtendedServiceAvailability
可用性列表及其所适用的人员或时间。
| 字段 | |
|---|---|
merchant_ | 
                
                   
 这是必填字段,用于指定以下可用性消息所属的商家。  | 
              
service_ | 
                
                   
 这是必填字段,用于指定以下可用性消息所属的服务。  | 
              
start_ | 
                
                  
                   如果提供,我们会将提供的可用性实体视为 [start_time_restrict, end_time_restrict] 的完整概况。也就是说,如果符合以下条件,系统将会删除所有现有的可用性: 如果设置了 duration 消息,系统会进一步对条件进行限制: 如果设置了 resources_restrict 消息,系统会进一步对条件进行限制: 这些字段通常用于对特定时间范围内的可用性进行完整的更新。 已设置 start_time_restrict 但未设置 end_time_restrict 时,表示所有时间均从 start_time_restrict 开始。  | 
              
end_ | 
                
                  
                   已设置 end_time_restrict 但未设置 start_time_restrict 时,表示所有时间的结束时间均为 end_time_restrict。  | 
              
duration_ | 
                
                  
                   设置持续时间可进一步限制为仅更新与持续时间匹配的可用性。  | 
              
resources_ | 
                
                  
                   设置 resources_restrict 可进一步限制为仅更新此组资源。资源的所有 ID 字段均必须完全匹配。  | 
              
availability[] | 
                
                  
                   新的可用性列表。  | 
              
FeedStatistics
处理已上传的 Feed 时获取的统计信息。
| 字段 | |
|---|---|
new_ | 
                
                   
 此 Feed 新添加的项。内容可以是商家、服务或可用性空档,具体取决于 Feed 的类型。  | 
              
existing_ | 
                
                   
 现有项,根据需要根据 Feed 中的较新信息进行更新。  | 
              
deleted_ | 
                
                   
 此 Feed 中不再显示的项,这些项已被移除。  | 
              
FeedStatus
集合商家的平台所上传 Feed 的状态。
| 字段 | |
|---|---|
name | 
                
                   
 Feed 资源的名称,格式为 
  | 
              
state | 
                
                  
                   此 Feed 的处理状态。  | 
              
error_ | 
                
                   
 如果我们无法处理此 Feed,人类可读的字符串用于提供更多详细信息。  | 
              
statistics | 
                
                  
                   特定于此 Feed 的统计信息。  | 
              
州
用于表示 Feed 处理状态的枚举。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED | 
                默认值。未使用。 | 
IN_PROGRESS | 
                Feed 仍在处理中。 | 
SUCCESS | 
                Feed 已成功处理。 | 
FAILURE | 
                处理 Feed 时遇到错误。 | 
FoodOrderingMetadata
食品订购操作链接的元数据。
| 字段 | |
|---|---|
fee_ | 
                
                  
                   在商品总金额的基础上向用户收取的费用的详细信息。针对不同类型的费用(例如服务费、配送费等)重复。  | 
              
advance_ | 
                
                  
                   有关提前订购支持(也称为提前下单)的详细信息。用户可以下单,以便稍后(而不是立即)完成订单。  | 
              
联合字段 fulfillment_duration_options。从订单确认到履单所用的时间。对于送餐订单,此属性是指距离送餐完毕的时长。对于自取订单,是指食物可以取货所需的时间。fulfillment_duration_options 只能是下列其中一项: | 
              |
fulfillment_ | 
                
                  
                   固定时长。例如:30 分钟。  | 
              
fulfillment_ | 
                
                  
                   时长范围。示例:* 30 分钟至 45 分钟 * 超过 30 分钟 * 少于 50 分钟  | 
              
AdvanceOrderDetails
用于提前下单支持。
| 字段 | |
|---|---|
is_ | 
                
                   
 如果支持提前订单(也称为提前订单),则为 True。(必填)  | 
              
FeeDetails
费用详情。
| 字段 | |
|---|---|
type | 
                
                  
                   费用类型。(必填)  | 
              
fee_ | 
                
                  
                   费用金额,可以采用单位币种、占购物车价值的百分比或两者的组合形式。(必填)  | 
              
FeeAmount
FeeAmount示例:* 固定费用:0 美元(无费用)、1.5 美元 * 固定费用范围:1.0 美元(最低)、3.0 美元(最高)、5.0-6.0 美元 * 购物车大小百分比:15.5%、10%-20%、10%(最低)、15%(最高)* 范围和百分比的组合:25.5% 和 2.5 美元(最低)、25.5% 和 4.5 美元(最高)、10% 和 1.5-2.5 美元、10.5%-20% 和 2.5-3.5 美元
| 字段 | |
|---|---|
cart_ | 
                
                  
                   费用占购物车价值的百分比。支持范围(有界和无界)或固定百分比。值应介于 0 到 100 之间。例如:* 固定 5.5% * 至少为 5.5% * 最大为 5.5% * 4.5% 至 5.5%  | 
              
联合字段 amount_options。用于指定货币金额的选项。amount_options 只能是下列其中一项: | 
              |
amount | 
                
                  
                   固定金额。例如 USD 3.5。  | 
              
amount_ | 
                
                  
                   金额范围。示例:* 3.5 美元到 5.5 美元 * 至少 3.5 美元 * 不超过 5.5 美元  | 
              
amount_ | 
                
                   
 未知金额。  | 
              
FeeType
费用类型。
| 枚举 | |
|---|---|
FEE_TYPE_UNSPECIFIED | 
                费用类型未指定。 | 
DELIVERY | 
                运费。 | 
SERVICE | 
                服务费。 | 
FulfillmentOption
线上订餐操作链接的执行方式选项。
| 字段 | |
|---|---|
fulfillment_ | 
                
                  
                   必需。履单类型。  | 
              
available_ | 
                
                  
                   必需。此履单方式可供使用的日期列表(最好至少 2 天)。  | 
              
fee_ | 
                
                  
                   必需。履单方法的费用详情。  | 
              
minimum_ | 
                
                  
                   必需。与操作链接关联的履单方式的最低订单金额。  | 
              
AvailableDay
天级可用性。
| 字段 | |
|---|---|
fulfillment_ | 
                
                  
                   必需。履单方法的可用日期。假定为商家所在的时区。  | 
              
last_ | 
                
                  
                   必需。Unix 时间戳。用户上次能够通过  例如,如果 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-08-10 收到订单。  | 
              
FeeDetails
与操作链接关联的履单方法的费用详情。
| 字段 | |
|---|---|
联合字段 fee_details。该履单方式的费用模式。fee_details 只能是下列其中一项: | 
              |
no_ | 
                
                  
                   此履单方式不收费。  | 
              
base_ | 
                
                  
                   与履单方式相关联的基本费用。  | 
              
fixed_ | 
                
                  
                   与履单方式相关联的固定费用。  | 
              
FixedFee
与操作链接关联的执行方式所需的固定费用。
| 字段 | |
|---|---|
amount | 
                
                  
                   必需。履单方法的固定费用金额。  | 
              
FulfillmentType
与操作链接关联的执行方式类型。
| 枚举 | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED | 
                执行方式类型未指定。 | 
FULFILLMENT_TYPE_DELIVERY | 
                履单类型为配送。 | 
FULFILLMENT_TYPE_PICKUP | 
                履单类型为自提。 | 
MinimumFee
与操作链接关联的执行方式所需的最低费用。
| 字段 | |
|---|---|
base_ | 
                
                  
                   必需。该履单方式的基本费用金额。  | 
              
NoFee
此类型没有字段。
与操作链接关联的履单方法无需付费。
GenericDeleteRecord
将要删除的记录(网址请求中提到的 Feed 类型)。
| 字段 | |
|---|---|
delete_ | 
                
                  
                   必需。此时间戳用于确定将删除操作应用于广告资源的顺序。  | 
              
联合字段 record_type。封装不同类型的 Feed(ndjson、基于 proto 等)合作伙伴可以提供完整记录,方法与在 Feed 或 BatchPush API 中提供记录类似。合作伙伴还可以选择仅包含记录中用于唯一标识该记录的必需字段。record_type 只能是下列其中一项: | 
              |
data_ | 
                
                   
 适用于非基于 proto 的 Feed。  | 
              
proto_ | 
                
                  
                   适用于基于 Proto 的 Feed。  | 
              
GenericRecord
网址请求中提及的 Feed 类型的记录。
| 字段 | |
|---|---|
generation_ | 
                
                  
                   必需。此时间戳用于确保商品目录更新按正确的顺序排列。  | 
              
联合字段 record_type。封装不同类型的 Feed(ndjson、基于 proto 等)record_type 只能是下列其中一项: | 
              |
data_ | 
                
                   
 适用于非基于 proto 的 Feed。  | 
              
proto_ | 
                
                  
                   适用于基于 Proto 的 Feed。  | 
              
GeoCoordinates
某一地点的地理位置数据,包括纬度、经度和地址。
| 字段 | |
|---|---|
latitude | 
                
                   
 纬度(以度为单位)。(可选)  | 
              
longitude | 
                
                   
 经度(以度为单位)。(可选)  | 
              
联合字段 addresses。某一地点的地址,可以是结构化或非结构化地址。addresses 只能是下列其中一项: | 
              |
address | 
                
                  
                   营业地点的邮政地址(首选)。  | 
              
unstructured_ | 
                
                   
 非结构化地址也可用作备用地址。示例:“北京市长安街 100 号,100005”  | 
              
GetAdsAccountLinkRequest
AdsAccountLinkingService.GetAdsAccountLink 的请求消息。
| 字段 | |
|---|---|
name | 
                
                   
 必需。要检索的 Google Ads 账号关联的名称。格式:  | 
              
GetMerchantStatusRequest
用于获取 MerchantStatus 的请求
| 字段 | |
|---|---|
name | 
                
                   
 必需。资源名称,格式为:partners/{partner_id}/merchants/{merchant_id}/status。  | 
              
GetStatusRequest
用于检索集合商家平台所上传特定 Feed 的 Status 的请求。
| 字段 | |
|---|---|
name | 
                
                   
 Feed 资源的名称,格式为 
  | 
              
HomeServiceData
需要提供针对家政服务行业的其他信息。
| 字段 | |
|---|---|
category_ | 
                
                   
 此家政服务所属的高级类别。例如管道工、电工等  | 
              
job_ | 
                
                   
 给定家政服务所属类别下的职位类型。例如unclog_drain 和 install_faucet 是“管道工”类别下的作业类型。  | 
              
IntegrationType
支持的集成深度。
| 枚举 | |
|---|---|
INTEGRATION_TYPE_UNSPECIFIED | 
                默认为 END_TO_END。 | 
INTEGRATION_TYPE_END_TO_END | 
                允许通过 Google 进行端到端预订的完整集成。 | 
INTEGRATION_TYPE_INVENTORY_ONLY | 
                预订服务器无需支持此服务。只需发送商家、服务和(可选)可用性数据。 | 
InvalidateResourceRequest
请求使资源失效。
| 字段 | |
|---|---|
resource_ | 
                
                   
 要失效的资源的名称。 例如,对于自提资源,名称应采用   | 
              
LineItem
订单中的单个项 - 在单个时间空档内预订的单项服务。
| 字段 | |
|---|---|
service_ | 
                
                   
 商家服务的 ID。  | 
              
start_ | 
                
                   
 预约空档的开始时间,以自 Unix 纪元以来的世界协调时间(以秒为单位)表示。  | 
              
duration_ | 
                
                   
 预约空档的时长(以秒为单位)。  | 
              
tickets[] | 
                
                  
                   按票券类型订购的票券数量。  | 
              
price | 
                
                  
                   此订单项的总价格(不含税)。  | 
              
status | 
                
                  
                   订单项的状态。  | 
              
OrderedTickets
按票券类型订购的票券数量。
| 字段 | |
|---|---|
ticket_ | 
                
                   
 票券类型 ID。  | 
              
count | 
                
                   
 订购的此类票券数。  | 
              
ListMerchantStatusesRequest
用于获取 MerchantStatus 列表的请求
| 字段 | |
|---|---|
parent | 
                
                   
 必需。拥有此商家状态集合的父级。格式:  | 
              
page_ | 
                
                   
 必需。需要返回的最大项数。 请注意,服务器可能会缩减页面大小。  | 
              
page_ | 
                
                   
 可选。从上一个 ListMerchantStatusResponse 返回的 nextPageToken 值(如果有)。  | 
              
booking_ | 
                
                  
                   可选。按预订广告资源状态过滤结果的可选限制条件。  | 
              
waitlist_ | 
                
                  
                   可选。按等候名单商品目录状态过滤结果的可选限制条件。  | 
              
geo_ | 
                
                  
                   可选。按地理位置匹配状态过滤结果的可选限制条件。  | 
              
BookingInventoryStatus
端到端预订广告资源状态。
| 枚举 | |
|---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED | 
                未指定。 | 
NO_VALID_FUTURE_INVENTORY | 
                商家在接下来的 30 天内没有预订商品目录。 | 
HAS_VALID_FUTURE_INVENTORY | 
                商家在未来 30 天内有预订型商品目录。 | 
GeoMatchingStatus
商家地理位置匹配状态。
| 枚举 | |
|---|---|
GEO_MATCHING_STATUS_UNSPECIFIED | 
                未指定。 | 
GEO_UNMATCHED | 
                商家的地理位置不匹配。 | 
GEO_MATCHED | 
                商家已与地理位置相匹配。 | 
WaitlistInventoryStatus
端到端等候名单广告资源状态。
| 枚举 | |
|---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED | 
                未指定。 | 
NO_VALID_WAITLIST_SERVICE | 
                商家没有支持候位功能的服务。 | 
HAS_VALID_WAITLIST_SERVICE | 
                商家提供支持等候名单的服务。 | 
ListMerchantStatusesResponse
对列出 MerchantStatus 的响应。
| 字段 | |
|---|---|
merchant_ | 
                
                  
                   满足过滤条件的商家状态列表。  | 
              
next_ | 
                
                   
 用于检索下一页结果的令牌。如果为空,则列表中无其他结果。  | 
              
ListStatusRequest
用于检索集合商家平台上传的多个 Feed 的 Status 的请求。
| 字段 | |
|---|---|
name | 
                
                   
 Feed 资源的名称,格式为 
  | 
              
page_ | 
                
                   
 需要返回的最大项数。  | 
              
page_ | 
                
                   
 从上一个 List 请求返回的 next_page_token 值(如果有)。  | 
              
state_ | 
                
                  
                   用于按 Feed 状态过滤结果的可选限制。  | 
              
time_ | 
                
                  
                   按上限和下限过滤结果的可选限制条件。如果未设置 start_time,则默认以 UNIX 时间为开始时间。如果未设置 end_time,则默认以当下为结束时间。  | 
              
ListStatusResponse
用于检索集合商家平台上传的多个 Feed 的 Status 的请求。
| 字段 | |
|---|---|
status[] | 
                
                  
                   按时间倒序排列的已上传 Feed 的状态列表。返回的最大项数取决于请求中的 page_size 字段。  | 
              
next_ | 
                
                   
 用于检索下一页结果的令牌。如果为空,则列表中无其他结果。  | 
              
LocalizedString
某一语言区域的字符串示例。
| 字段 | |
|---|---|
locale | 
                
                   
 IETF BCP 47 语言代码,例如 en、mas、zh-Hant、de-CH-1901。请参阅 http://www.w3.org/International/articles/language-tags/。  | 
              
value | 
                
                   
 采用上述语言区域的消息 (UTF-8)。  | 
              
位置
某个地点的地理位置信息。
| 字段 | |
|---|---|
place_ | 
                
                   
 Google Places 数据库中和 Google 地图上某个地点的地点 ID。如需详细了解地点 ID,请访问 https://developers.google.com/places/web-service/place-id。如果提供,Google 会将营业地点与此地点进行匹配。  | 
              
name | 
                
                   
 营业地点的名称、电话、网址和地理位置用于将营业地点与 Google 地图上已有的地点进行匹配。 此字段为选填字段,但在某些情况下可能必填。例如,没有名称的 Service.location 不会与商家实体匹配,即使它们位于同一地址也是如此。(可选)  | 
              
telephone | 
                
                   
 包含国家/地区代码的营业地点公开电话号码,例如 +14567891234。 (可选)  | 
              
url | 
                
                   
 营业地点公共网站的网址。(可选)  | 
              
geo | 
                
                  
                   营业地点的地理位置信息,包括纬度、经度和地址。(可选)  | 
              
location_ | 
                
                  
                   如果已针对服务提供了此营业地点,还必须提供该营业地点的类型。  | 
              
location_ | 
                
                   
 服务中对营业地点的唯一引用。此 ID 可用于在其他服务字段中引用此营业地点。例如在自定义信息录入表单中,可以使用一组营业地点 ID 来指定自提地点选项。如果已设置,此 ID 在同一服务中应具有唯一性。(可选)  | 
              
LocationType
营业地点的类型。
| 枚举 | |
|---|---|
LOCATION_TYPE_UNSPECIFIED | 
                未指定营业地点的类型。 | 
VISITED_LOCATION | 
                提供服务的地点。 | 
START_LOCATION | 
                服务开始时的地点,也作为 MEETING_LOCATION。 | 
END_LOCATION | 
                服务结束时的地点。 | 
商家
集合商家平台上的某个商家的相关信息。
| 字段 | |
|---|---|
name | 
                
                   
 商家资源的名称,格式为   | 
              
merchant_ | 
                
                   
 merchant_name、telephone、url 和 geo 用于将合作伙伴商品目录与 Google 地图上已有的商家进行匹配。此信息不会显示。 商家的名称。  | 
              
telephone | 
                
                   
 商家的公开电话号码(包括国家/地区代码和区号),例如+14567891234。  | 
              
url | 
                
                   
 商家公共网站的网址。  | 
              
geo | 
                
                  
                   商家的地理位置信息,包括纬度、经度和地址。  | 
              
category | 
                
                   
 集合商家平台中商家的类别。  | 
              
num_bookings_30d | 
                
                   
 该字段已弃用。  | 
              
tax_rate_basis_points | 
                
                   
 商家的税率(以 0.01% 为基准点)。例如,如果税率为 7.5%,应将该字段设置为 750。 如果未设置或将该字段设置为 0,对于由此商家提供的任何服务,向用户收取的总费用为 Service.price 所指定的确切价格。该服务价格被视为无需缴纳税费或已包含适用税费。系统不会将税费作为单独的订单项向用户显示。 如果将该字段设置为任何非零值,对于由此商家提供的任何服务,向用户收取的总费用将包含服务价格以及使用此处提供的税率计算得出的税费。最小货币单位的小数部分(例如,1 美分的小数部分)将四舍五入为最接近的偶数。系统会将税费作为单独的订单项向用户显示。 此字段已弃用,请改用 tax_rate。  | 
              
tax_ | 
                
                  
                   商家的税率。如果存在该字段,该字段将替换已弃用的 tax_rate_basis_points 字段。如果消息为空(即 tax_rate { }),系统会将适用的税率重置为零。  | 
              
payment_ | 
                
                  
                   对此商家所接受付款方式的限制。如果未设置此字段,则假定不存在任何限制。  | 
              
payment_ | 
                
                  
                   此商家所支持的付款方式。此商家的服务将能够单独限制其允许的付款方式。  | 
              
payment_processor_config | 
                
                  
                  
                   适用于令牌化付款处理方的配置(如果商家支持)。  | 
              
tokenization_ | 
                
                  
                   适用于令牌化付款处理方的配置(如果商家支持)。  | 
              
terms | 
                
                  
                   特定商家的条款及条件,在用户使用“通过 Google 预订”功能预订服务时显示。此外,这些集合商家合作伙伴的条款及条件会始终向用户显示,且不得在此提供。  | 
              
brand_ | 
                
                   
 不透明的字符串,用于在显示合作伙伴属性时标识面向消费者的品牌。此字段允许拥有多个面向消费者的品牌的合作伙伴在同一 Feed 中提供所有品牌的商家。 品牌由面向消费者的属性(例如名称、徽标、服务条款及隐私权政策)组成。 如果只有一个面向消费者的合作伙伴品牌,则无需设置该字段,且可将其忽略。 如果合作伙伴… 没有多个面向消费者的品牌?--> 请忽略此字段 配置了多个品牌? 请注意,大多数合作伙伴都不需要设置该字段。如果合作伙伴要使用该字段,必须先与我们联系以配置单独的品牌(包括默认品牌)。  | 
              
matching_ | 
                
                  
                   可帮助 Google 将商家与 Google 地图上的地点进行匹配的提示。请注意:大多数合作伙伴都不需要设置该字段,因为 Google 会使用上述信息将商家与 Google 地图上的地点进行匹配。(可选)  | 
              
service_ | 
                
                  
                   用于描述此商家的服务的任何服务属性的定义。(可选)  | 
              
action_ | 
                
                  
                   可选。一个操作网址,包含所用语言、支持的国家/地区列表、类型以及可选平台(表示应在哪个平台上执行此操作),  | 
              
waitlist_ | 
                
                  
                   可选。特定商家针对通过“通过 Google 预订”加入等候名单的用户提供的一般建议。建议中各个文本字段的长度应限制为 100 个字节。  | 
              
economic_ | 
                
                  
                   可选。与此特定商家相关联的经济运营商信息,以便遵从相关法规。(可选)  | 
              
MerchantMatchingHints
可帮助 Google 将商家与 Google 地图上的地点进行匹配的技巧。
| 字段 | |
|---|---|
place_ | 
                
                   
 Google Places 数据库中和 Google 地图上某个地点的地点 ID。如需详细了解地点 ID,请参阅 https://developers.google.com/places/web-service/place-id。  | 
              
MerchantStatus
“通过 Google 预订”平台中商家的状态。
| 字段 | |
|---|---|
name | 
                
                   
 商家状态资源名称,格式为   | 
              
merchant_ | 
                
                   
 合作伙伴提供的商家名称。  | 
              
input_ | 
                
                  
                   合作伙伴提供了商家的地理位置信息。  | 
              
processing_ | 
                
                  
                   商家处理状态。  | 
              
booking_ | 
                
                  
                   与端到端预订集成相关的状态。  | 
              
waitlist_ | 
                
                  
                   与候位名单集成相关的状态。  | 
              
geo_ | 
                
                  
                   此商家的匹配地理位置。如果商家与地理位置不匹配,则为空。  | 
              
local_ | 
                
                  
                   与此商家匹配的本地生活服务。如果不是本地服务商家或与任何提供商都不匹配,则为空。  | 
              
direct_ | 
                
                  
                   网址列表,用于演示当前商家商品目录的内容。请注意,这并不意味着广告资源实际上处于投放状态,网址可能与公开显示的网址不同。  | 
              
BookingStatus
与端到端预订集成相关的状态。
| 字段 | |
|---|---|
has_ | 
                
                   
 如果商家在接下来的 30 天内有商品目录,则为“true”。不保证商家实际会获得展示。  | 
              
DirectUrl
用于显示商家的网址。
| 字段 | |
|---|---|
type | 
                
                  
                   此网址的类型。  | 
              
url | 
                
                   
 可能会显示此商家的网址。  | 
              
UrlType
显示网址的类型。
| 枚举 | |
|---|---|
URL_TYPE_UNSPECIFIED | 
                未指定。 | 
BOOKING | 
                端到端预订网址。 | 
WAITLIST | 
                端到端候位名单网址。 | 
LOCAL_SERVICES | 
                Google 本地生活服务网址。 | 
LocalServicesMatchInfo
Google 本地服务匹配项的信息(仅适用于本地服务商家)。
| 字段 | |
|---|---|
matched_ | 
                
                  
                   匹配到的服务提供商。一个商家可以与多个服务提供商相匹配。  | 
              
MatchedProvider
本地生活服务提供商。
| 字段 | |
|---|---|
customer_ | 
                
                   
 Google 本地生活服务外部客户 ID。  | 
              
categories[] | 
                
                   
 本地生活服务类别(行业)。例如“管道工”和“carpet_cleaning”  | 
              
PlaceInfo
匹配地点的信息。
| 字段 | |
|---|---|
name | 
                
                   
 地点的名称。  | 
              
formatted_ | 
                
                   
 以当地语言显示的格式化地址。  | 
              
place_ | 
                
                   
 此地点的 Google 地点 ID。可用于构建 Google 地图网址或提取地点的更多详细信息。如需查看使用示例,请访问 https://developers.google.com/places/web-service/place-id。  | 
              
ProcessingStatus
商家处理状态。
| 枚举 | |
|---|---|
PROCESSING_STATUS_UNSPECIFIED | 
                状态不明。 | 
IN_PROGRESS | 
                Madden 已收到商家,但仍在处理中。处于此状态的商家不会填充其他状态。 | 
COMPLETED | 
                系统已计算商家的其他状态。 | 
WaitlistStatus
与候位名单集成相关的状态。
| 字段 | |
|---|---|
has_ | 
                
                   
 如果商家提供候位名单服务,则为 True。不保证商家实际会获得展示。  | 
              
MoneyRange
金额范围的封装容器,可以是有界限或无界限的。必须至少提供 min_amount 和 max_amount 中的一项。
| 字段 | |
|---|---|
min_ | 
                
                  
                   最低金额。  | 
              
max_ | 
                
                  
                   金额上限。  | 
              
NoShowFee
已预订的用户未按时赴约时向其收取的费用。
| 字段 | |
|---|---|
fee | 
                
                  
                   用户未按时赴约时向其收取的费用金额。  | 
              
fee_ | 
                
                  
                   定义如何根据可用性确定费用。  | 
              
订单
向商家提交的服务预约订单。
| 字段 | |
|---|---|
name | 
                
                   
 订单的资源名称:  | 
              
client_ | 
                
                  
                   下单客户的个人信息。  | 
              
payment_ | 
                
                  
                   与订单相关的付款交易信息。  | 
              
merchant_ | 
                
                   
 此订单中所有服务所属商家的 ID。  | 
              
item[] | 
                
                  
                   此订单中的订单项。  | 
              
OrderOnlineMetadata
在线订单操作链接的元数据。
| 字段 | |
|---|---|
fulfillment_ | 
                
                  
                   适用于“在线订购”操作链接的可用执行方式选项。  | 
              
PaymentInformation
与预订相关的付款明细
| 字段 | |
|---|---|
prepayment_ | 
                
                  
                   预订的预付款状态。如果 prepayment_status 为 PREPAYMENT_PROVIDED 或 PREPAYMENT_REFUNDED,则 payment_transaction_id 包含相关联的唯一交易 ID。  | 
              
payment_ | 
                
                   
 与预订关联的付款交易的唯一标识符。如果不适用,则为空。  | 
              
PaymentOption
付款方式,可用于支付商家所提供服务的费用。多个商家(例如同一连锁品牌的商家)可共用同一付款方式。
| 字段 | |
|---|---|
payment_ | 
                
                   
 此 ID 用于标识此付款方式。 此 ID 适用于所有集合商家,而且如果多个商家重复使用同一个值,则可允许用户在向这些商家付款时都可以使用相应的付款方式。 当多个商家重复使用某个 ID 时,更新某个商家所接受付款方式的任何值后,其他商家使用相同 ID 所标识的付款方式也会一并更新。因此,最好为所有付款方式使用同一 ID,并始终将其更新为相同的值,避免出现非确定性行为。  | 
              
name | 
                
                   
 付款方式的名称。此信息可向用户显示。  | 
              
description | 
                
                   
 付款方式的说明。此信息可向用户显示。  | 
              
price | 
                
                  
                   付款方式的价格。  | 
              
tax_ | 
                
                  
                   此付款方式的税率。如果存在该字段,该字段将替换商家或服务中显示的 tax_rate 字段。如果消息为空(即 tax_rate { }),系统会将适用的税率重置为零。  | 
              
payment_ | 
                
                  
                   此付款方式的类型。针对临时用户可一次性使用,对套餐可多次使用,对会员而言则无限制。  | 
              
session_ | 
                
                   
 此付款方式可用于多少次会话。仅对多个会话/套餐有效,其值应大于 1。  | 
              
purchase_ | 
                
                  
                   可在此时间范围内购买付款方式。  | 
              
valid_ | 
                
                  
                   可在此时间范围内使用付款方式(例如,2017 年 1 月特惠价格)。如果存在,此字段将替换 valid_duration 和 activate_type。  | 
              
valid_ | 
                
                  
                   付款方式的有效期限(例如 30 天的会员资格有效期)。  | 
              
activation_ | 
                
                  
                   定义如何确定此付款方式的有效开始日期。  | 
              
user_ | 
                
                  
                   有资格购买此付款方式的用户需满足的限制条件。可用于将促销付款方式的限制为部分用户。如果未设置,则所有用户均符合条件。  | 
              
ActivationType
定义如何确定有效期的开始日期。
| 枚举 | |
|---|---|
ACTIVATION_TYPE_UNSPECIFIED | 
                未使用。 | 
ACTIVATION_ON_PURCHASE | 
                自购买时开始生效。 | 
ACTIVATION_ON_FIRST_USE | 
                自首次使用付款方式时开始生效。 | 
PaymentOptionType
付款方式的类型。
| 枚举 | |
|---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED | 
                未使用。 | 
PAYMENT_OPTION_SINGLE_USE | 
                付款方式只能使用一次。 | 
PAYMENT_OPTION_MULTI_USE | 
                当付款方式的会话数大于 0 时,便可以使用相应付款方式。 | 
PAYMENT_OPTION_UNLIMITED | 
                付款方式可在其有效的时间范围内使用(会话数不适用)。 | 
PaymentProcessorConfig
按商家设置的付款处理方配置。
| 字段 | |
|---|---|
processor | 
                
                  
                   定义应用此配置所适用的付款处理方合作伙伴。  | 
              
public_ | 
                
                   
 用于通过付款处理方识别此商家的密钥。 如需了解 Stripe,请访问 https://stripe.com/docs/dashboard#api-keys。如需了解 Braintree,请访问 https://articles.braintreepayments.com/control-panel/important-gateway-credentials  | 
              
version | 
                
                   
 随付款请求一起发送给付款处理方的 API 版本号。  | 
              
处理器
定义特定的付款处理方合作伙伴。
| 枚举 | |
|---|---|
PROCESSOR_UNSPECIFIED | 
                未使用 | 
PROCESSOR_STRIPE | 
                适用于 Stripe 付款方式的配置。 | 
PROCESSOR_BRAINTREE | 
                适用于 Braintree 付款方式的配置。 | 
PaymentRestrictions
对此商家所接受付款方式的限制。
| 字段 | |
|---|---|
credit_ | 
                
                  
                   对此商家所接受的信用卡的限制。如果未设置该字段,我们会默认接受所有信用卡。请注意,CreditCardType 支持的信用卡列表会随着时间的推移而扩展,这意味着将该字段留空可便于之后对配置进行更改。  | 
              
PerOrderFee
须为每笔订单支付的费用(无论票券的数量是多少)。
| 字段 | |
|---|---|
delivery_ | 
                
                  
                   随服务方式变化的费用。  | 
              
processing_ | 
                
                  
                   处理用户付款方式的费用。  | 
              
PerTicketFee
用户购买每张票券时必须支付的费用。
| 字段 | |
|---|---|
service_ | 
                
                  
                   针对服务评估的额外费用。  | 
              
facility_ | 
                
                  
                   进入场馆/设施的费用。  | 
              
taxes | 
                
                  
                   每张票券的税费。  | 
              
PostalAddress
客户或商家的地址。
| 字段 | |
|---|---|
address_ | 
                
                   
 国家/地区,使用 ISO 3166-1 alpha-2 国家/地区代码指定,例如“US”(必填)  | 
              
address_ | 
                
                   
 市行政区(例如“秦淮区”)。(必填)  | 
              
address_ | 
                
                   
 地区(例如“南京市”)。只有在地区通常是地址的一部分的国家/地区才需要填写此字段。(可选)  | 
              
postal_ | 
                
                   
 邮政编码,例如“210006”。(必填)  | 
              
street_ | 
                
                   
 街道地址(例如“中山南路 1 号”)。(必填)  | 
              
预付
用户在预订时可能需要支付的费用。
| 字段 | |
|---|---|
price_ | 
                
                  
                   用于查看价格详情的容器。  | 
              
PrepaymentStatus
预订的预付款状态。
| 枚举 | |
|---|---|
PREPAYMENT_STATUS_UNSPECIFIED | 
                未指定,默认为 PREPAYMENT_NOT_PROVIDED。 | 
PREPAYMENT_PROVIDED | 
                预订费用已提前支付。 | 
PREPAYMENT_NOT_PROVIDED | 
                预订费用未提前支付。 | 
PREPAYMENT_REFUNDED | 
                费用原为 PREPAYMENT_PROVIDED,但已退款。 | 
价格
服务的价格或所需费用。
| 字段 | |
|---|---|
price_ | 
                
                   
 以微观的货币单位表示的价格。最小货币单位的小数部分将四舍五入为最接近的偶数。(例如,2.5 美分四舍五入为 2 美分,3.5 美分四舍五入为 4 美分,0.5 美分四舍五入为 0 美分,2.51 美分四舍五入为 3 美分)。  | 
              
currency_ | 
                
                   
 ISO 4217 中定义的货币价格。  | 
              
pricing_ | 
                
                   
 可选且不透明的字符串,用于标识与扩展价格关联的定价选项。  | 
              
PriceInfo
用于显示价格详情的容器。
| 字段 | |
|---|---|
price_ | 
                
                  
                   定义如何应用价格或价格范围(每人或固定价格)  | 
              
联合字段 price_options。价格选项用于指定确切的价格或范围。price_options 只能是下列其中一项: | 
              |
price | 
                
                  
                   服务的价格或所需费用。  | 
              
price_ | 
                
                  
                   服务或费用的上限和/或下限。  | 
              
PriceInterpretation
说明价格的解析方式和面向用户显示的方式。
| 枚举 | |
|---|---|
PRICE_INTERPRETATION_UNSPECIFIED | 
                未指定价格解析方式,默认为 EXACT_AMOUNT。 | 
EXACT_AMOUNT | 
                应将价格解析为特定值时。 例如:瑜伽课一节 20 元;儿童理发一次 15 元  | 
              
STARTS_AT | 
                服务的价格不固定,但最低价格已知且向消费者显示价格时。价格可能会因消费者的选择而变高。 请注意,使用 PriceInterpretation 的任何服务都必须使用 PrepaymentType NOT_SUPPORTED。 示例:狗狗美容 30 美元,但消费者的其他选择可能会使价格变高  | 
              
NOT_DISPLAYED | 
                服务的价格不固定且不提前向消费者显示价格信息时。 请注意,使用 PriceInterpretation 的任何服务都必须使用 PrepaymentType NOT_SUPPORTED,且价格必须为空。 示例:家政服务的相关咨询  | 
              
PriceRange
金额范围的封装容器将被视为无界限值,除非这两个值均已设置。至少需要指定 min_amount 和 max_amount 中的一个。
| 字段 | |
|---|---|
min_ | 
                
                  
                   最低金额。  | 
              
max_ | 
                
                  
                   最高金额。应始终大于 min_price。  | 
              
PriceType
定义如何根据可用性确定总价。
| 枚举 | |
|---|---|
FIXED_RATE_DEFAULT | 
                价格为固定金额。如果未设置该字段,将使用默认值。 示例:预订餐位的押金为 50 元;瑜伽课的违约金为 20 元  | 
              
PER_PERSON | 
                指定的价格为每人的费用,总费用则是根据“资源”中指定的人数进行计算的,计算方法为 price_micros 乘以 party_size。PER_PERSON 价格必须与可用资源中的人数一同显示。如果未显示,则假设人数为 1。 示例:博物馆门票每张 10 元  | 
              
QuantitativeValue
数值的封装容器,可以是范围或固定值。QuantitativeValue 示例:* 奇异值:value: 10.5  * 有边界范围:value_range {min_value: 5.5, max_value 10.5}  * 下限:value_range {min_value: 5.5}  * 上限:value_range {max_value: 10.5}
| 字段 | |
|---|---|
联合字段 value_options。(必需)value_options 只能是下列其中一项: | 
              |
value | 
                
                   
 一个奇异值。例如:5.6  | 
              
value_ | 
                
                  
                   一组值,可以是开区间或闭区间。例如:* 最少 5.5 * 最多 5.5 * 5.5 至 6.5  | 
              
RangeValue
值范围,其中 min_value < max_value。必须至少填写 min_value 和 max_value 中的一个。
| 字段 | |
|---|---|
min_ | 
                
                   
 最小值。  | 
              
max_ | 
                
                   
 最大值。  | 
              
Rating
定义实体的评分。
| 字段 | |
|---|---|
value | 
                
                   
 平均评分值(number_of_ratings > 0 时为必填项)。该值必须在 [1, 5] 的范围内,并且当且仅当 number_of_ratings 为零时才能省略。  | 
              
number_ | 
                
                   
 计算时所用的评分数(必填)。  | 
              
RelatedMedia
与服务相关的图片。Google 会抓取这些媒体,用于确保面向最终用户正确显示。(可选)
| 字段 | |
|---|---|
url | 
                
                   
 媒体来源的网址。Google 会抓取托管在此网址上的媒体。  | 
              
type | 
                
                  
                   媒体来源的类型。  | 
              
localized_ | 
                
                  
                   对支持国际化的媒体的说明,仅支持纯文本格式。所有 HTML 组件均会被删除。(可选)  | 
              
attribution | 
                
                  
                   有关媒体来源的提供方信息。请注意,如果提供方信息需要与媒体一同显示,以便注明摄影师或代理机构,则必须设置该字段。(可选)  | 
              
caption | 
                
                   
 已弃用,建议使用 localized_caption。  | 
              
提供方
媒体提供方的相关信息。
| 字段 | |
|---|---|
localized_ | 
                
                  
                   用于注明支持国际化的摄影师或代理机构的文本。此文本将与源媒体一同显示。请注意,该字段仅支持纯文本,所有 HTML 组件均会被删除(不支持基于超链接的提供方信息)。  | 
              
text | 
                
                   
 已弃用,建议使用 localized_text。  | 
              
MediaType
用于指明媒体来源类型的枚举。仅支持图片格式。如需使用图片以外的其他媒体,请与“通过 Google 预订”团队联系。
| 枚举 | |
|---|---|
TYPE_UNSPECIFIED | 
                未使用。 | 
PHOTO | 
                表示网址所提供的媒体是图片。 | 
ReplaceServiceAvailabilityRequest
用于替换 Service 的可用性的请求。
| 字段 | |
|---|---|
service_ | 
                
                  
                   用于替换现有服务的可用性。  | 
              
RequireCreditCard
指定是否需要在预约时提供信用卡信息。
| 枚举 | |
|---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED | 
                未明确指定是否需要提供信用卡信息,且行为与为条件字段指定的行为相同。 | 
REQUIRE_CREDIT_CARD_CONDITIONAL | 
                如果满足以下任一条件,Google 将要求在预订时提供信用卡信息:* 库存具有价格,且 prepayment_type 为“必填”* 已设置 no_show_fee * 已设置“押金”字段。 | 
REQUIRE_CREDIT_CARD_ALWAYS | 
                无论其他字段的值为何,预订此库存时均须提供信用卡信息。 | 
资源
当服务中包含不同的工作人员或房间时,此资源可用于消除这些可用性空档之间的歧义。如果同一服务和时间间隔的多个空档的资源不同,这些空档可共存。
| 字段 | |
|---|---|
staff_ | 
                
                   
 提供服务的工作人员的可选 ID。此字段用于标识所有商家、服务和可用性记录中的工作人员。此外,考虑到需与之前的预订相关联,此字段需要随着时间的推移保持一致。如果存在 people_name,则必须提供此字段。  | 
              
staff_ | 
                
                   
 提供服务的工作人员的可选姓名。办理预订的用户将看到此字段,该字段应该是用户可理解的内容,而非不透明的标识符。如果存在 people_id,则必须提供此字段。  | 
              
room_ | 
                
                   
 服务所在房间的可选 ID。此字段用于标识所有商家、服务和可用性记录中的房间。此外,考虑到需与之前的预订相关联,此字段需要随着时间的推移保持一致。如果存在 room_name,则必须显示此字段。  | 
              
room_ | 
                
                   
 服务所在房间的可选名称。办理预订的用户将看到此字段,该字段应该是用户可理解的内容,而非不透明的标识符。(可选,但如果存在 room_id,则必须提供)在餐饮中,房间名称应仅用于酒吧或露台等座位区域,不应用于固定价格菜单、特殊活动或任何其他非客房值(例如预订或晚餐)。强烈建议不要将默认休息区与客房相关联。  | 
              
party_ | 
                
                   
 仅适用于餐饮服务:此时间空档内可容纳的就餐人数。一家餐馆可以同时与多个空档相关联,每个空档可指定不同的 party_size,例如可预订 2 人、3 人或 4 人座。  | 
              
room_ | 
                
                  
                   可选。本地化的聊天室说明。如果设置,则必须提供默认值。最好还提供商家所在语言区域的常用语言。(可选)  | 
              
SchedulingRules
服务的时间表规则。
| 字段 | |
|---|---|
min_ | 
                
                   
 网上取消预订应至少提前通知的时间(以秒为单位)。(可选)  | 
              
late_cancellation_fee | 
                
                  
                  
                   在至少应提前通知的期限内取消时应支付的费用。  | 
              
noshow_fee | 
                
                  
                  
                   未取消预订时应付的违约金。  | 
              
admission_ | 
                
                  
                   适用于此服务的准入政策。如果未设置,默认为 TIME_STRICT。(可选)  | 
              
cancellation_ | 
                
                  
                   时间表规则取消政策。(对于推荐活动,该字段为必填字段)  | 
              
联合字段  如果已设置“min_advance_booking”,则最后可预订时间的计算方式为:(<空档开始时间> - "min_advance_booking")。如果已设置“min_booking_buffer_before_end_time”,则最后可预订时间的计算方式为:(<空档结束时间> - "min_booking_buffer_before_end_time")。请注意,如需设置“min_booking_buffer_before_end_time”时,必须将其设置为正值。如果两者均未设置,则在空档开始时间之前,相应空档可预订。如果这两个字段均已设置,系统只会选择一个值,而忽略另一个值,我们无法可靠地预测系统会选择哪个值。 示例: 
  | 
              |
min_ | 
                
                   
 从上次预订时间到可用性空档开始时间的时长(以秒为单位)。  | 
              
min_ | 
                
                   
 从上次预订时间到可用性空档结束时间的时长(以秒为单位)。如果已设置该字段,必须将“admission_policy”字段设置为“TIME_FLEXIBLE”,表明用户可以在空档开始后使用所购票券。  | 
              
AdmissionPolicy
此服务的准入政策。
| 枚举 | |
|---|---|
ADMISSION_POLICY_UNSPECIFIED | 
                未使用。 | 
TIME_STRICT | 
                客户需要在可用性空档开始时到场,且服务会在此空档结束时结束。TIME_STRICT 使用情形示例:* 某游览项目上午 9:00 开始,所有参加者都需要在开始时间到达,中午 12:00 左右返回。* 预约时间为星期六下午 3:00 的某理发服务大约需要 30 分钟的时间。* 某健身课程的上课时间为晚上 6:00 到晚上 8:00。 | 
TIME_FLEXIBLE | 
                客户可以在可用性空档的开始和结束时间之间的任何时间享受已预约的服务。 TIME_FLEXIBLE 使用情形示例:* 可在购票当天的任何时间使用博物馆门票。* 可在中午 12:00 至晚上 9:00 使用下午时段的游乐园入场券。  | 
              
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | 
                客户需要在可用性空档的开始时间到达商家地点,但可以随时离开。 例如,上午 10:00 的限时门票要求参观者在上午 10:00 点到达博物馆。此服务的可用性空档的开始时间即指定的到场时间。结束时间仅用作确定可用性空档的键。  | 
              
服务
对商家所提供服务的介绍,例如“理发”。
| 字段 | |
|---|---|
name | 
                
                   
 服务资源的名称,格式为   | 
              
service_ | 
                
                   
 服务的名称,例如“男士理发”。已弃用,请改用 localized_service_name。  | 
              
localized_ | 
                
                  
                   服务的名称,例如“男士理发”。可能适用于多个语言区域。  | 
              
description | 
                
                   
 可供用户查看的服务简介。已弃用,请改用 localized_description。  | 
              
localized_ | 
                
                  
                   可供用户查看的服务简介。 此字段同时支持纯文本格式及类似于 HTML 的格式。与纯文本部分不同,自定义布局的创建可使用标题、段落、列表和一些词组标记。请仔细阅读以下说明和注意事项,确保提供最佳的用户体验。 支持的类似于 HTML 的格式标记: 标题标记:<h1>、<h2>、<h3>、<h4>、<h5>、<h6> 段落标记:<p> 列表标记:<ul>、<ol>、<li> 分区标记:<div> 词组标记:<br>、<strong>、<em> 不受支持的标记: 
 重要注意事项: 
  | 
              
price | 
                
                  
                   服务的价格。  | 
              
price_ | 
                
                  
                   说明价格的解析方式和面向用户显示的方式。可用于供餐饮和推荐活动以外的任何行业配置服务价格的显示方式。  | 
              
rules | 
                
                  
                   预约/取消预约的规则。  | 
              
prepayment_ | 
                
                  
                   预付款是必需项、可选项或不支持预付款。  | 
              
prepayment_ | 
                
                  
                   与预付款完成相关的条款。  | 
              
form[] | 
                
                  
                  
                   已弃用。请使用 intake_form 和 per_ticket_intake_form。  | 
              
intake_ | 
                
                  
                   在用户预订此服务时,用于请求用户提供更多信息的表单。(可选)  | 
              
per_ | 
                
                  
                   在用户预订此服务时,用于请求用户提供更多信息的表单。用户预订每张票券时均需填写一次该表单。(可选)  | 
              
tax_ | 
                
                  
                   服务的税率。如果存在,则该字段将替换在商家级别设置的任何 tax_rate。空白消息(即 tax_rate { })会将适用税率重置为零。  | 
              
payment_ | 
                
                   
 ID 列表,其中列出了可用于支付此服务费用的付款方式。实际的付款方式需在商家级别定义,且多个商家可共享付款方式。  | 
              
deposit | 
                
                  
                   指定向用户收取押金的方式。如果指定了押金,则会替换在服务级别定义的押金。如果将该字段留空,系统会移除服务级别的所有押金。(可选)  | 
              
no_ | 
                
                  
                   指定可能需要向用户收取的违约金。如果指定了违约金,则会替换在服务级别定义的违约金。如果将该字段留空,系统会移除服务级别的所有违约金。(可选)  | 
              
require_ | 
                
                  
                   指明用户是否必须提供信用卡信息才能预订相应服务。可在可用性级别替换该字段。(可选)  | 
              
action_ | 
                
                  
                   与服务相关的操作链接。如果存在操作链接,必须在“服务”中设置类型(参见下文)。  | 
              
type | 
                
                  
                   服务的预定义类型。(可选)  | 
              
ticket_ | 
                
                  
                   可预订/购买的服务票券类型(如果支持票券)。(可选)  | 
              
related_ | 
                
                  
                   与服务相关的图片。Google 会抓取并存储媒体,用于确保以最有效的方式向最终用户展示。(可选)  | 
              
service_ | 
                
                  
                   适用于相应服务的服务属性值(可选)。对于在相应商家中定义的每个服务属性,每项服务都可能具有零个或多个值。(可选)  | 
              
waitlist_ | 
                
                  
                   加入等候名单需遵循的规则。  | 
              
ticketing_ | 
                
                  
                   特定于活动门票行业的其他信息。(可选)  | 
              
integration_ | 
                
                  
                   我们所支持的集成深度。(可选)不适用于采用初级集成的合作伙伴。对于此类合作伙伴,“端到端”将始终处于停用状态。  | 
              
per_ | 
                
                  
                   用于购买相应服务的订单级费用。(可选)  | 
              
tours_ | 
                
                  
                   特定于游览项目和活动的“内容”字段。  | 
              
location[] | 
                
                  
                   与服务相关的地点。重要注意事项:如果有多个与服务相关的已访问地点,或者 START_LOCATION 与 VISITED_LOCATION 不同,则必须指定 START_LOCATION。示例:- 对于途径 3 个地点的有向导的骑行之旅,需指定第一个地点。- 对于要在酒店大厅集合,然后前往参观地点的观光巴士之旅,需指定集合地点。  | 
              
rating | 
                
                  
                   此服务的用户评分,是针对所有评价的汇总指标。  | 
              
home_ | 
                
                  
                   家政服务行业专有的额外信息。(可选)  | 
              
virtual_ | 
                
                  
                   可选。虚拟会话的相关信息。这是启用虚拟服务所必需的。  | 
              
direct_ | 
                
                  
                   可选。当服务要求用户直接向商家付款时需要添加的其他信息。重要提示:RwG 不会参与此交易。如果已定义 virtual_session,且服务不是免费的,或者 prepayment_type 未设置为 REQUIRED,则此字段为必填字段。  | 
              
uri_ | 
                
                  
                   可选。一个可选模板,用于指定 Google 应如何生成指向外部网站的网址。  | 
              
PrepaymentTerms
有关何时完成预付款的具体信息。
| 字段 | |
|---|---|
charge_ | 
                
                  
                   相对于购买时间的扣款时间。  | 
              
charge_ | 
                
                   
 服务开始时间前,系统向用户收取费用的时间(以秒为单位)。仅当 ChargeTiming 为 CHARGE_LATER 时,才应设置此字段。  | 
              
ChargeTiming
用于指定相对于购买时间的扣款时间的枚举。
| 枚举 | |
|---|---|
CHARGE_TIMING_UNSPECIFIED | 
                未使用。 | 
CHARGE_NOW | 
                系统会立即向客户收取费用。 | 
CHARGE_LATER | 
                系统会稍后向客户收费。 | 
PrepaymentType
用于表示预付款类型的枚举。
| 枚举 | |
|---|---|
PREPAYMENT_TYPE_UNSPECIFIED | 
                系统默认预付款为 NOT_SUPPORTED。 | 
REQUIRED | 
                用户必须在预订时支付服务费用。 | 
OPTIONAL | 
                用户可以选择在预订时或预订后预付服务的费用,但这并不是进行预订的必要条件。 | 
NOT_SUPPORTED | 
                相应服务不支持预付费。 | 
ServiceType
预定义的服务类型。
| 枚举 | |
|---|---|
SERVICE_TYPE_UNSPECIFIED | 
                未使用。 | 
SERVICE_TYPE_DINING_RESERVATION | 
                用餐预订。 | 
SERVICE_TYPE_FOOD_ORDERING | 
                订餐方式可以是送餐和/或外卖。 | 
SERVICE_TYPE_FOOD_DELIVERY | 
                外卖。 | 
SERVICE_TYPE_FOOD_TAKEOUT | 
                外卖食品。 | 
SERVICE_TYPE_EVENT_TICKET | 
                活动门票。 | 
SERVICE_TYPE_TRIP_TOUR | 
                旅游。 | 
SERVICE_TYPE_APPOINTMENT | 
                提供预约或课程的服务。建议用于:(1) 保健和健身行业;(2) 水疗和美容行业;以及 (3) 金融咨询和评估服务。如需查看支持的服务类型,请访问:https://developers.google.com/maps-booking/guides/end-to-end-integration/overview | 
SERVICE_TYPE_ONLINE_APPOINTMENT | 
                提供完全虚拟课程或课程的线上预约服务。如果启用虚拟服务预订,则必须设置此字段。 | 
SERVICE_TYPE_SHOPPING | 
                允许用户从指定商家购物的服务。可以是送货,也可以是自提。 | 
ServiceAttribute
服务属性是由合作伙伴定义的类别,用于介绍商家所提供的服务。例如,银行可能会为“账号类型”服务属性定义“个人”和“企业”,而美发店可能会将“服务类型”服务属性的值定义为“理发”、“染色”和“造型”。
| 字段 | |
|---|---|
attribute_ | 
                
                   
 用于唯一标识同一商家的此服务属性与其他服务属性的标识符,例如“account-type”。  | 
              
attribute_ | 
                
                   
 此属性的用户可见名称,例如“账号类型”。  | 
              
value[] | 
                
                  
                   此服务属性的所有可能值。  | 
              
值
表示特定服务属性的可能值。
| 字段 | |
|---|---|
value_ | 
                
                   
 用于在此服务属性中唯一标识该值的标识符(例如“personal”)。  | 
              
value_ | 
                
                   
 值的用户可见名称(例如“个人”)。  | 
              
ServiceAttributeValueId
标识要应用于服务的服务属性的特定值。
| 字段 | |
|---|---|
attribute_ | 
                
                   
 Merchant.service_attribute 中定义的属性的 ID,例如“service-type”  | 
              
value_ | 
                
                   
 此属性值的 ID,例如“理发”。必须与服务属性定义中的 value_id 相匹配。  | 
              
ServiceAvailability
可用性列表及其所适用的人员或时间。
| 字段 | |
|---|---|
name | 
                
                   
 要将此参数应用到的服务资源的名称。格式为   | 
              
start_ | 
                
                  
                   如果提供,我们会将提供的可用性实体视为 [start_time_restrict, end_time_restrict] 的完整概况。也就是说,如果符合以下条件,系统将会删除所有现有的可用性: 如果设置了 duration 消息,系统会进一步对条件进行限制: 如果设置了 resources_restrict 消息,系统会进一步对条件进行限制: 这些字段通常用于对特定时间范围内的可用性进行完整的更新。 已设置 start_time_restrict 但未设置 end_time_restrict 时,表示所有时间均从 start_time_restrict 开始。  | 
              
end_ | 
                
                  
                   已设置 end_time_restrict 但未设置 start_time_restrict 时,表示所有时间的结束时间均为 end_time_restrict。  | 
              
duration_ | 
                
                  
                   设置持续时间可进一步限制为仅更新与持续时间匹配的可用性。  | 
              
resources_ | 
                
                  
                   设置 resources_restrict 可进一步限制为仅更新此组资源。资源的所有 ID 字段均必须完全匹配。  | 
              
availability[] | 
                
                  
                   新的可用性列表。  | 
              
ServiceIntakeForm
指定可对商家所提供服务进行自定义的信息录入表单。
| 字段 | |
|---|---|
field[] | 
                
                  
                   将向用户显示的字段。  | 
              
first_time_customers | 
                
                   
 如果值为 true,系统将向新客户显示此表单。已弃用。信息录入表单不支持此功能。  | 
              
returning_customers | 
                
                   
 如果值为 true,系统将向回头客显示此表单。已弃用。信息录入表单不支持此功能。  | 
              
ServiceIntakeFormField
指定 ServiceIntakeForm 中包含的字段。
| 字段 | |
|---|---|
id | 
                
                   
 集合商家合作伙伴提供的字符串,用于唯一标识表单字段。此 ID 应与相应表单字段回答中的 ID 相同,且必须在服务级别和单张票券信息录入表单中具有唯一性。(必填)  | 
              
type | 
                
                  
                   此字段的类型。  | 
              
label | 
                
                   
 该字段中向用户显示的文本。已弃用,请改用   | 
              
localized_ | 
                
                  
                   该字段中向用户显示的文本。可面向多个语言区域提供。(必填)  | 
              
value[] | 
                
                   
 当且仅当字段类型为 LOCATION_SEARCH 时设置。请使用“location”字段中的“location_id”指定地理位置的值。  | 
              
choice_ | 
                
                  
                   仅当字段类型为 MULTIPLE_CHOICE、CHECKBOXES 或 DROPDOWN 时才设置。用于枚举可能的选项。  | 
              
is_ | 
                
                   
 指明用户是否需要填写对该字段的回答。  | 
              
allow_ | 
                
                   
 指明是否允许在预定义的答案之外使用自定义值。仅当字段类型为 LOCATION_SEARCH 时,此字段才适用。(可选)  | 
              
additional_ | 
                
                  
                   除了提供的值之外,还提供的其他选项。仅在字段类型为 LOCATION_SEARCH 时适用。例如除了提供的地点列表外,您还可以使用“稍后联系供应商”这一可用选项。(可选)  | 
              
ticket_ | 
                
                   
 如果仅应在用户预订某些类型的票券时显示此问题,则应将此字段设置为一组适用的票券类型 ID。如果问题始终适用,请将此字段留空。  | 
              
hint | 
                
                  
                   输入提示文本,显示为文本占位符。只有在字段类型为 SHORT_ANSWER 或 PARAGRAPH 时,此属性才适用。(可选)  | 
              
FieldType
用于表明字段类型的枚举。
| 枚举 | |
|---|---|
FIELD_TYPE_UNSPECIFIED | 
                未指定或类型未知的字段将被忽略。 | 
SHORT_ANSWER | 
                用于输入文本的单行输入字段。 | 
PARAGRAPH | 
                用于输入文本的多行输入字段。 | 
MULTIPLE_CHOICE | 
                供用户从多个选项中选择一项的一组单选按钮。 | 
CHECKBOXES | 
                一个或多个带有复选框的枚举项。 | 
DROPDOWN | 
                下拉菜单中的一个选项。 | 
BOOLEAN | 
                “是/否”按钮。 | 
LOCATION_SEARCH | 
                一个搜索框,支持从提供的地点列表中查找与用户的输入匹配的地点。 | 
TaxRate
在向用户收取服务费用时适用的税率,可以按商家或服务设置。
| 字段 | |
|---|---|
micro_ | 
                
                   
 一种税率,以百万分之一计,精确到小数点后 6 位。例如,如果税率为 7.253%,则应将该字段应设置为 7253000。 如果未设置或将该字段设置为 0,对于由此商家提供的任何服务,向用户收取的总费用为 Service.price 所指定的确切价格。该服务价格被视为无需缴纳税费或已包含适用税费。系统不会将税费作为单独的订单项向用户显示。 如果将该字段设置为任何非零值,对于由此商家提供的任何服务,向用户收取的总费用将包含服务价格以及使用此处提供的税率计算得出的税费。最小货币单位的小数部分(例如,1 美分的小数部分)将四舍五入为最接近的偶数。系统会将税费作为单独的订单项向用户显示。  | 
              
条款
用户在使用“通过 Google 预订”进行预订时需遵守的一组规则和准则。
| 字段 | |
|---|---|
url | 
                
                   
 (可选)指向条款及条件的网址。  | 
              
text | 
                
                   
 将向用户显示的文字。请使用下面的 localized_text 进行新的集成。  | 
              
localized_ | 
                
                  
                   要向用户显示的本地化文本。  | 
              
文本
可能已本地化的文本有效负载。某些文本字段可能包含标记的内容。
| 字段 | |
|---|---|
value | 
                
                   
 语言区域未知的文本值。当且仅当   | 
              
localized_ | 
                
                  
                   每个语言的文本值。可选。  | 
              
TicketType
TicketType 用于区分因用户类型、服务属性或选项/附加服务不同而具有不同价格和/或可用性的票券。
票券是服务最小的可预订单元(例如,漂流之旅中的某个地点、博物馆门票、双人皮划艇全天租借服务)。
| 字段 | |
|---|---|
ticket_ | 
                
                   
 票券 ID 用于区分同一服务的不同票券类型,且仅在同一服务中具有唯一性。  | 
              
short_ | 
                
                   
 对 TicketType 的简要说明。 此内容可面向用户显示,例如“成人”、“儿童”、“退伍军人”和“Row J”等。该字段是必填字段,每种票券类型都应附有面向用户的说明。已弃用,请改用 localized_short_description。  | 
              
localized_ | 
                
                  
                   对支持国际化的 TicketType 的简要说明。 此内容可面向用户显示,例如“成人”、“儿童”、“退伍军人”和“Row J”等。该字段是必填字段,每种票券类型都应附有面向用户的说明。可分别针对不同语言区域提供不同的值。  | 
              
price | 
                
                  
                   单张此类票券的价格,不含任何税费。服务税率适用于此类票券。  | 
              
per_ | 
                
                  
                   购买此票券需支付的额外费用。(可选)  | 
              
price_ | 
                
                  
                   可选。此类单张票券的预设价格显示类型。  | 
              
option_ | 
                
                   
 对此票券类型所代表的任何其他选项的说明(如有)。已弃用,请改用 localized_option_description。  | 
              
localized_ | 
                
                  
                   对此票券类型所代表的任何其他选项的说明(如有)。可分别针对不同语言区域提供不同的值。 当票券类型表示多个维度时,其他选项非常有用。 示例 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 格式标记: 和   | 
              
inventory_ | 
                
                  
                   可选。针对单张票券的预定广告资源类型。  | 
              
InventoryType
针对单张票券的预定广告资源类型。
| 枚举 | |
|---|---|
INVENTORY_TYPE_UNSPECIFIED | 
                未指定广告资源类型。 | 
INVENTORY_TYPE_PRIMARY | 
                主要商品目录。 | 
INVENTORY_TYPE_VERIFIED_RESALE | 
                经过验证的转售商品目录。 | 
INVENTORY_TYPE_RESALE | 
                转销广告资源。 | 
INVENTORY_TYPE_AGGREGATOR | 
                汇总信息网站广告资源。 | 
PriceDisplayType
用于表示着陆页上显示的价格格式。
对于非链接型广告资源,此字段会被忽略。
借助此字段,Google 途径可以显示与着陆页所用的价格格式相同的价格。一致的价格格式可提高转化率并减少混淆。
| 枚举 | |
|---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED | 
                价格显示类型未指定。Google 将决定展示哪种格式。 | 
PRICE_DISPLAY_TYPE_BASE | 
                着陆页上显示的价格是基本价格。 | 
PRICE_DISPLAY_TYPE_ALL_IN | 
                着陆页上显示的价格包含所有费用和税费。 | 
TicketingVerticalSpecificData
特定于活动门票行业的其他信息。
| 字段 | |
|---|---|
event_ | 
                
                  
                   活动所属的类别。仅在活动属于某个预定义的类别时设置该字段。(可选)  | 
              
event_ | 
                
                   
 合作伙伴网站上的活动网址。(可选)  | 
              
entity[] | 
                
                  
                   与活动相关的实体列表。(可选)  | 
              
event_ | 
                
                  
                   必需。活动出席情况的类型。  | 
              
event_ | 
                
                   
 可选。可观看活动的网址。  | 
              
event_ | 
                
                  
                   可选。活动的组织者。  | 
              
event_ | 
                
                   
 可选。举办活动的组织者的网址。  | 
              
event_ | 
                
                  
                   可选。组织者的类型。  | 
              
event_ | 
                
                   
 必需。可找到活动信息或说明的网页的网址。  | 
              
event_ | 
                
                  
                   可选。事件的状态。  | 
              
brand_ | 
                
                  
                   可选。本地化的品牌名称。  | 
              
event_ | 
                
                  
                   可选。活动创建者的相关信息。  | 
              
AttendanceMode
活动参加类型。
| 枚举 | |
|---|---|
ATTENDANCE_MODE_UNSPECIFIED | 
                未指定。 | 
ONLINE | 
                用于线上活动。 | 
PHYSICAL | 
                适用于线下活动。 | 
PHYSICAL_ONLINE_MIXED | 
                适用于线上和线下活动。 | 
实体
表示与活动相关的实体。
| 字段 | |
|---|---|
id | 
                
                   
 合作伙伴数据库中实体的唯一标识符。(可选)  | 
              
name | 
                
                   
 实体的名称。(必填)  | 
              
url | 
                
                   
 对实体进行明确描述的网页的网址。这是相应实体在合作伙伴网站上的网页(如有);对于实体的其他公共网址,请使用 public_identification_data 中的 relevant_url。(可选)  | 
              
entity_ | 
                
                  
                   实体的类型。(可选)  | 
              
entity_ | 
                
                  
                   实体在活动中的角色。(可选)  | 
              
public_ | 
                
                  
                   实体的公共引用。(可选)  | 
              
EntityRole
实体在活动中的角色。
| 枚举 | |
|---|---|
ENTITY_ROLE_UNSPECIFIED | 
                未指定。 | 
ENTITY_ROLE_HEADLINER | 
                该实体表示参加活动的主角或主要表演者。 | 
ENTITY_ROLE_SUPPORTER | 
                该实体表示参加活动的配角。 | 
ENTITY_ROLE_HOME_TEAM | 
                该实体表示参加(体育)活动的主场队。 | 
ENTITY_ROLE_AWAY_TEAM | 
                该实体表示参加(体育)活动的客场队。 | 
EntityType
实体的类型。注意:不会作为通用本体。
| 枚举 | |
|---|---|
ENTITY_TYPE_UNSPECIFIED | 
                未指定。请勿使用。 | 
ENTITY_TYPE_PERFORMER | 
                该实体表示在演唱会或演出中进行表演的艺术家或团体。仅在活动类别为“演唱会”或“戏剧”时适用。 | 
ENTITY_TYPE_PLAYER | 
                该实体表示参加比赛的团队或运动员。仅在活动类别为“体育赛事”时适用。 | 
ENTITY_TYPE_CONCERT_TOUR | 
                该实体表示活动所属的游览项目。仅在活动类别为“演唱会”时适用。 | 
ENTITY_TYPE_SPORTS_SERIES | 
                该实体表示活动所属的体育赛事。仅在活动类别为“体育赛事”时适用。 | 
ENTITY_TYPE_PLAY | 
                该实体表示在活动的表演类型(例如音乐剧、喜剧、芭蕾舞等)。仅在活动类别为“戏剧”时适用。 | 
EventCategory
为其自定义产品体验的活动类别的子集。注意:不会作为活动的通用本体。
| 枚举 | |
|---|---|
EVENT_CATEGORY_UNSPECIFIED | 
                未指定。请勿使用。 | 
EVENT_CATEGORY_CONCERT | 
                演唱会。 | 
EVENT_CATEGORY_SPORTS | 
                体育赛事。 | 
EVENT_CATEGORY_THEATRE | 
                戏剧表演。 | 
EVENT_CATEGORY_EXHIBITS | 
                展览。 | 
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | 
                讲习班和课程。 | 
EventCreator
活动创建者的相关信息。仅适用于包含用户生成的内容事件的平台。
| 字段 | |
|---|---|
name | 
                
                   
 可选。活动创建者的姓名。无字符限制。  | 
              
EventState
事件的状态。
| 枚举 | |
|---|---|
EVENT_STATE_UNSPECIFIED | 
                未指定。 | 
SCHEDULED | 
                活动已排定时间。 | 
RESCHEDULED | 
                活动已重新安排。 | 
CANCELLED | 
                活动已取消。 | 
POSTPONED | 
                活动已延期。 | 
OrganizerType
组织者的类型。
| 枚举 | |
|---|---|
ORGANIZER_TYPE_UNSPECIFIED | 
                未指定。 | 
PERSON | 
                对于个人组织者。 | 
ORGANIZATION | 
                对于组织类型的组织者。 | 
PublicIdentificationData
引用实体的标识符、网页或任何其他公共来源。
| 字段 | |
|---|---|
relevant_ | 
                
                   
 内容主要涉及相应主题的任何网页的公共网址。包括官方网站、Discogs、社交媒体平台、维基百科或 IMDb 页面,例如 https://www.discogs.com/artist/1124645-Taylor-Swift、https://www.wikidata.org/wiki/Q19320959、https://twitter.com/acmilan。(可选)  | 
              
musicbrainz_ | 
                
                   
 艺术家或其他音乐实体的 36 个字符的 MusicBrainz 标识符(如适用)。如需了解详情,请访问 https://musicbrainz.org/doc/MusicBrainz_Identifier。(可选)  | 
              
TimeRange
开始营业到结束营业的时间范围,即 [start_time, end_time]。
| 字段 | |
|---|---|
start_ | 
                
                  
                   时间范围的下限。  | 
              
end_ | 
                
                  
                   时间范围的上限。  | 
              
TokenizationConfig
按商家设置的适用于付款处理方令牌化的配置。
| 字段 | |
|---|---|
tokenization_ | 
                
                   
 令牌化配置通常会有一个 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" }  | 
              
billing_ | 
                
                  
                   在付款令牌中添加用户在 Google Pay 中输入的结算信息(请参阅上文)。将该字段留空等同于指定 MIN。  | 
              
BillingInformationFormat
在账单邮寄地址信息中要求用户支付的金额,将其包含在令牌中。枚举值应对应于 Google Pay API 中的参数(请参阅 https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)。
| 枚举 | |
|---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED | 
                未指定。默认值为 MIN。 | 
MIN | 
                姓名、国家/地区代码以及邮政编码(Google Pay 的默认设置)。 | 
FULL | 
                姓名、街道地址、市行政区、区域、国家/地区代码和邮政编码。 | 
ToursAndActivitiesContent
特定于游览项目和活动的“内容”字段。重复字段中的各个元素应相互独立,以便单独呈现(例如以要点的形式显示)。
强烈建议为游览项目和活动填充 ToursAndActivitiesContent,但并非硬性要求。所有字段均支持将纯文本和类似于 HTML 的文本作为基本格式。支持的类似于 HTML 的格式标记:
词组标记:
, , , :仅支持上述三种标记。
 用于对段落中的内容进行分行,// 则用于突出显示重要文本。所有其他词组标记都会被忽略。
不允许使用任何其他标记和自定义样式,且相应标记和样式会被移除。任何网址、锚标记和链接都会被删除,且任何时候都不会向最终用户显示。
重要注意事项:* 请勿重复提供服务说明中 highlights、exclusion 及其他更具体的字段中已提供的数据。* 请勿使用上述受支持的标记以外的其他标记,因为不受支持的标记中的内容会被删除,用户体验也可能会受到影响。
| 字段 | |
|---|---|
highlights[] | 
                
                  
                   面向用户显示的突出显示内容列表。  | 
              
inclusions[] | 
                
                  
                   向用户显示的包含项列表。  | 
              
exclusions[] | 
                
                  
                   面向用户显示的排除内容列表。  | 
              
must_ | 
                
                  
                   向用户显示的重要备注列表,用于详细说明年龄限制或不适合使用此服务的其他情况。  | 
              
UnsupportedPartySizeOption
适用于不在范围内的对方的选项。
| 字段 | |
|---|---|
联合字段 kind。针对超出范围的各方选项。kind 只能是下列其中一项: | 
              |
call_ | 
                
                  
                   如果人数超出上限,可以给商家打电话。系统会向用户显示预定义的消息。要显示的示例文本:“对于人数超过 {waitlist_rules.max_party_size} 的聚会,请致电 {phone} 与餐厅联系。”必须设置 CallMerchant,但它将为空。  | 
              
UpdateAdsAccountLinkRequest
AdsAccountLinkingService.UpdateAdsAccountLink 的请求消息。
| 字段 | |
|---|---|
ads_ | 
                
                  
                   必需。要更新的 Google Ads 账号关联。 AdsAccountLink 的   | 
              
update_ | 
                
                  
                   可选。要更新的字段列表。  | 
              
UpdateBookingRequest
| 字段 | |
|---|---|
update_ | 
                
                  
                   要更新的所有预订字段的字段掩码  | 
              
booking | 
                
                  
                   要更新的预订  | 
              
booking_ | 
                
                  
                   如果异步确认的预订请求处理失败,且预订的状态被更新为“FAILED”,则该字段应反映业务逻辑错误(例如,用户的现有预订与此次预订的时间太过接近)。只有在将预订状态更新为“FAILED”时才应设置此字段,否则系统会忽略此字段。  | 
              
UpdateMerchantRequest
用于更新 Merchant 的请求。
| 字段 | |
|---|---|
merchant | 
                
                  
                   新的商家数据。  | 
              
update_ | 
                
                  
                   要为商家更新的特定字段。  | 
              
UpdateOrderRequest
| 字段 | |
|---|---|
update_ | 
                
                  
                   要更新的所有订单字段的字段掩码  | 
              
order | 
                
                  
                   要更新的订单  | 
              
UpdateServiceRequest
用于更新 Service 的请求。
| 字段 | |
|---|---|
service | 
                
                  
                   新服务数据。  | 
              
update_ | 
                
                  
                   要为服务更新的特定字段。  | 
              
UriTemplate
指定 Google 应如何生成指向外部网站的网址的模板。
| 字段 | |
|---|---|
uri_ | 
                
                   
 可选。URI 模板必须遵循 RFC6570,请参阅 https://datatracker.ietf.org/doc/html/rfc6570。支持级别 2 模板。这些参数将解析为其各自实体中指定的值。 5 available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from start_sec field in availability feed 2) (required) {availability_slot_duration_seconds} :: populated from duration_sec field in availability feed 3) (optional) {resources_party_size} :: populated from party_size field in availability feed 4) (optional) {availability_availability_tag} :: populated from availability_tag field in availability feed 5) (optional) {resources_room_id} :: populated from room_id field in availability feed 用法示例:http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2  | 
              
UserPurchaseRestriction
限制有资格使用付款方式的用户。
| 字段 | |
|---|---|
new_ | 
                
                   
 只有以前从未从同一商家购买过商品的用户才可以购买的付款方式。  | 
              
new_ | 
                
                   
 只能由以前未购买过同一付款方式的用户购买的付款方式。  | 
              
VirtualSession
有关线上/在线会话的信息。例如线上瑜伽课程、线上烹饪课等
| 字段 | |
|---|---|
session_ | 
                
                  
                   有关如何设置此虚拟课程的说明。如果合作伙伴未在预订时附上视频网址,则此文字必须说明何时会与用户分享视频网址。例如 “Zoom 网址将在课前 30 分钟发送给您”。(推荐)  | 
              
session_ | 
                
                  
                   给定虚拟会话的要求。例如瑜伽垫、烹饪用具等(推荐)  | 
              
virtual_ | 
                
                  
                   此会话中所用虚拟平台的相关信息。(必须启用虚拟服务)  | 
              
is_ | 
                
                   
 必需。如果虚拟会议未进行直播,并且是预先录制的,请将此项设为 true。  | 
              
VirtualPlatformInfo
有关将用于此虚拟会议的平台的信息。
| 字段 | |
|---|---|
platform | 
                
                  
                   用于虚拟会话的平台。  | 
              
other_ | 
                
                  
                   如果平台设为“其他”,平台的名称。(如果平台设置为“其他”,则必须提供此值)  | 
              
平台
用于指明商家将使用哪个虚拟平台的枚举。
| 枚举 | |
|---|---|
PLATFORM_UNSPECIFIED | 
                未使用。 | 
FLEXIBLE | 
                商家可以灵活地选择使用的视频平台。 | 
GOOGLE_HANGOUTS | 
                Google Hangouts 产品。 | 
GOOGLE_MEET | 
                Google Meet 产品。 | 
ZOOM | 
                Zoom Video Communications。 | 
SKYPE | 
                Skype。 | 
YOUTUBE | 
                在 YouTube 上直播。 | 
OTHER | 
                如果使用的视频平台不同于此处提及的平台,则应进行设置。 | 
WaitlistRules
加入候位名单需遵守的规则。
| 字段 | |
|---|---|
min_ | 
                
                   
 必填。对于提供候位名单功能的服务,必须提供正整数。如果服务或商家不提供候位名单功能,则不得填充此字段。  | 
              
max_ | 
                
                   
 必需。对于提供候位名单功能的服务,必须提供正整数。如果服务或商家不提供候位名单功能,则不得填充该字段。  | 
              
supports_ | 
                
                   
 如果为 true,用户将可以在加入服务的候位名单时发送任何形式的其他文本请求。  | 
              
above_ | 
                
                  
                   为大于所设 max_party_size 的各方设置选项。如果不应为大型派对提供加入等候名单的其他选项,请将其留空。  |