活動預訂

使用這個類型，即可為活動中的一或多位嘉賓宣告預訂。也可以宣告票證。

用途

以下用途說明瞭 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.name Text 與動作相關聯的 UI 元素向使用者顯示的字串。
action.url 網址 動作的目標網址。如果未提供明確的處理常式欄位，行動處理常式會展開為 WebActionHandler，並將此網址設為 WebActionHandler 網址。
additionalTicketText Text 票證的其他資訊。
bookingAgent 機構或個人 預訂服務專員或代理商。也接受字串 (例如「"")。
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
(必填)		 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
(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
(必填)		 Text 使用者姓名。
url 網址 可查看預訂資訊的網頁。
venueRow Text 座位的排數。
venueSeat Text 座位編號。
venueSection Text 座位的部分。