您可以利用這個類型為活動中的一或多位邀請對象進行預訂。你也可以宣告購票。
用途
以下應用實例說明瞭 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
擴充保留項目
名稱 | 類型 | 說明 |
---|---|---|
操作 | 動態 | 可對這個項目執行的動作。 |
action.<名稱> | Text | 與動作相關的 UI 元素上向使用者顯示的字串。 |
action.url | 網址 | 動作的目標網址。如未提供明確的處理常式欄位,系統會將動作處理常式展開為 WebActionHandler,並將這個網址當做 WebActionHandler 網址。 |
additionalTicketText | Text | 該票卡的其他資訊。 |
bookingAgent | 組織或人員 | 預訂代理商或代理商。同時也接受字串 (例如 "")。 |
BookingAgent.image | 網址 | 機構圖片的網址。 |
BookingAgent.name | Text | 服務專員/服務的名稱。 |
BookingAgent.url | 網址 | 服務專員/服務的網站。 |
bookingTime | DateTime | 進行預訂的日期。 |
cancelReservationUrl | 網址 | 可取消預訂的網頁。 |
ConfirmReservationUrl | 網址 | 可確認預訂的網頁。 |
修改時間 | DateTime | (建議用於確認卡片/搜尋答案) 上次修改預訂的時間。 |
修改訂房網址 | 網址 | (適用於確認資訊卡/搜尋解答) 可以修改預訂的網頁。 |
numSeats | Number | 座位數。 |
price | Text | EventReservation 的總價。 |
價格幣別 | Text | EventReservation 價格的貨幣 (採 3 個英文字母組成的 ISO 4217 格式)。 |
program 會員 | 計畫成員資格 | 預訂大量機票、飯店會員方案等會員資格。 |
programMembership.memberNumber | Text | 成員資格的識別碼。 |
計畫成員資格.program | Text | 學程計畫名稱。 |
reservationFor (必填) |
事件 | 可使用 Event 或任何事件子類型,包括 BusinessEvent、ChildrenEvent、喜劇片 Event、 DanceEvent、EducationEvent、節慶、FoodEvent、literEventEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、 TheaterEvent、VisualArtsEvent。 |
reservationFor.description | Text | 請簡短說明活動內容。 |
reservationFor.doorTime | DateTime | 入場時間將展開。 |
reservationFor.endDate | DateTime | 活動的結束日期和時間。 |
reservationFor.image | 網址 | 活動圖片的網址。 |
reservationFor.location (必填) |
地點 | 活動的位置。 |
reservationFor.location.<位址> (必填) |
郵寄地址 | 活動地點的地址。 |
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.performanceer | Person 或 Organization | (建議用於確認資訊卡/搜尋答案) 活動的表演者。也接受物件陣列。 |
reservationFor.performanceer.image 圖片 | 網址 | (適用於確認資訊卡/搜尋答案) 人員圖片的網址。 |
reservationFor.performanceer.<名稱> | Text | (建議用於確認的資訊卡/搜尋答案) 人士的姓名。 |
reservationFor.performanceer.url | 網址 | 使用者的網址。 |
reservationFor.startDate (必填) |
DateTime | 活動的開始日期和時間。 |
reservationFor.<網址> | 網址 | 事件的網址。 |
reservationNumber (必填) |
Text | 保留項目的數字或 ID。 |
reservationStatus (必填) |
Reservation Status | 保留項目目前的狀態。 |
TicketDownloadUrl | 網址 | 可下載票券的地方。 |
票卡號碼 | Text | 票券的編號或 ID。 |
TicketPrintUrl | 網址 | 可印票的地方。 |
Ticket 票 | 文字或網址 | 如果條碼是由您的網站代管,欄位值就是圖片的網址,或是條碼或 QR URI,例如「barcode128:AB34」(ISO-15417 條碼)、「qrCode:AB34」(QrCode)、「QR 碼」、「azcode」(E3) 與「BIC:1:3」代碼 |
underName (必填) |
Person 或 Organization | 票券持有人。 |
underName.email | Text | 電子郵件地址。 |
UnderName.name (必填) |
Text | 人名。 |
網址 | 網址 | 可檢視預訂項目的網頁。 |
Text | 座位的排數。 | |
活動場地: | Text | 座位號碼。 |
Text | 座位部分。 |