SportsEvents - 模擬、最佳做法和動態饋給範例

定義

SportsEvent 是實體類型，代表體育賽事或體育賽事的完整重播。

哪些內容可以模擬為 SportsEvent？ 運動賽事
哪些內容無法以 SportsEvent 建模？

任何 Shorts 或短片內容，或額外內容。清單如下：

  • 隨機回顧或重播短片
  • 遊戲預覽
  • 遊戲亮點
  • 遊戲出糗片段
  • 球員訪談片段
  • 幕後花絮影片
  • 遊戲評論 (使用者生成或其他)
  • 遊戲中的隨機短片

如何處理這類額外內容？

SportsEvent 的常見用途

序號 說明 必要實體
案例 1 我需要為隨選影片目錄中的 SportsEvent 建立模型。 SportsEvent，代表遊戲。
案例 2

我需要為SportsEvent建立模型，該SportsEvent屬於我的電視直播目錄，並在線上串流播放

遊戲會透過網際網路串流，不會附加至任何頻道。

代表遊戲的 SportsEvent。

BroadcastEvent，代表遊戲的廣播。
案例 3 我需要為 SportsEvent 建立模型，該模型屬於我的電視直播目錄，並在頻道上串流播放。

代表遊戲的 SportsEvent。

Broadcast 代表賽事播出時間。

BroadcastService、Organization、 TelevisionChannel、CableOrSatelliteService 代表頻道和節目表的實體。
案例 4 上述三種情況的組合。 如果合併使用部分先前的用途，則必須在對應的「必要實體」欄中提供實體類型。

最佳做法和幾項檢查的深入分析

S.No. 必要實體 指南規範
案例 1

我需要為隨選影片目錄中的 SportsEvent 建立模型。

必要實體

  • SportsEvent 代表遊戲

建模指南

必須使用 SportsEvent.potentialAction 屬性，在 SportsEvent 實體中提供遊戲的深層連結。

要執行的品質檢查

  • 請在SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityStarts 至少 14 天前SportsEvent.startDate設定。我們並非強制規定必須提前 14 天提供體育賽事資料，而是希望您盡量提早提供。不過，availabilityStarts 值必須在活動開始前至少 14 天設定。
  • 在 SportsEvent.endDate 後方設定 SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityEnds 。
案例 2

我需要為SportsEvent建立模型，該SportsEvent屬於我的電視直播目錄，並在線上串流播放。

遊戲會透過網際網路串流，不會附加至任何頻道。

必要實體

  • SportsEvent 代表遊戲
  • BroadcastEvent 代表賽事播出時間

建模指南

子案例 1：賽事僅提供直播，未收錄於隨選影片目錄

  • 必須提供 BroadcastEvent 實體，才能分享廣播時間表。
  • 請使用 BroadcastEvent.potentialAction 屬性，在 BroadcastEvent 實體中提供遊戲的深層連結。
  • 由於賽事只能觀看直播， SportsEvent 實體不得有任何深層連結。也就是說，不得提供 SportsEvent.potentialAction。
  • BroadcastEvent.broadcastOfEvent，因為遊戲未與任何頻道播送內容建立關聯。

子案例 2：遊戲可直播觀看，也可透過隨選影片目錄觀看 (這可能發生在遊戲重播時)

  • 必須提供 BroadcastEvent 實體，才能分享廣播時間表。
  • 請使用 BroadcastEvent.potentialAction 屬性，在 BroadcastEvent 實體中提供遊戲的深層連結。
  • 由於這場賽事會以隨選影片形式收錄在目錄中，因此 SportsEvent 實體也必須有深層連結。必須提供 SportsEvent.potentialAction，才能將使用者重新導向至隨選視訊目錄。
  • 遊戲未與任何頻道播送內容相關聯，因此不得提供 BroadcastEvent.publishedOn。

要執行的品質檢查

  • 遊戲實際直播時，請將 BroadcastEvent.isLiveBroadcast 屬性設為 true。請勿將遊戲重播的 屬性設為 true。
  • 對於BroadcastEvents非直播的SportsEvent startDate，BroadcastEvent.startDate 通常不得早於實際SportsEvent startDate。
  • BroadcastEvents 不應有 publishedOn 屬性，因為廣播會在網路上串流，且不會附加至頻道。
案例 3

我需要模擬SportsEvent，該SportsEvent屬於我的直播電視目錄，並在頻道上串流播放。

必要實體

  • SportsEvent，代表遊戲。
  • BroadcastEvent，代表賽事播出時間。
  • BroadcastService、Organization、 TelevisionChannel、CableOrSatelliteService 代表頻道和節目表的實體。

建模指南

子案例 1：賽事僅提供直播，未收錄於隨選影片目錄

  • 分享廣播時間表。如要這麼做，請提供 BroadcastEvent 實體。
  • 代表頻道和供應商陣容。如要這麼做，請提供 BroadcastService、Organization、TelevisionChannel 和 CableOrSatelliteService 實體。
  • 提供 BroadcastService 深層連結。並以 BroadcastService.potentialAction 屬性表示。
  • 請勿提供 BroadcastEvent.potentialAction 屬性。
  • 由於賽事只能觀看直播， SportsEvent 實體不得有任何深層連結。舉例來說，請勿提供 SportsEvent.potentialAction。
  • 提供 BroadcastEvent.publishedOn，並指向代表廣播發生所在頻道的 BroadcastService 實體。

