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

目錄中的所有實體都需要下列屬性：

• @id：內容的全球ID。
• 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 可檢索的有效標準網址。
• (僅限 Listen 動作) url 必須指向不受付費牆限制的內容說明頁面。

收集 ID、網址和名稱

請完成下列步驟：

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