使用這個型別,為活動中的一或多位賓客聲明預訂。也可以聲明票券。
用途
以下使用案例是 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.name | Text | 在與動作相關聯的 UI 元素上向使用者顯示的字串。 |
| action.url | 網址 | 動作的目標網址。如果未提供明確的處理常式欄位,動作處理常式會擴展為 WebActionHandler,並將這個網址做為 WebActionHandler 網址。 |
| additionalTicketText | Text | 票券的其他資訊。 |
| bookingAgent | Organization 或 Person | 預訂代理人或代理商。也可以接受字串 (例如「」)。 |
| bookingAgent.image | 網址 | 機構圖片的網址。 |
| 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 | 成員 ID。 |
| programMembership.program | Text | 學程計畫名稱。 |
| reservationFor (必要) |
活動 | 可以使用 Event 或任何活動子類型,包括 BusinessEvent、ChildrenEvent、ComedyEvent、DanceEvent、EducationEvent、Festival、FoodEvent、LiteraryEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、TheaterEvent、VisualArtsEvent。 |
| reservationFor.description | Text | 活動的簡短說明。 |
| reservationFor.doorTime | DateTime | 開始入場的時間。 |
| reservationFor.endDate | DateTime | 活動的結束日期和時間。 |
| reservationFor.image | 網址 | 活動圖片的網址。 |
| reservationFor.location (必要) |
地點 | 活動地點。 |
| 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 (Required) |
Text | 活動地點的街道地址。 |
| reservationFor.location.name (必填) |
Text | 活動地點的名稱。 |
| reservationFor.name (必填) |
Text | 活動名稱。 |
| reservationFor.performer | Person 或 Organization | (建議用於確認資訊卡/搜尋答案) 活動的表演者。也接受物件陣列。 |
| reservationFor.performer.image | 網址 | (建議用於確認資訊卡/搜尋答案) 該人物的圖片網址。 |
| reservationFor.performer.name | Text | (建議用於確認資訊卡/搜尋答案) 聯絡人姓名。 |
| reservationFor.performer.url | 網址 | 人員的網址。 |
| reservationFor.startDate (必要) |
DateTime | 活動的開始日期和時間。 |
| reservationFor.url | 網址 | 活動網址。 |
| reservationNumber (必要) |
Text | 預約號碼或 ID。 |
| reservationStatus (必要) |
ReservationStatus | 預訂的目前狀態。 |
| ticketDownloadUrl | 網址 | 可下載票券的位置。 |
| ticketNumber | Text | 票券的編號或 ID。 |
| ticketPrintUrl | 網址 | 可列印票券的地點。 |
| ticketToken | 文字或網址 | 如果條碼圖片代管於您的網站,則欄位值為圖片的網址,或是條碼或 QR URI,例如「barcode128:AB34」(ISO-15417 條碼)、「qrCode:AB34」(QR code)、「aztecCode:AB34」(Aztec code)、「barcodeEAN:1234」(EAN code) 和「barcodeUPCA:1234」(UPCA code)。 |
| underName (必要) |
Person 或 Organization | 票券持有人。 |
| underName.email | Text | 電子郵件地址。 |
| underName.name (Required) |
Text | 人員姓名。 |
| url | 網址 | 可查看預約資訊的網頁。 |
| venueRow | Text | 座位的排數。 |
| venueSeat | Text | 座位號碼。 |
| venueSection | Text | 座位區。 |