本頁面由 Cloud Translation API 翻譯而成。

活動預訂

這個類型可用來聲明活動中的一或多位邀請對象預訂。您也可以聲明門票。

用途

以下應用實例是 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

延長預留項目

名稱	類型	說明
動作	動作	可對此項操作採取的動作。
action.name	文字	與動作相關聯的 UI 元素上向使用者顯示的字串。
action.url	網址	動作的目標網址。如果沒有提供明確的處理常式欄位，動作處理常式就會展開成 WebActionHandler，並將這個網址做為 WebActionHandler 網址。
additionalTicketText	文字	票券的其他資訊。
bookingAgent	機構或 Person	預訂代理商或代理商。也接受字串 (例如「」)。
bookingAgent.image	網址	機構圖片的網址。
bookingAgent.name	文字	虛擬服務專員/服務的名稱。
bookingAgent.url	網址	服務專員/服務的網站。
bookingTime	DateTime	訂位日期。
cancelReservationUrl	網址	可取消預訂的網頁。
confirmReservationUrl	網址	可確認預訂網頁。
modifiedTime	DateTime	(適用於確認資訊卡/搜尋答案) 預訂的上次修改時間。
modifyReservationUrl	網址	(適用於確認資訊卡/搜尋答案) - 可修改預訂資訊的網頁。
numSeats	Number	座位數。
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	網址	活動圖片網址。
ReservationFor.location (必填)	地點	活動地點。
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	網址	(適用於確認資訊卡/搜尋答案) 人物圖片的網址。
reservationFor.performer.name	文字	(適用於確認卡/搜尋答案) 人員的名稱。
reservationFor.performer.url	網址	個人資料的網址。
ReservationFor.startDate (必填)	DateTime	事件的開始日期和時間。
reservationFor.url	網址	事件的網址。
reservationNumber (必要)	文字	預留項目的 ID 或 ID。
reservationStatus (必要)	ReservationStatus	預留項目的目前狀態。
ticketDownloadUrl	網址	票券的下載位置。
ticketNumber	文字	票券的編號或 ID。
ticketPrintUrl	網址	票券可列印的地點。
ticketToken	Text 或 URL	如果條碼圖片是由您的網站代管，該欄位的值就是圖片的網址，或是條碼或 QR code (例如「barcode128:AB34」)(ISO-15417 條碼)、「qrCode:AB34」(QR code)、「aztecCode:AB34」(Aztec code)、「barcodeEAN:1234」(EAN 代碼) 和「barcodeUPCA:1234」(UPCA 代碼)。
underName (必要)	Person 或 Organization	票券持有人。
underName.email	文字	電子郵件地址。
UnderName.name (必填)	文字	人名。
url	網址	可以檢視預訂項目的網頁。
venueRow	文字	這時座位的排在前面。
venueSeat	文字	座位號碼。
venueSection	文字	座椅區。