此页面由 Cloud Translation API 翻译。

事件的内容标记属性

本部分详细介绍了与 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` 中的 actor。
`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 示例

示例 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`	文本	必需 - 始终设置为 `["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"
  }
}