使用此类型声明某个活动的一位或多位邀请对象的预订。同时也可声明门票。
使用场景
以下用例展示了 EventReservation
架构的常见用法示例。使用这些示例确保您的标记结构正确。
没有门票的基本活动提醒
如果您要发送电子邮件来确认用户参加活动,请添加以下标记。这是一个尽可能少的标记,满足该条件即可使您的电子邮件符合 EventReservation
这一条件的示例。
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationFor": {
"@type": "Event",
"name": "Foo Fighters Concert",
"startDate": "2027-03-06T19:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
}
}
</script>
微数据
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content="Foo Fighters Concert"/>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
</div>
活动门票,不提供预订座位
添加 ticketToken
、ticketNumber
和 numSeats
字段以添加门票的相关信息。
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationFor": {
"@type": "Event",
"name": "Foo Fighters Concert",
"performer": {
"@type": "Organization",
"name": "The Foo Fighters",
"image": "http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"
},
"startDate": "2027-03-06T19:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
},
"ticketToken": "qrCode:AB34",
"ticketNumber": "abc123",
"numSeats": "1"
}
</script>
微数据
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content="Foo Fighters Concert"/>
<div itemprop="performer" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="The Foo Fighters"/>
<link itemprop="image" href="http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"/>
</div>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
<meta itemprop="ticketToken" content="qrCode:AB34"/>
<meta itemprop="ticketNumber" content="abc123"/>
<meta itemprop="numSeats" content="1"/>
</div>
体育赛事或音乐活动门票
将 reservationFor
类型设置为 MusicEvent
或 SportsEvent
。如果活动是 MusicEvent
(例如音乐会),您应添加 performer.name
和 performer.image
。如果活动是 SportsEvent
(例如篮球比赛),会有两支相互竞争的球队或球员将这两支球队作为表演者。
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationFor": {
"@type": "MusicEvent",
"name": "Foo Fighters Concert",
"url": "http://foofighterstour.com/SFO",
"performer": {
"@type": "Organization",
"name": "The Foo Fighters",
"image": "http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"
},
"startDate": "2027-03-06T19:30:00-08:00",
"endDate": "2027-03-06T23:00:00-08:00",
"doorTime": "2027-03-06T16:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "AT&T Park",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
},
"ticketToken": "qrCode:AB34",
"ticketNumber": "abc123",
"numSeats": "1"
}
</script>
微数据
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/MusicEvent">
<meta itemprop="name" content="Foo Fighters Concert"/>
<link itemprop="url" href="http://foofighterstour.com/SFO"/>
<div itemprop="performer" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="The Foo Fighters"/>
<link itemprop="image" href="http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"/>
</div>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<meta itemprop="endDate" content="2027-03-06T23:00:00-08:00"/>
<meta itemprop="doorTime" content="2027-03-06T16:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="AT&T Park"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
<meta itemprop="ticketToken" content="qrCode:AB34"/>
<meta itemprop="ticketNumber" content="abc123"/>
<meta itemprop="numSeats" content="1"/>
</div>
含门票和预订座位的活动
对于含预订座位的单张票,请包含ticketToken
、ticketNumber
、venueSeat
、venueRow
和venueSection
。您只需添加 venueSeat
、venueRow
和 venueSection
中的任一个,即可描述座位的位置。
请勿添加 numSeats
。
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationFor": {
"@type": "Event",
"name": "Foo Fighters Concert",
"performer": {
"@type": "Organization",
"name": "The Foo Fighters",
"image": "http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"
},
"startDate": "2027-03-06T19:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
},
"venueSeat": "12",
"venueRow": "A",
"venueSection": "101",
"ticketToken": "qrCode:AB34",
"ticketNumber": "abc123"
}
</script>
微数据
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content="Foo Fighters Concert"/>
<div itemprop="performer" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="The Foo Fighters"/>
<link itemprop="image" href="http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"/>
</div>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
<meta itemprop="venueSeat" content="12"/>
<meta itemprop="venueRow" content="A"/>
<meta itemprop="venueSection" content="101"/>
<meta itemprop="ticketToken" content="qrCode:AB34"/>
<meta itemprop="ticketNumber" content="abc123"/>
</div>
多张门票
您可以通过以下两种方式处理多张门票:
第一项更改是
numSeats
。这意味着,单个预订将代表numSeats
个人的门票。如果您想为每张票使用一张票券(即条形码),并分别为票券上的每个人命名,请创建多个
EventReservations
(每张票一个),并将numSeats
设置为 1。下面的示例展示了这一过程。
JSON-LD
<script type="application/ld+json">
[
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationFor": {
"@type": "Event",
"name": "Foo Fighters Concert",
"performer": {
"@type": "Person",
"name": "The Foo Fighters",
"image": "http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"
},
"startDate": "2027-03-06T19:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
},
"venueSeat": "12",
"venueRow": "A",
"venueSection": "101",
"ticketToken": "qrCode:AB34",
"ticketNumber": "abc123"
},
{
"@context": "http://schema.org",
"@type": "EventReservation",
"reservationNumber": "E123456789",
"reservationStatus": "http://schema.org/Confirmed",
"underName": {
"@type": "Person",
"name": "Eva Green"
},
"reservationFor": {
"@type": "Event",
"name": "Foo Fighters Concert",
"performer": {
"@type": "Organization",
"name": "The Foo Fighters",
"image": "http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"
},
"startDate": "2027-03-06T19:30:00-08:00",
"location": {
"@type": "Place",
"name": "AT&T Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94107",
"addressCountry": "US"
}
}
},
"venueSeat": "13",
"venueRow": "A",
"venueSection": "101",
"ticketToken": "qrCode:AB34",
"ticketNumber": "abc456"
}
]
</script>
微数据
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content="Foo Fighters Concert"/>
<div itemprop="performer" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="The Foo Fighters"/>
<link itemprop="image" href="http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"/>
</div>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
<meta itemprop="venueSeat" content="12"/>
<meta itemprop="venueRow" content="A"/>
<meta itemprop="venueSection" content="101"/>
<meta itemprop="ticketToken" content="qrCode:AB34"/>
<meta itemprop="ticketNumber" content="abc123"/>
</div>
<div itemscope itemtype="http://schema.org/EventReservation">
<meta itemprop="reservationNumber" content="E123456789"/>
<link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="Eva Green"/>
</div>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content="Foo Fighters Concert"/>
<div itemprop="performer" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="The Foo Fighters"/>
<link itemprop="image" href="http://www.amprocktv.com/wp-content/uploads/2027/01/foo-fighters-1-680x383.jpg"/>
</div>
<meta itemprop="startDate" content="2027-03-06T19:30:00-08:00"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<meta itemprop="name" content="AT&T Park"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="postalCode" content="94107"/>
<meta itemprop="addressCountry" content="US"/>
</div>
</div>
</div>
<meta itemprop="venueSeat" content="13"/>
<meta itemprop="venueRow" content="A"/>
<meta itemprop="venueSection" content="101"/>
<meta itemprop="ticketToken" content="qrCode:AB34"/>
<meta itemprop="ticketNumber" content="abc456"/>
</div>
测试您的标记
您可以使用电子邮件标记测试工具验证标记。粘贴您的标记代码,然后点击验证按钮扫描内容并接收报告,指出出现的所有错误。
规范
请查看电子邮件详情,了解是否有任何活动适用于您的活动预订。通过标记这些附加属性,您可以让 Google 向用户显示更丰富的活动预订说明。
事件预定
类型名称:EventReservation
扩展预留
名称 | 类型 | 说明 |
---|---|---|
操作 | 操作 | 可对此执行的操作。 |
操作name | 文本 | 在与操作关联的界面元素上向用户显示的字符串。 |
action.url | 网址 | 操作的目标网址。如果未提供明确的处理程序字段,则操作处理程序将扩展为 WebActionHandler,此网址将作为 WebActionHandler 网址。 |
additionalTicketText 提供的字段 | 文本 | 门票的其他相关信息。 |
bookingAgent | 组织或个人 | 预订代理或代理机构。也接受字符串(例如“”)。 |
bookingAgent.image | 网址 | 组织映像的网址。 |
bookingAgent.name | 文本 | 代理/服务的名称。 |
bookingAgent.url | 网址 | 代理/服务的网站。 |
bookingTime | DateTime | 预订的日期。 |
cancelReservationUrl | 网址 | 可以取消预订的网页。 |
confirmReservationUrl | 网址 | 可在其中确认预订的网页。 |
修改时间 | DateTime | (建议用于确认卡/搜索答案)上次修改预订的时间。 |
modifyReservationUrl | 网址 | (建议用于确认卡/搜索答案)可修改预订的网页。 |
numSeats | 编号 | 席位数。 |
price | 文本 | EventReservation 的总价格。 |
priceCurrency | 文本 | EventReservation 价格的货币(采用由 3 个字母表示的 ISO 4217 格式)。 |
programMembership(计划成员资格) | 加入计划 | 适用于预订的常客奖励计划、酒店会员回馈活动等的任何会员资格。 |
programMembership.memberNumber | 文本 | 成员资格的标识符。 |
programMembership.program | 文本 | 课程的名称。 |
reservedFor (必需) |
活动 | 可以使用 Event 或任何事件子类型,包括 BusinessEvent、ChildrenEvent、喜剧 Event、DanceEvent、EducationEvent、Festival、FoodEvent、LitearyEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、TheaterEvent、VisualArtsEvent。 |
bookingFor。description | 文本 | 对活动的简短说明。 |
bookingFor.doorTime | DateTime | 入场时间开始。 |
预订.结束日期 | DateTime | 活动的结束日期和时间。 |
for_image | 网址 | 活动图片的网址。 |
bookingFor.location (必需) |
Place | 活动的地点。 |
bookingFor.location.address (必需) |
PostalAddress | 活动地点的地址。 |
bookingFor.location.address.addressCountry (必需) |
文字或国家/地区 | 活动地点所在的国家/地区。 |
bookingFor.location.address.addressLocality (必需) |
文本 | 活动地点的市行政区(例如城市)。 |
bookingFor.location.address.addressRegion (必需) |
文本 | 活动所在位置的区域(例如州/省)。 |
bookingFor.location.address.postalCode (必需) |
文本 | 活动地点的邮政编码。 |
bookingFor.location.address.streetAddress (必需) |
文本 | 活动地点的街道地址。 |
bookingFor.location.name (必需) |
文本 | 活动地点的名称。 |
bookingFor。name (必需) |
文本 | 事件的名称。 |
预订型.表演者 | 人员或组织 | (推荐用于确认卡/搜索答案)活动的执行者。也接受对象数组。 |
booking.performer.image | 网址 | (推荐用于确认卡/搜索答案)人物的图片网址。 |
bookingFor.performer.name | 文本 | (推荐用于确认卡/搜索答案)联系人的姓名。 |
bookingFor.performer.url | 网址 | 人物的网址。 |
bookingFor.startDate (必需) |
DateTime | 活动的开始日期和开始时间。 |
预订.网址 | 网址 | 事件的网址。 |
reservedNumber( )(必需) |
文本 | 预留的编号或 ID。 |
reservedStatus (必需) |
ReservationStatus | 预留的当前状态。 |
工单下载网址 | 网址 | 门票的下载位置。 |
ticketNumber | 文本 | 门票的编号或 ID。 |
printPrintUrl | 网址 | 可以打印门票的位置。 |
工单令牌 | 文字或网址 | 如果条形码图片托管在您的网站上,则相应字段的值是图片的网址,或者条形码或二维码 URI,例如“barcode128:AB34”(ISO-15417 条形码)、“qrCode:AB34”(QR 码)、“aztecCode:AB34”(Aztec 码)和“barcodeEAN(123)” |
underName (必需) |
人员或组织 | 持票人。 |
UnderName.电子邮件地址 | 文本 | 电子邮件地址。 |
underName.name (必需) |
文本 | 人员的姓名。 |
网址 | 网址 | 可查看预订的网页。 |
venueRow | 文本 | 座位所在的行。 |
venueSeat | 文本 | 座位号。 |
venueSection | 文本 | 座位区。 |