事件的内容标记属性

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

SportsEvent 规范表

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

SportsEvent 示例

示例 1 

{
  "@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"
    }
  ]
}

示例 2 

{
  "@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"
    }
  }
}

MusicEvent 规范表

媒体资源 预期类型 说明
@context Text 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为采用 BCP 47 格式的实体语言代码，例如“en”。
@type Text 必需 - 始终设置为 MusicEvent。
@id 网址 必需 - 采用 URI 格式的内容标识符，例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在目录中具有全局唯一性
  • 静态
  • 采用统一资源标识符 (URI) 形式
由于实体的 url 满足作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
name Text 必需 - 此事件的名称。
  • 使用数组列出不同语言的名称。请参阅多区域和语言示例。
  • 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
description Text 活动的说明。300 个字符的极简主义风格。使用数组可以添加多种语言和长度的说明。
attendee Organization 或 Person 参加活动的个人或组织。
startDate 日期 必需 - 活动开始时间，采用 ISO 8601 格式，并带有时区。
endDate 日期 活动结束时间，采用 ISO 8601 格式，并带有时区。
composer Organization 或 Person 撰写乐曲的个人或组织，或在特定活动中表演的作品的作曲家。
performer Organization 或 Person 必需属性 - 活动中的表演者，例如演示者、音乐人、乐队或演员。
subEvent 事件 属于此事件的事件。例如，某个会议活动包含许多演示文稿，每项展示都是会议的一个子活动。
superEvent 事件 此事件所属的事件。例如，一系列单独的音乐表演可能会将音乐节作为其 superEvent。
location 地点或城市 必需 - 活动地点。
location.name Text 必需 - 营业地点的名称。
location.address PostalAddress 如果 location @type 为 Place，则必须提供 - 地理位置的地址。如果 location @type 为“城市”，则不应使用此选项。
location.address.streetAddress Text 营业地点的街道地址。
location.address.addressLocality Text 地理位置所在的城市。
location.address.addressRegion Text 营业地点的状态。
location.address.postalCode Text 地理位置的邮政编码。
location.address.addressCountry Text 采用 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 Text 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为采用 BCP 47 格式的实体语言代码，例如“en”。
@type Text 必需 - 始终设置为 Event。
@id 网址 必需 - 采用 URI 格式的内容标识符，例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在目录中具有全局唯一性
  • 静态
  • 采用统一资源标识符 (URI) 形式
由于实体的 url 满足作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
name Text 必需 - 此事件的名称。
  • 使用数组列出不同语言的名称。请参阅多区域和语言示例。
  • 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
description Text 活动的说明。300 个字符的极简主义风格。使用数组可以添加多种语言和长度的说明。
attendee Organization 或 Person 参加活动的个人或组织。
startDate 日期 必需 - 活动开始时间，采用 ISO 8601 格式，并带有时区。
endDate 日期 活动结束时间，采用 ISO 8601 格式，并带有时区。
subEvent 事件 属于此事件的事件。例如，某个会议活动包含许多演示文稿，每项展示都是会议的一个子活动。
superEvent 事件 此事件所属的事件。例如，一系列单独的音乐表演可能会将音乐节作为其 superEvent。
releasedEvent PublicationEvent、FeaturedEvent 或 ExclusiveEvent 强烈推荐为什么？- PublicationEvent 用于指定发布商内容的原始（全球或本地）发行日期，例如电影的原始影院上映日期。

此外，使用 FeaturedEvent 表明您的服务以原创、精选、特别等形式推广此类内容。

ExclusiveEvent 指定您的服务拥有独家发行权，并说明了具体发行地点和时间。

请参阅示例部分了解详细信息和示例。
releasedEvent.@type Text 必需 - 请务必将此属性设为以下其中一项：
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必填 - 与此活动相关联的地区。

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

对于 FeaturedEvent 和 ExclusiveEvent，这是指内容的推介或专属地区。

请使用 ISO 3166 表示国家/地区代码。如要指示世界上的任何地方，请设置为 EARTH。
releasedEvent.startDate 日期或 DateTime 建议 - 必须为 ExclusiveEvent 提交此属性 - 实体的发布日期。

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

对于 ExclusiveEvent 和 FeaturedEvent，此字段表示该实体专享或特推的开始日期。
releasedEvent.endDate 日期或 DateTime 推荐 - 必须为 ExclusiveEvent 提供此属性 - 仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。

对于 ExclusiveEvent，这代表内容相关权利到期的日期。

对于 FeaturedEvent，这表示提供方最后一次推介该实体的日期。

如果内容为永久专享或精选内容，请将 endDate 设置为从当前日期起的 20 年后。
releasedEvent.publishedBy Organization 或 Person 可选 - 发布此实体的组织或个人。
location 地点或城市 必需 - 活动地点。请注意，您可以在 City 级别提供 Place。
location.name Text 必需 - 营业地点的名称。
location.address PostalAddress 如果 location @type 为 Place，则必须提供 - 地理位置的地址。如果 location @type 为“城市”，则不应使用此选项
location.address.streetAddress Text 营业地点的街道地址。
location.address.addressLocality Text 地理位置所在的城市。
location.address.addressRegion Text 营业地点的状态。
location.address.postalCode Text 地理位置的邮政编码。
location.address.addressCountry Text 采用 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"
  }
}