事件的內容標記屬性

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

SportsEvent 規格表格

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換成採用 BCP 47 格式的實體語言代碼，例如「en」。
@type 文字 必要 - 一律設為 SportsEvent。
@id 網址 必要 - URI 格式的內容 ID，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 在所有目錄中皆不重複
  • 靜態。即使節目的網址屬性有所變更，這個 ID 應固定，不會隨時間改變。系統會將其視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構擁有。
由於實體的 url 符合所有要求做為 ID，我們建議您使用實體的 url 做為 @id。詳情請參閱「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或人 強烈建議原因如果不適用主隊或客隊 (例如拳擊比賽、奧運)，請將參與者指定為競爭對手。如果是 SportsTeam，則屬性與 SportsEvent.homeTeam 相同。如果是 Person，則屬性與其他 Person 物件相同，例如 Movie 中的演員。
location Place 或城市 事件的位置。
location.name 文字 必填 - 地點的名稱。
location.address PostalAddress 如果 location @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 必填 (如適用)：在隨選即播影片中播放本次體育賽事錄影的深層連結。如要為直播活動指定深層連結，請改用 BroadcastEvent 中的 publishedOn 或 potentialAction 屬性。
identifier PropertyValue 強烈建議原因- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 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 格式的內容 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 活動 這個事件中的「事件」，舉例來說，一場會議活動包含多場簡報，每個簡報都是會議的子活動。
superEvent 活動 這項活動的一部分。例如，一系列音樂演出可能會各自舉辦音樂節做為超級活動。
location Place 或城市 必要 - 事件的地點。
location.name 文字 必填 - 地點的名稱。
location.address PostalAddress 如果 location @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 活動 這個事件中的「事件」，舉例來說，一場會議活動包含多場簡報，每個簡報都是會議的子活動。
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 Place 或城市 必要 - 事件的地點。請注意，您可以在 City 層級提供 Place。
location.name 文字 必填 - 地點的名稱。
location.address PostalAddress 如果 location @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"
  }
}