事件的內容標記屬性

本節將詳細說明與 Event 相關實體類型的內容標記屬性。

SportsEvent 規格表

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換為實體的 BCP 47 格式語言代碼，例如「en」。
@type 文字 必要：一律設為 SportsEvent。
@id 網址 必要：URI 格式的內容 ID，例如 https://example.com/1234abc。
@id必須符合下列規定：
  • 在目錄中全域不重複 (且與參照此 SportsEvent 的任何 BroadcastEvent 的 @id 不同)
  • 靜態：ID 應固定，不會隨著時間而改變。系統會將這個值視為不透明字串，且不一定要是有效連結。
  • 格式為統一資源識別碼 (URI)
  • 用於 @id 值的網域必須由貴機構所擁有。
重要事項：請勿在 SportsEvent 或 BroadcastEvent 中加入 url 屬性。使用 SportsEvent.potentialAction 提供播放連結。詳情請參閱「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 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)：如果是體育賽事直播，請將 availabilityStarts 設在 SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) 至少 14 天前，這樣即將舉行的活動圖塊才能提前顯示 (活動實體本身可以在接近比賽日的時間提供，只要 availabilityStarts 時間戳記至少在 startDate 14 天前即可)。
  • 延長賽緩衝時間 (availabilityEnds)：請在 SportsEvent.endDate 後設定 availabilityEnds，並預留至少 2 到 3 小時的緩衝時間 (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours，或直到隨選影片重播時間結束)，以免深層連結在延長賽或賽後報導期間失效。
詳情請參閱「動作標記屬性」。
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": "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 格式的內容 ID，例如 https://example.com/1234abc。
@id必須符合下列規定：
  • 在目錄中全域不重複
  • 靜態
  • 格式為統一資源識別碼 (URI)
由於實體的 url 符合 ID 的所有規定，因此建議您將實體的 url 做為 @id。詳情請參閱「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 格式的內容 ID，例如 https://example.com/1234abc。
@id必須符合下列規定：
  • 在目錄中全域不重複
  • 靜態
  • 格式為統一資源識別碼 (URI)
由於實體的 url 符合 ID 的所有規定，因此建議您將實體的 url 做為 @id。詳情請參閱「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"
  }
}