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

定義

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

哪些內容可以標示為 SportsEvent? 運動遊戲
哪些內容無法標示為 SportsEvent?

任何短篇影片、剪輯片段或額外內容。清單如下:

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

如何處理這類額外內容?

SportsEvents 的常見用途

S.No. 說明 必要實體
案例 1

我需要為電視直播目錄和線上串流中的 SportsEvent 建立模型。

賽事透過網際網路串流播放,不屬於任何頻道。

代表遊戲的 SportsEvent。

BroadcastEvent:代表遊戲直播。

案例 2 我需要為 SportsEvent 建立模型,該項目屬於我的電視直播目錄,並在頻道上線上串流。

代表遊戲的 SportsEvent。

BroadcastEvent:代表比賽轉播。

BroadcastService、Organization、TelevisionChannel、CableOrSatelliteService 實體,代表頻道和首選頻道。

案例 3 上述兩種情況的組合。 如果合併上述用途,請提供對應「必要實體」欄中列出的所有實體類型。

最佳做法和洞察資訊,以及我們執行的幾項檢查

建立體育賽事及其播送內容的模型時,請遵守下列規範和品質檢查。

請對所有 SportsEvent 整合項目套用下列規則:

  • 將所有體育賽事深層連結放在 SportsEvent.potentialAction:遊戲層級深層連結 (WatchAction) (適用於無頻道直播和隨選影片重播) 必須僅位於 SportsEvent 實體 (SportsEvent.potentialAction)。請勿將 potentialAction 放在參照 SportsEvent 的 BroadcastEvent 上。(如果是沒有特定賽事深層連結的線性頻道播送,請在 BroadcastService.potentialAction 提供頻道深層連結)。如果一場賽事有多個串流 (例如區域動態消息、主場或客場播送、多種語言,或獨立的直播和隨選影片重播網址),請在 SportsEvent.potentialAction 中提供 WatchAction 物件陣列。
  • 滾動週期 (availabilityStarts):請至少在 SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) 的 14 天前設定 SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityStarts,以便提前顯示即將推出的遊戲圖塊和收看通知。您不需要提前 14 天提交動態饋給實體,只要 availabilityStarts 時間戳記設在 SportsEvent.startDate 至少 14 天前,即可在接近比賽日的時間提交事件資料。
  • 延長賽緩衝時間 (availabilityEnds):將 SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityEnds 設在 SportsEvent.endDate 之後,並預留至少 2 到 3 小時的緩衝時間 (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours,或直到隨選影片重播時間結束),這樣深層連結就不會在直播延長賽或賽後報導期間失效。
  • @id 和 url 規定:
    • 使用不同的 @id 值:BroadcastEvent.@id 必須與 SportsEvent.@id 不同。
    • 省略 url:請勿在 BroadcastEvent 或 SportsEvent 實體中加入 url 屬性。
S.No. 必要實體 指南規範
案例 1

我需要為電視直播目錄和線上串流中的 SportsEvent 建立模型。

賽事透過網際網路串流播放,不屬於任何頻道。

必要實體

  • 代表遊戲的SportsEvent
  • BroadcastEvent,代表比賽播出

建模指南

子案例 1:比賽僅提供直播 (不屬於隨選影片目錄)

  • 提供 BroadcastEvent 實體,分享播送時間表,使用 BroadcastEvent.broadcastOfEvent 參照賽事,並在 BroadcastEvent.location 中指定播送國家/地區。
  • 使用 SportsEvent.potentialAction 在 SportsEvent 實體上提供直播深層連結 (設定 14 天片頭 availabilityStarts 和 2 到 3 小時的超時緩衝 availabilityEnds)。
  • 請勿提供 BroadcastEvent.potentialAction、BroadcastEvent.url 或 SportsEvent.url。
  • 請勿提供 BroadcastEvent.publishedOn,因為比賽是在線上串流播放,沒有定頻頻道。

子案例 2:比賽提供直播和隨選影片目錄 (例如,完整比賽重播仍可隨選觀看)

  • 提供 BroadcastEvent 實體,分享各個播送內容的時間表 (參照 BroadcastEvent.broadcastOfEvent 並指定 BroadcastEvent.location)。
  • 在 SportsEvent.potentialAction 上整合直播和隨選影片播放,方法有兩種:如果網址和授權相同,可將 availabilityEnds 延長至隨選影片視窗結束;或者,在 SportsEvent.potentialAction 中提供多個 WatchAction 物件,並分別設定 actionAccessibilityRequirement 視窗。
  • 請勿提供 BroadcastEvent.potentialAction、BroadcastEvent.url、SportsEvent.url 或 BroadcastEvent.publishedOn。