子案例 2：遊戲可直播觀看，也可在隨選影片目錄中觀看 (這可能發生在遊戲重播時)

  • 提供 BroadcastEvent 實體，分享節目表。
  • 提供代表頻道和供應商陣容的 BroadcastService、Organization、TelevisionChannel 和 CableOrSatelliteService 實體。
  • 提供遊戲直播的頻道BroadcastService深層連結，以 BroadcastService.potentialAction 屬性表示。
  • 請勿提供 BroadcastEvent.potentialAction 屬性。
  • 由於這場賽事可供直播觀看，且屬於隨選影片目錄，因此 SportsEvent 實體也必須有深層連結。舉例來說，可以提供 SportsEvent.potentialAction ，將使用者重新導向至隨選影片目錄。
  • 提供 BroadcastEvent.publishedOn，並指向代表廣播發生所在頻道的 BroadcastService 實體。

要執行的品質檢查

  • 遊戲實際開打時，請將 BroadcastEvent.isLiveBroadcast 屬性設為 true。請勿將遊戲重播的 屬性設為 true。
  • 如果BroadcastEvents不是直播，BroadcastEvent.startDate通常不能早於實際SportsEvent startDate。
  • 由於賽事會在電視頻道上播出，請使用 BroadcastService.potentialAction 屬性新增深層連結。 在此情況下，BroadcastEvent 實體不得有深層連結。

範例

案例 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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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/pbl_semis_game?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-09-01T10:00-08:00",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

案例 2：體育賽事屬於電視直播節目，並透過網路串流播放

活動轉播


{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_eevent/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/pbl_semis_game?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-09-16T10:00-08:00",
      "availabilityEnds": "2018-09-16T10:00-08:00",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  }
}

體育賽事


{
  "@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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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"
    }
  ]
}

案例 3：體育賽事屬於電視直播目錄，並透過頻道線上串流播放

活動轉播


{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_eevent/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  }
}

體育賽事


{
  "@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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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"
    }
  ]
}

BroadcastService、CableOrSatelliteService、TelevisionChannel、Organization 概念下的「電視直播頻道」部分定義的實體

如何處理額外內容？

什麼是額外內容？
  • 隨機回顧或重播短片
  • 遊戲預覽
  • 遊戲亮點
  • 遊戲出糗片段
  • 球員訪談片段
  • 幕後花絮影片
  • 遊戲評論 (使用者生成或其他)
  • 遊戲中的其他隨機短片
S.No. 用途 建模指南
案例 1 我的隨選影片目錄中有額外內容。
  • 系統不支援這項做法，且無法在動態饋給中提供。
  • ViTA 可用於提供這類內容的子集。詳情請洽詢您的 Google 代表，瞭解 ViTA。
案例 2 我的直播目錄中有額外內容

子案例 1：內容可在網路上直播

  • 提供 BroadcastEvent 實體，分享節目表。
  • 使用 BroadcastEvent.potentialAction 屬性提供內容的深層連結。
  • 直接在 BroadcastEvent 中新增與剪輯片段相關聯的任何中繼資料。舉例來說，你可以使用 BroadcastEvent.image 屬性新增圖片。您可以使用 BroadcastEvent.contentRating 屬性新增分級。
  • 由於這個內容類型不是 SportsEvent，動態饋給不得包含 SportsEvent 實體。因此，BroadcastEvent 上的 broadcastOfEvent 屬性不得提供。
  • 由於這項屬性與頻道無關，請勿在 BroadcastEvent 上提供 publishedOn 屬性。

子案例 2：內容可透過網路在頻道上直播

  • 必須提供 BroadcastEvent 實體，才能分享廣播時間表。
  • 必須提供 BroadcastService、Organization、TelevisionChannel 、CableOrSatelliteService 實體，代表頻道和供應商陣容。
  • 遊戲的深層連結必須只是 BroadcastService 深層連結，以 BroadcastService.potentialAction 屬性表示，且必須提供。
  • 請勿提供 BroadcastEvent.potentialAction 屬性。
  • 任何相關聯的中繼資料 (與剪輯片段相關) 都必須直接新增至 BroadcastEvent。舉例來說，可以使用 BroadcastEvent.image 屬性新增圖片。您可以使用 BroadcastEvent.contentRating 屬性新增分級。
  • 由於這個內容類型不是 SportsEvent，動態饋給不得包含 SportsEvent 實體。因此，請勿在 BroadcastEvent 上提供 broadcastOfEvent 屬性。
  • 由於這項設定與頻道相關聯，請在 BroadcastEvent 上提供 publishedOn 屬性。
案例 3 我同時在隨選影片和電視直播目錄中提供額外內容

由於動態消息目前不接受隨選運動肩部內容，因此這與案例 2 類似。請按照畫面上的指示操作。

常見問題

問：哪裡可以找到先前提到實體的相關規格？

答：請參閱這篇文章瞭解必要規格。

整體說明文件 連結
SportsEvent 連結
BroadcastService、Organization、TelevisionChannel 、CableOrSatelliteService 連結
BroadcastEvent 連結

問：是否有更詳細的文件，說明如何模擬電視直播頻道和節目表？

答：可以，詳情請參閱「概念」下的「電視直播頻道」一節。如果無法查看文件，請要求檢視權限。

問：ViTA 是否也支援完整版賽事直播和完整版賽事重播？

答：ViTA 支援聯盟賽事直播和完整賽事重播的中繼資料 (以及部分額外內容)

  • 如果合作夥伴已透過 Google 建立可正常運作的媒體動作動態消息，或提供隨選影片或電視直播內容，Google 會要求合作夥伴擴充動態消息，並加入支援的 SportsEvent 類型。

    • 短期內，合作夥伴可以使用 ViTA 擷取額外內容。長期而言，動態消息應會支援所有類型的內容。

  • 如果合作夥伴沒有隨選影片或電視直播服務，但只提供聯盟賽事和相關額外內容，ViTA 是個不錯的起點。詳情請洽詢您的 Google 代表，進一步瞭解 ViTA。