このタイプは、イベントで 1 人以上のゲストの予約を宣言する場合に使用します。チケットも申告できます。
ユースケース
次のユースケースは、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>
microdata
<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>
microdata
<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
を含める必要があります。2 つのチームまたは選手が競い合う SportsEvent
(バスケットボールの試合など)の場合は、2 つのチームを出演者として含めます。
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>
microdata
<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>
microdata
<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>
複数のチケット
複数のチケットを処理する方法は 2 つあります。
1 つ目は変更
numSeats
です。つまり、1 件の予約はnumSeats
人のチケットを表します。個人ごとに 1 つのチケット(バーコード)を作成し、チケットに個人の名前を表示する場合は、
numSeats
を 1 に設定して複数のEventReservations
(個人ごとに 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>
microdata
<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>
マークアップをテスト
メール マークアップ テスター ツールを使用して、マークアップを検証できます。マークアップ コードを貼り付け、[検証] ボタンをクリックしてコンテンツをスキャンし、エラーがある場合はレポートを受け取ります。
仕様
メールの詳細を確認し、これらのプロパティがイベントの予約に適用されるかどうかを確認します。これらの追加プロパティをマークアップすることで、イベントの予約に関するより詳細な説明をユーザーに表示できます。
EventReservation
型名: EventReservation
予約を延長します。
名前 | 型 | 説明 |
---|---|---|
操作 | アクション | このアイテムに対して実行できるアクション。 |
action.name | テキスト | アクションに関連付けられた UI 要素にユーザーに表示される文字列。 |
action.url | URL | アクションのターゲット URL。明示的なハンドラ フィールドが指定されていない場合、アクション ハンドラは WebActionHandler に拡張され、この URL が WebActionHandler の URL になります。 |
additionalTicketText | テキスト | チケットに関する追加情報。 |
bookingAgent | Organization または Person | 予約エージェントまたは代理店。文字列("" など)も使用できます。 |
bookingAgent.image | URL | 組織の画像の URL。 |
bookingAgent.name | テキスト | エージェント/サービスの名前。 |
bookingAgent.url | URL | エージェント/サービスのウェブサイト。 |
bookingTime | DateTime | 予約が行われた日付。 |
cancelReservationUrl | URL | 予約をキャンセルできるウェブページ。 |
confirmReservationUrl | URL | 予約を確認できるウェブページ。 |
modifiedTime | DateTime | (確認カード/検索結果の回答に推奨)予約が最後に変更された日時。 |
modifyReservationUrl | URL | (確認カード/検索結果の回答に推奨)予約を変更できるウェブページ。 |
numSeats | 数値 | 座席数。 |
price | テキスト | EventReservation の合計金額。 |
priceCurrency | テキスト | EventReservation の価格の通貨(3 文字の ISO 4217 形式)。 |
programMembership | ProgramMembership | 予約に適用されるマイレージ プログラムやホテル ポイント プログラムなどの会員資格。 |
programMembership.memberNumber | テキスト | メンバーシップの ID。 |
programMembership.program | テキスト | プログラムの名前。 |
reservationFor (必須) |
イベント | Event またはイベントのサブタイプ(BusinessEvent、ChildrenEvent、ComedyEvent、DanceEvent、EducationEvent、Festival、FoodEvent、LiteraryEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、TheaterEvent、VisualArtsEvent など)を使用できます。 |
reservationFor.description | テキスト | イベントの簡単な説明。 |
reservationFor.doorTime | DateTime | 入場開始時間。 |
reservationFor.endDate | DateTime | イベントの終了日と終了時刻。 |
reservationFor.image | URL | イベントの画像の URL。 |
reservationFor.location (必須) |
Place | イベントの場所。 |
reservationFor.location.address (必須) |
PostalAddress | イベントの場所の住所。 |
reservationFor.location.address.addressCountry (必須) |
Text または Country | イベントの場所の国。 |
reservationFor.location.address.addressLocality (必須) |
テキスト | イベントの場所の地域(都市など)。 |
reservationFor.location.address.addressRegion (必須) |
テキスト | イベントの場所の地域(州など)。 |
reservationFor.location.address.postalCode (必須) |
テキスト | イベントの場所の郵便番号。 |
reservationFor.location.address.streetAddress (必須) |
テキスト | イベントの場所の番地。 |
reservationFor.location.name (必須) |
テキスト | イベントの場所の名前。 |
reservationFor.name (必須) |
テキスト | イベントの名前。 |
reservationFor.performer | Person または Organization | (確認カード/検索回答に推奨)イベントの出演者。オブジェクトの配列も使用できます。 |
reservationFor.performer.image | URL | (確認カード/検索結果の回答に推奨)人物の画像の URL。 |
reservationFor.performer.name | テキスト | (確認カード/検索結果の回答に推奨)お客様の名前。 |
reservationFor.performer.url | URL | ユーザーの URL。 |
reservationFor.startDate (必須) |
DateTime | イベントの開始日時。 |
reservationFor.url | URL | イベントの URL。 |
reservationNumber (必須) |
テキスト | 予約番号または ID。 |
reservationStatus (必須) |
ReservationStatus | 予約の現在のステータス。 |
ticketDownloadUrl | URL | チケットをダウンロードできる場所。 |
ticketNumber | テキスト | チケットの番号または ID。 |
ticketPrintUrl | URL | チケットを印刷できる場所。 |
ticketToken | テキストまたは URL | バーコード画像がサイトにホストされている場合、このフィールドの値は画像の URL またはバーコードまたは QR の URI になります(例: barcode128:AB34(ISO-15417 バーコード)、qrCode:AB34(QR コード)、aztecCode:AB34(Aztec コード)、barcodeEAN:1234(EAN コード)、barcodeUPCA:1234(UPCA コード))。 |
underName (必須) |
Person または Organization | チケットの所有者。 |
underName.email | テキスト | メールアドレス。 |
underName.name (必須) |
テキスト | 人物の名前。 |
url | URL | 予約を確認できるウェブページ。 |
venueRow | テキスト | 座席の列。 |
venueSeat | テキスト | 座席番号。 |
venueSection | テキスト | 座席のセクション。 |