事件的内容标记属性

本部分详细介绍了与 Event 相关的实体类型的内容标记属性。

SportsEvent 规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为实体的语言代码（采用 BCP 47 格式），例如“en”。
@type 文本 必需 - 始终设置为 SportsEvent。
@id 网址 必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在整个目录中全局唯一
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。
  • 采用统一资源标识符 (URI) 格式
  • 用于 @id 值的网域必须归贵组织所有。
由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
name 文本 必填 - 此事件的名称。
  • 使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。
  • 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
description 文本 此事件的说明。字符数上限为 300 个字符。使用数组包含多种语言和长度的说明。
sport 网址 必填 指向相应运动的维基百科页面（首选英语版本）的链接。
startDate DateTime 或 Date 必需 - 活动的开始时间，采用 ISO 8601 格式并带有时区。请注意，这是活动的实际开始时间，而不是电视上播放活动的时间。
endDate DateTime 或 Date 活动的结束时间，采用 ISO 8601 格式并带时区。
homeTeam SportsTeam 强烈建议赛事的主场队。
homeTeam.name 文本 必填 体育队的完整名称。
homeTeam.sport 网址 必填 指向相应运动的维基百科页面（首选英语版本）的链接。
homeTeam.sameAs 网址 强烈建议可标识团队的参考网页的网址；例如，该团队的维基百科页面。
homeTeam.athlete Person 针对球队中个别运动员的注释。
homeTeam.athlete.name 文本 运动员的全名。
homeTeam.parentOrganization.name SportsOrganization 必填 球队所属的体育联盟的名称。例如，美国国家篮球协会或美国职业棒球大联盟。请注意，此字段不应用于团队的会议。
homeTeam.parentOrganization.sameAs 网址 强烈建议可标识球队所属联盟的参考网页的网址；例如，该联盟的维基百科页面。
awayTeam SportsTeam 强烈建议赛事的客队。属性与 SportsEvent.homeTeam 相同。
competitor SportsTeam 或 Person 强烈建议如果主场或客场球队不适用（例如拳击比赛、奥运会），请将参与者指定为竞争者。如果为 SportsTeam，则属性与 SportsEvent.homeTeam 相同。如果为 Person，则属性与其他 Person 对象相同；例如，Movie 中的演员。
location 地点或城市 活动的地点。
location.name 文本 必需 - 营业地点的名称。
location.address PostalAddress 如果位置 @type 为“地点”，则必需：相应位置的地址。如果位置 @type 为城市，则不应使用此属性
location.address.streetAddress 文本 相应位置的街道地址。
location.address.addressLocality 文本 地理位置所在的城市。
location.address.addressRegion 文本 相应营业地点的状态。
location.address.postalCode 文本 相应地点的邮政编码。
location.address.addressCountry 文本 国家/地区（采用 ISO 3166 格式）。
image ImageObject 对于 Google TV 是必需的：与活动相关的图片。建议使用活动的官方海报或横幅图片。如需详细了解应与 image 一起添加的必需属性和可选属性，请参阅图片属性。
potentialAction WatchAction 如果适用，则为必需 - 用于在点播视频中播放此体育赛事录制的深层链接。如需为直播活动指定深层链接，请改用 BroadcastEvent 中的 publishedOn 或 potentialAction 属性。
identifier PropertyValue 强烈建议- 明确标识了此实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。

SportsEvent 示例

团队运动示例

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

个人运动示例

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

带有 GeoShape 限制的 SportsEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

MusicEvent 规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为实体的语言代码（采用 BCP 47 格式），例如“en”。
@type 文本 必需 - 始终设置为 MusicEvent。
@id 网址 必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在整个目录中全局唯一
  • 静态
  • 采用统一资源标识符 (URI) 格式
由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
name 文本 必填 - 此事件的名称。
  • 使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。
  • 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
