您可以使用此类型来声明活动中一位或多位宾客的预订。您也可以声明门票。
使用场景
以下使用场景展示了 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
类型名称:EventReservation
扩展自 Reservation
| 名称 | 类型 | 说明 |
|---|---|---|
| action | Action | 可对此事物执行的操作。 |
| action.name | Text | 在与操作关联的界面元素上向用户显示的字符串。 |
| action.url | 网址 | 操作的目标网址。如果没有提供明确的处理程序字段,操作处理程序将展开为 WebActionHandler,并将此网址作为 WebActionHandler 网址。 |
| additionalTicketText | Text | 有关门票的其他信息。 |
| bookingAgent | Organization 或 Person | 预订代理或机构。也接受字符串(例如“”“”)。 |
| bookingAgent.image | 网址 | Organization 图片的网址。 |
| bookingAgent.name | Text | 代理/服务的名称。 |
| bookingAgent.url | 网址 | 代理/服务的网站。 |
| bookingTime | DateTime | 预订日期。 |
| cancelReservationUrl | 网址 | 可取消预订的网页。 |
| confirmReservationUrl | 网址 | 可确认预订的网页。 |
| modifiedTime | DateTime | (建议用于确认卡片/搜索答案)上次修改预订的时间。 |
| modifyReservationUrl | 网址 | (建议用于确认卡片/搜索答案)可修改预订的网页。 |
| numSeats | Number | 座位数。 |
| price | Text | EventReservation 的总价格。 |
| priceCurrency | Text | EventReservation 价格的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
| programMembership | ProgramMembership | 应用于预订的任何会员资格,例如常旅客计划、酒店忠诚度计划等。 |
| programMembership.memberNumber | Text | 会员资格的标识符。 |
| programMembership.program | Text | 计划的名称。 |
| reservationFor (必需) |
Event | 可以使用 Event 或任何活动子类型,包括 BusinessEvent、ChildrenEvent、ComedyEvent、DanceEvent、EducationEvent、Festival、FoodEvent、LiteraryEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、TheaterEvent、VisualArtsEvent。 |
| reservationFor.description | Text | Event 的简短说明。 |
| reservationFor.doorTime | DateTime | 开始入场的时间。 |
| reservationFor.endDate | DateTime | 活动的结束日期和时间。 |
| reservationFor.image | 网址 | Event 图片的网址。 |
| reservationFor.location (必需) |
Place | 活动的地点。 |
| reservationFor.location.address (必需) |
PostalAddress | 活动地点的地址。 |
| reservationFor.location.address.addressCountry (必需) |
Text 或 Country | 活动地点的国家/地区。 |
| reservationFor.location.address.addressLocality (必需) |
Text | 活动地点的所在地(例如城市)。 |
| reservationFor.location.address.addressRegion (必需) |
Text | 活动地点的区域(例如州)。 |
| reservationFor.location.address.postalCode (必需) |
Text | 活动地点的邮政编码。 |
| reservationFor.location.address.streetAddress (必需) |
Text | 活动地点的街道地址。 |
| reservationFor.location.name (必需) |
Text | 活动地点的名称。 |
| reservationFor.name (必需) |
Text | 活动的名称。 |
| reservationFor.performer | Person 或 Organization | (建议用于确认卡片/搜索答案)活动的表演者。也接受对象数组。 |
| reservationFor.performer.image | 网址 | (建议用于确认卡片/搜索答案)Person 图片的网址。 |
| reservationFor.performer.name | Text | (建议用于确认卡片/搜索答案)Person 的名称。 |
| reservationFor.performer.url | 网址 | Person 的网址。 |
| reservationFor.startDate (必需) |
DateTime | 活动的开始日期和时间。 |
| reservationFor.url | 网址 | Event 的网址。 |
| reservationNumber (必需) |
Text | 预订的编号或 ID。 |
| reservationStatus (必需) |
ReservationStatus | 预订的当前状态。 |
| ticketDownloadUrl | 网址 | 可下载门票的位置。 |
| ticketNumber | Text | 门票的编号或 ID。 |
| ticketPrintUrl | 网址 | 可打印门票的位置。 |
| ticketToken | 文本或网址 | 如果条形码图片托管在您的网站上,则该字段的值为图片的网址,或条形码或二维码 URI,例如“barcode128:AB34”(ISO-15417 条形码)、“qrCode:AB34”(二维码)、“aztecCode:AB34”(Aztec 代码)、“barcodeEAN:1234”(EAN 代码)和“barcodeUPCA:1234”(UPCA 代码)。 |
| underName (必需) |
Person 或 Organization | 持票人。 |
| underName.email | Text | 电子邮件地址。 |
| underName.name (必需) |
Text | Person 的名称。 |
| url | 网址 | 可查看预订的网页。 |
| venueRow | Text | 座位的排号。 |
| venueSeat | Text | 座位号。 |
| venueSection | Text | 座位的区域。 |