事件的内容标记属性

本部分详细介绍了 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 DateTimeDate 必需 - 活动开始时间,采用 ISO 8601 格式,并带有时区。请注意,这是活动的实际开始时间,而不是活动在电视上播出的时间。
endDate DateTimeDate 活动结束时间,采用 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 SportsTeamPerson 强烈推荐为什么?如果主场或外遣队不适用(如拳击赛、奥运会),请将参与者指定为比赛。如果为 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 中的 publishedOnpotentialAction 属性。
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 OrganizationPerson 参加活动的个人或组织。
startDate 日期 必需 - 活动开始时间,采用 ISO 8601 格式,并带有时区。
endDate 日期 活动结束时间,采用 ISO 8601 格式,并带有时区。
composer OrganizationPerson 撰写乐曲的个人或组织,或在特定活动中表演的作品的作曲家。
performer OrganizationPerson 必需属性 - 活动中的表演者,例如演示者、音乐人、乐队或演员。
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 OrganizationPerson 参加活动的个人或组织。
startDate 日期 必需 - 活动开始时间,采用 ISO 8601 格式,并带有时区。
endDate 日期 活动结束时间,采用 ISO 8601 格式,并带有时区。
subEvent 事件 属于此事件的事件。例如,某个会议活动包含许多演示文稿,每项展示都是会议的一个子活动。
superEvent 事件 此事件所属的事件。例如,一系列单独的音乐表演可能会将音乐节作为其 superEvent。
releasedEvent PublicationEventFeaturedEventExclusiveEvent 强烈推荐为什么?- PublicationEvent 用于指定发布商内容的原始(全球或本地)发行日期,例如电影的原始影院上映日期。

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

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

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

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

对于 FeaturedEventExclusiveEvent,这是指内容的推介或专属地区。

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

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

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

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

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

如果内容为永久专享或精选内容,请将 endDate 设置为从当前日期起的 20 年后。
releasedEvent.publishedBy OrganizationPerson 可选 - 发布此实体的组织或个人。
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"
  }
}