收集內容的 ID、網址和名稱

目錄中的內容實體通常需要下列屬性：

• @id：實體的全域 ID。
• url：內容的標準網址。請勿在 BroadcastEvent、SportsEvent 或頻道首選實體 (TelevisionChannel 和 CableOrSatelliteService) 上使用 url。
• name：內容名稱。

@id、url 與 name 的範例：

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

ID

ID (@id) 必須符合下列規定：

• 在目錄中不得重複
  • 舉例來說，請勿為 TVSeries 和 TVSeason 使用相同的 @id。
• 靜態
  • @id設定後即無法變更。
• 格式為統一資源識別項 (URI)
  • 如果內容的本機 ID 不是 URI 格式，請在 ID 前方加上網域，以符合這項規定。舉例來說，如果內容 ID 是 1234abc，網域是 https://example.com，則 @id 可以是 https://example.com/1234abc。
  • @id 不一定要是有效網址，只要採用 URI 格式即可。
  • @id 中使用的網域 (例如 https://example.com) 必須由貴機構擁有。

實體的 url 符合 ID 的所有要求 (即全域不重複、靜態，且採用 URI 格式)，因此建議您將實體的 url 做為 @id。

標準網址

標準網址 (url) 可協助 Google 準確比對目錄中的內容與 Google 資料庫中的內容。

「標準網址」是指 Google 從網站的一組重複網頁中，選出的最具代表性網頁網址。舉例來說，如果同一個網頁有 example.com?dress=1234 和 example.com/dresses/1234 兩個網址，Google 便會選擇其中之一做為標準網址。(來源：整合重複的網址)

標準網址必須符合下列規定：

• url 須為全域唯一值。
• url 必須包含 Google 可檢索的有效標準網址。
• (僅限收聽動作) url 必須指向未設付費牆的內容說明頁面。
• (電視直播) BroadcastEvent 實體不得包含 url。如果是電視和電影播送，請在基礎 Movie、TVSeries 或 TVEpisode 實體上提供 url。
• (體育) 請勿在 SportsEvent 實體中加入 url。使用 SportsEvent.potentialAction 提供播放連結。
• (電視直播和體育賽事) 確保 BroadcastEvent.@id 與參照的 Movie、TVSeries、TVEpisode 或 SportsEvent 實體的 @id 不同。

收集 ID、網址和名稱

請完成下列步驟：

1. 收集目錄中的內容名稱。
2. 找出內容的標準網址。(建議將內容的 url 做為 @id)。