事件的内容标记属性

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

SportsEvent 规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为实体的语言代码（采用 BCP 47 格式），例如“en”。
@type 文本 必需 - 始终设置为 SportsEvent。
@id 网址 必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在您的目录中全局唯一（并且与引用此 SportsEvent 的任何 BroadcastEvent 的 @id 不同）
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化。它将被视为不透明字符串，且不必是有效链接。
  • 采用统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归您的组织所有。
重要提示：请勿在 SportsEvent 或 BroadcastEvent 中添加 url 属性。使用 SportsEvent.potentialAction 提供播放链接。如需了解详情，请参阅标识符部分。
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 SportsOrganization 必需 - 球队所属的体育联盟或管理组织。如果同时提供了两支球队，请在 homeTeam 和 awayTeam 中都添加 parentOrganization。
homeTeam.parentOrganization.name 文本 必需 - 球队所属体育联盟的名称。例如，美国职业篮球联赛或美国职业棒球大联盟。请注意，此字段不应用于团队会议。
homeTeam.parentOrganization.sameAs 网址 强烈推荐 原因- 指向维基百科页面（首选英文版）的链接，该页面标识了球队所属的联赛（例如 https://en.wikipedia.org/wiki/National_Basketball_Association）。请勿使用占位符 example.com 网址。
awayTeam SportsTeam 强烈推荐 原因- 赛事的客队。其属性和要求（包括 parentOrganization）与 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 必需（如适用） - 用于播放体育赛事的深层链接，同时适用于无频道直播和视频点播重播。所有体育赛事深层链接都必须位于 SportsEvent.potentialAction 上；切勿将 potentialAction 放置在引用 SportsEvent 的 BroadcastEvent 上（对于没有直接赛事深层链接的线性电视频道广播，请在 BroadcastService.potentialAction 上提供频道深层链接）。如果提供多个直播（例如区域、主场或客场直播，或多语言广播）或单独的直播和视频点播重放窗口，请提供 WatchAction 对象数组。
potentialAction.actionAccessibilityRequirement ActionAccessSpecification 如果提供了 potentialAction，则为必需属性 - 为每个 WatchAction 定义了权益和可点击的播出时段（availabilityStarts 和 availabilityEnds）：
  • 预热期 (availabilityStarts)：对于体育赛事直播，请在 SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) 之前至少 14 天设置 availabilityStarts，以便即将举行的赛事图块可以提前显示（赛事实体本身可以在临近比赛日时交付，只要 availabilityStarts 时间戳比 startDate 至少提前 14 天即可）。
  • 加时赛缓冲时间 (availabilityEnds)：将 availabilityEnds 设置在 SportsEvent.endDate 之后，并至少留出 2 到 3 小时的缓冲时间（availabilityEnds >= SportsEvent.endDate + 2 to 3 hours，或直到视频点播重放窗口结束），以防止深层链接在直播加时赛或赛后报道期间失效。
如需了解完整详情，请参阅操作标记属性。
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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

个人运动类频道示例

{
  "@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",
  "endDate": "2019-07-12T23:30-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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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 事件 属于此事件的事件。例如，一个会议活动包含多场演讲，每场演讲都是该会议的 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 事件 属于此事件的事件。例如，一个会议活动包含多场演讲，每场演讲都是该会议的 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"
  }
}