事件的內容標記屬性

本節將說明 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。詳情請參閱「識別碼」一節。
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 必填 團隊所屬的運動聯盟名稱。例如美國職業籃球協會 (NBA) 或美國職業棒球大聯盟 (MLB)。請注意，這個欄位不應用於團隊會議。
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 為 City，則不應使用此屬性
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"
    }
  }
}

設有地理範圍限制的體育賽事

{
  "@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。詳情請參閱「識別碼」一節。
name Text 必填：這項事件的名稱。
  • 使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。
  • 請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
description Text 事件的說明。字數上限為 300 個半形字元。使用陣列加入多種語言和長度的說明。
attendee 機構或個人 參加活動的個人或機構。
startDate 日期 必要：活動的開始時間，採用 ISO 8601 格式，並附上時區。
endDate 日期 活動的結束時間，採用 ISO 8601 格式和時區。
composer 機構或個人 創作音樂作品的人員或機構，或是在某些活動中演奏作品的作曲家。
performer 機構或個人 必填：活動表演者，例如主持人、音樂人、音樂團體或演員。
subEvent 活動 屬於此事件的事件。舉例來說，會議活動包含許多簡報，每個簡報都是會議的子活動。
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。詳情請參閱「識別碼」一節。
name Text 必填：這項事件的名稱。
  • 使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。
  • 請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
description Text 事件的說明。字數上限為 300 個半形字元。使用陣列加入多種語言和長度的說明。
attendee 機構或個人 參加活動的個人或機構。
startDate 日期 必要：活動的開始時間，採用 ISO 8601 格式，並附上時區。
endDate 日期 活動的結束時間，採用 ISO 8601 格式和時區。
subEvent 活動 屬於此事件的事件。舉例來說，會議活動包含許多簡報，每個簡報都是會議的子活動。
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 機構或個人 選填：發布這個實體的機構或人員。
location 地點或城市 必要：活動的地點。請注意，您可以在 City 層級提供 Place。
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 中演出的戲劇。

事件範例

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