要執行的品質檢查

  • 在賽事直播時,將 BroadcastEvent.isLiveBroadcast 設為布林值 true (不加引號)。如要排定重播直播,請將其設為 false。
  • 對於未上線的 BroadcastEvent 實體,BroadcastEvent.startDate 不得早於 SportsEvent.startDate。
  • 在 homeTeam 和 awayTeam 中加入 parentOrganization (包含維基百科 sameAs 網址)。
案例 2

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

必要實體

  • 代表遊戲的 SportsEvent。
  • BroadcastEvent,代表賽事播出。
  • BroadcastService、Organization、 TelevisionChannel、CableOrSatelliteService 實體,代表頻道和首選頻道。

建模指南

子案例 1:賽事僅在線性頻道直播 (不屬於隨選影片目錄)

  • 提供 BroadcastEvent 實體,分享播送時間表,其中 BroadcastEvent.publishedOn 指向 BroadcastService 實體,BroadcastEvent.broadcastOfEvent 指向 SportsEvent 實體,BroadcastEvent.location 指定播送國家/地區。
  • 提供 BroadcastService、Organization、TelevisionChannel 和 CableOrSatelliteService 實體來代表頻道和首選頻道,並在 BroadcastService.potentialAction 上提供頻道深層連結。
  • 請勿提供 BroadcastEvent.potentialAction、BroadcastEvent.url 或 SportsEvent.url。
  • 如果您也支援直接遊戲專屬深層連結,請在 SportsEvent.potentialAction 上提供;如果只能透過 BroadcastService.potentialAction 上的線性頻道深層連結播放,請省略 SportsEvent.potentialAction。

子案例 2:遊戲在頻道上直播,並列入隨選影片目錄

  • 提供 BroadcastEvent 實體 (包含 publishedOn、broadcastOfEvent 和 location),分享頻道播送時間表。
  • 提供 BroadcastService、Organization、TelevisionChannel 和 CableOrSatelliteService 實體,並在 BroadcastService.potentialAction 上提供頻道深層連結。
  • 請勿提供 BroadcastEvent.potentialAction、BroadcastEvent.url 或 SportsEvent.url。
  • 請在事件層級/隨選影片播放視窗的 SportsEvent 實體上提供 SportsEvent.potentialAction。

要執行的品質檢查

  • 如果遊戲正在直播,請將 BroadcastEvent.isLiveBroadcast 設為布林值 true (不加引號);如果是重播,則設為 false。
  • 對於未上線的 BroadcastEvent 實體,BroadcastEvent.startDate 不得早於 SportsEvent.startDate。
  • 在 homeTeam 和 awayTeam 中加入 parentOrganization (包含維基百科 sameAs 網址)。

範例

案例 1:體育賽事屬於電視直播目錄,且在線上串流播放

活動轉播

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_event/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": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "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."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-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": "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/pbl_finals_game_6?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": "2019-09-01T10:00-08:00",
      "availabilityEnds": "2019-09-16T16:00-08:00",
      "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_event/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": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "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."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-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": "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"
    }
  ]
}

BroadcastService、CableOrSatelliteService、TelevisionChannel 和 Organization 實體,如「概念」下方的「電視直播頻道」一節所述。

如何處理額外內容?

哪些內容屬於額外內容?
  • 隨機回顧或重播短片
  • 遊戲預覽
  • 遊戲亮點
  • 遊戲出糗片段
  • 球員訪談片段
  • 幕後花絮影片
  • 遊戲評論 (使用者生成或其他來源)
  • 其他隨機遊戲短片
S.No. 用途 建模指南
案例 1 我的隨選影片目錄中有額外內容。
  • 系統不支援這項做法,且無法在動態饋給中提供。
  • 不過,ViTA 可用於提供這類內容的子集。如要進一步瞭解 ViTA,請洽詢 Google 代表。
案例 2 我的上架目錄中有額外內容

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

  • 提供 BroadcastEvent 實體,分享直播時間表。
  • 使用 BroadcastEvent.potentialAction 屬性提供額外內容的深層連結 (這項例外狀況僅適用於獨立直播額外內容,因為動態饋給中沒有 SportsEvent 實體)。
  • 將與剪輯片段相關聯的中繼資料直接新增至 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 類似。,然後按照畫面上的指示操作。

常見問題

問:哪裡可以找到上述實體的相關規格?

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

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

問:是否有更詳細的文件,說明如何建立電視直播頻道和首選頻道模型?

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

問:ViTA 是否也支援完整直播賽事和完整賽事重播?

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

  • 如果合作夥伴已與 Google 合作提供功能正常的媒體動作動態饋給,或提供隨選影片或電視直播,Google 會要求動態饋給擴充,並納入支援的 SportsEvent 類型。

    • 短期內,合作夥伴可以使用 ViTA 擷取額外內容。 長期目標是透過動態饋給支援所有類型的內容。
  • 如果合作夥伴沒有隨選影片或電視直播,只有聯盟賽事和相關額外內容,ViTA 是很好的起點。如要進一步瞭解 ViTA,請洽詢 Google 代表。