事件的内容标记属性

本部分详细介绍了与 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 为 Place，则为必需属性 - 位置信息的地址。如果位置 @type 为 City，则不应使用此属性
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 Organization 或 Person 参加活动的人员或组织。
startDate 日期 必需 - 活动的开始时间，采用 ISO 8601 格式，并带有时区。
endDate 日期 活动的结束时间，采用 ISO 8601 格式，并带有时区。
composer Organization 或 Person 创作乐曲的人员或组织，或者在某个活动中表演的作品的作曲家。
performer Organization 或 Person 必需 - 活动的表演者，例如演示者、音乐人、音乐团体或演员。
subEvent 事件 相应活动的组成部分。例如，会议活动包含许多演示，每场演示都是会议的子活动。
superEvent 事件 相应活动所属的活动。例如，一系列个人音乐表演可能都以音乐节作为其 superEvent。
location 地点或城市 必需 - 活动的地点。
location.name 文本 必需 - 营业地点的名称。
location.address PostalAddress 如果位置信息 @type 为 Place，则为必需属性 - 位置信息的地址。如果位置 @type 为 City，则不应使用此字段。
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 Organization 或 Person 参加活动的人员或组织。
startDate 日期 必需 - 活动的开始时间，采用 ISO 8601 格式，并带有时区。
endDate 日期 活动的结束时间，采用 ISO 8601 格式，并带有时区。
subEvent 事件 相应活动的组成部分。例如，会议活动包含许多演示，每场演示都是会议的子活动。
superEvent 事件 相应活动所属的活动。例如，一系列个人音乐表演可能都以音乐节作为其 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 Organization 或 Person 可选 - 发布相应实体的组织或个人。
location 地点或城市 必需 - 活动的地点。请注意，您可以在 City 级别提供 Place。
location.name 文本 必需 - 营业地点的名称。
location.address PostalAddress 如果位置信息 @type 为 Place，则为必需属性 - 位置信息的地址。如果位置 @type 为 City，则不应使用此属性
location.address.streetAddress 文本 相应位置的街道地址。
location.address.addressLocality 文本 相应位置所在的城市。
location.address.addressRegion 文本 位置信息的状态。
location.address.postalCode 文本 相应地点的邮政编码。
location.address.addressCountry 文本 采用 ISO 3166 格式的国家/地区。
workPerformed CreativeWork 在某个活动中表演的作品，例如在 TheaterEvent 中表演的戏剧。

活动示例

事件

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