活动预订

使用此类型声明某个活动的一位或多位邀请对象的预订。同时也可声明门票。

使用场景

以下用例展示了 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>

活动门票,不提供预订座位

添加 ticketTokenticketNumbernumSeats 字段以添加门票的相关信息。

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 类型设置为 MusicEventSportsEvent。如果活动是 MusicEvent(例如音乐会),您应添加 performer.nameperformer.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>

含门票和预订座位的活动

对于含预订座位的单张票,请包含ticketTokenticketNumbervenueSeatvenueRowvenueSection。您只需添加 venueSeatvenueRowvenueSection 中的任一个,即可描述座位的位置。

请勿添加 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

扩展预留

名称 类型 说明
操作 操作 可对此执行的操作。
操作name 文本 在与操作关联的界面元素上向用户显示的字符串。
action.url 网址 操作的目标网址。如果未提供明确的处理程序字段,则操作处理程序将扩展为 WebActionHandler,此网址将作为 WebActionHandler 网址。
additionalTicketText 提供的字段 文本 门票的其他相关信息。
bookingAgent 组织个人 预订代理或代理机构。也接受字符串(例如“”)。
bookingAgent.image 网址 组织映像的网址。
bookingAgent.name 文本 代理/服务的名称。
bookingAgent.url 网址 代理/服务的网站。
bookingTime DateTime 预订的日期。
cancelReservationUrl 网址 可以取消预订的网页。
confirmReservationUrl 网址 可在其中确认预订的网页。
修改时间 DateTime (建议用于确认卡/搜索答案)上次修改预订的时间。
modifyReservationUrl 网址 (建议用于确认卡/搜索答案)可修改预订的网页。
numSeats 编号 席位数。
price 文本 EventReservation 的总价格。
priceCurrency 文本 EventReservation 价格的货币(采用由 3 个字母表示的 ISO 4217 格式)。
programMembership(计划成员资格) 加入计划 适用于预订的常客奖励计划、酒店会员回馈活动等的任何会员资格。
programMembership.memberNumber 文本 成员资格的标识符。
programMembership.program 文本 课程的名称。
reservedFor
(必需)
活动 可以使用 Event 或任何事件子类型,包括 BusinessEvent、ChildrenEvent、喜剧 Event、DanceEvent、EducationEvent、Festival、FoodEvent、LitearyEvent、MovieShowing、MusicEvent、SaleEvent、SocialEvent、SportsEvent、TheaterEvent、VisualArtsEvent。
bookingFor。description 文本 对活动的简短说明。
bookingFor.doorTime DateTime 入场时间开始。
预订.结束日期 DateTime 活动的结束日期和时间。
for_image 网址 活动图片的网址。
bookingFor.location
(必需)
Place 活动的地点。
bookingFor.location.address
(必需)
PostalAddress 活动地点的地址。
bookingFor.location.address.addressCountry
(必需)
文字国家/地区 活动地点所在的国家/地区。
bookingFor.location.address.addressLocality
(必需)
文本 活动地点的市行政区(例如城市)。
bookingFor.location.address.addressRegion
(必需)
文本 活动所在位置的区域(例如州/省)。
bookingFor.location.address.postalCode
(必需)
文本 活动地点的邮政编码。
bookingFor.location.address.streetAddress
(必需)
文本 活动地点的街道地址。
bookingFor.location.name
(必需)
文本 活动地点的名称。
bookingFor。name
(必需)
文本 事件的名称。
预订型.表演者 人员组织 (推荐用于确认卡/搜索答案)活动的执行者。也接受对象数组。
booking.performer.image 网址 (推荐用于确认卡/搜索答案)人物的图片网址。
bookingFor.performer.name 文本 (推荐用于确认卡/搜索答案)联系人的姓名。
bookingFor.performer.url 网址 人物的网址。
bookingFor.startDate
(必需)
DateTime 活动的开始日期和开始时间。
预订.网址 网址 事件的网址。
reservedNumber
)(必需)
文本 预留的编号或 ID。
reservedStatus
(必需)
ReservationStatus 预留的当前状态。
工单下载网址 网址 门票的下载位置。
ticketNumber 文本 门票的编号或 ID。
printPrintUrl 网址 可以打印门票的位置。
工单令牌 文字网址 如果条形码图片托管在您的网站上,则相应字段的值是图片的网址,或者条形码或二维码 URI,例如“barcode128:AB34”(ISO-15417 条形码)、“qrCode:AB34”(QR 码)、“aztecCode:AB34”(Aztec 码)和“barcodeEAN(123)”
underName
(必需)
人员组织 持票人。
UnderName.电子邮件地址 文本 电子邮件地址。
underName.name
(必需)
文本 人员的姓名。
网址 网址 可查看预订的网页。
venueRow 文本 座位所在的行。
venueSeat 文本 座位号。
venueSection 文本 座位区。