事件的內容標記屬性

本節提供 Event 相關實體類型的內容標記屬性詳細資料。

SportsEvent 規格表

屬性 預期類型 說明
@context Text 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換為實體的語言代碼，並採用 BCP 47 格式，例如「en」。
@type Text 必要 - 一律設為 SportsEvent。
@id 網址 必要 - 內容的 ID，格式為 URI，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 目錄中全域專屬
  • 靜態：這個 ID 應固定，不會隨著時間而改變 (即使節目網址屬性變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。
  • 格式為統一資源識別碼 (URI)
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「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 Person 團隊中個別運動員的註解。
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 如果位置 @type 為 Place，則為必填 - 位置的地址。如果地點 @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。可使用多個 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 Text 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換為實體的語言代碼，並採用 BCP 47 格式，例如「en」。
@type Text 必要 - 一律設為 MusicEvent。
@id 網址 必要 - 內容的 ID，格式為 URI，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 目錄中全域專屬
  • 靜態
  • 格式為統一資源識別碼 (URI)
由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「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 如果位置 @type 為 Place，則為必填 - 位置的地址。如果地點 @type 為 City，則不應使用這項屬性。
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 網址 必要 - 內容的 ID，格式為 URI，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 目錄中全域專屬
  • 靜態
  • 格式為統一資源識別碼 (URI)
由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「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 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 Text 必填：地點名稱。
location.address PostalAddress 如果位置 @type 為 Place，則為必填 - 位置的地址。如果位置資訊 @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 中進行的表演。

活動範例

活動

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