description 文本 对相应事件的说明。字符数上限为 300 个字符。使用数组包含多种语言和长度的说明。
attendee 组织或个人 参加活动的个人或组织。
startDate 日期 必填 - 活动的开始时间，采用 ISO 8601 格式并带有时区。
endDate 日期 活动的结束时间，采用 ISO 8601 格式并带时区。
composer 组织或个人 创作了某个乐曲或在某个活动中演奏了某个作品的作曲者（个人或组织）。
performer 组织或个人 必填 - 活动中的表演者，例如主持人、音乐人、音乐团体或演员。
subEvent 事件 此事件的一部分。例如，一个会议活动包含许多演讲，每个演讲都是该会议的子事件。
superEvent 事件 此事件所属的事件。例如，一组单独的音乐表演可能都将音乐节作为其超级活动。
location 地点或城市 必填 - 活动的地点。
location.name 文本 必需 - 营业地点的名称。
location.address PostalAddress 如果位置 @type 为“地点”，则必需：相应位置的地址。如果位置 @type 为城市，则不应使用此属性。
location.address.streetAddress 文本 相应位置的街道地址。
location.address.addressLocality 文本 地理位置所在的城市。
location.address.addressRegion 文本 相应位置的状态。
location.address.postalCode 文本 相应地点的邮政编码。
location.address.addressCountry 文本 国家/地区（采用 ISO 3166 格式）。
workPerformed CreativeWork 在某个活动中表演的作品，例如在 TheaterEvent 中表演的戏剧。

MusicEvent 示例

MusicEvent 

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

事件规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为实体的语言代码（采用 BCP 47 格式），例如“en”。
@type 文本 必需 - 始终设置为 Event。
@id 网址 必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在整个目录中全局唯一
  • 静态
  • 采用统一资源标识符 (URI) 格式
由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
name 文本 必填 - 此事件的名称。
  • 使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。
  • 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
description 文本 对相应事件的说明。字符数上限为 300 个字符。使用数组包含多种语言和长度的说明。
attendee 组织或个人 参加活动的个人或组织。
startDate 日期 必填 - 活动的开始时间，采用 ISO 8601 格式并带有时区。
endDate 日期 活动的结束时间，采用 ISO 8601 格式并带时区。
subEvent 事件 此事件的一部分。例如，一个会议活动包含许多演讲，每个演讲都是该会议的子事件。
superEvent 事件 此事件所属的事件。例如，一组单独的音乐表演可能都将音乐节作为其超级活动。
releasedEvent PublicationEvent、FeaturedEvent 或 ExclusiveEvent 强烈建议- PublicationEvent 用于指定发布商的原始（全球或本地）内容发布日期，例如电影的原始影院上映日期。

此外，使用 FeaturedEvent 可指明您的服务将此内容作为原创内容、精选内容、特别内容等进行营销。

ExclusiveEvent 用于指定您的服务拥有独家分销权，并包含分销地点和时间。

如需了解详情和示例，请参阅示例部分。
releasedEvent.@type 文本 必需 - 请务必始终将此属性设置为以下值之一：
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必填 - 与此活动相关联的地区。

对于 PublicationEvent，这是内容的发布地区。

对于 FeaturedEvent 和 ExclusiveEvent，这是内容的专题或独家地区。

请使用 ISO 3166 代码来表示国家/地区。如需指明世界各地，请设置为 EARTH。
releasedEvent.startDate Date 或 DateTime 推荐 - 对于 ExclusiveEvent 为必填 - 实体发布的开始日期。

对于 PublicationEvent，此属性表示此实体的初始发布日期，例如电影首次在影院上映的日期。

对于 ExclusiveEvent 和 FeaturedEvent，此属性表示实体作为独家或精选内容的开始日期。
releasedEvent.endDate Date 或 DateTime 推荐 - 对于 ExclusiveEvent，此属性为必填 - 此属性仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。

对于 ExclusiveEvent，此属性表示内容的权利到期日期。

对于 FeaturedEvent，此属性表示提供商上次精选相应实体的时间。

如果内容是永久性独家内容或精选内容，请将 endDate 设置为距离当前日期 20 年。
releasedEvent.publishedBy 组织或个人 可选 - 发布此实体的组织或个人。
location 地点或城市 必填 - 活动的地点。请注意，您可以在 City 级别提供 Place。
location.name 文本 必需 - 营业地点的名称。
location.address PostalAddress 如果位置 @type 为“地点”，则必需：相应位置的地址。如果位置 @type 为城市，则不应使用此属性
location.address.streetAddress 文本 相应位置的街道地址。
location.address.addressLocality 文本 地理位置所在的城市。
location.address.addressRegion 文本 相应位置的状态。
location.address.postalCode 文本 相应地点的邮政编码。
location.address.addressCountry 文本 国家/地区（采用 ISO 3166 格式）。
workPerformed CreativeWork 在某个活动中表演的作品，例如在 TheaterEvent 中表演的戏剧。

事件示例

Event 

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}