收集内容的 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) 必须满足以下要求：

• 在整个目录中全局唯一
  • 例如，请勿对 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 满足作为标识符的所有要求（即全局唯一、静态且采用 URI 格式），因此我们建议您将实体的 url 用作 @id。

规范网址

规范网址 (url) 有助于 Google 准确匹配目录中的内容与 Google 数据库中的内容。

“规范网址是 Google 认为在网站的一组重复网页中最具代表性的网页的网址。例如，如果同一个网页有多个网址（例如：example.com?dress=1234 和 example.com/dresses/1234），Google 便会从中选择一个网址作为规范网址。（来源：整合重复网址）

以下是规范网址的要求：

• url 必须是全局唯一的。
• url 必须包含 Google 可以抓取的有效规范网址。
• （仅限 Listen Action）url 需要指向未被付费墙屏蔽的内容说明页面。
• （直播电视）请勿在 BroadcastEvent 实体中添加 url。对于电视和电影广播，请在底层 Movie、TVSeries 或 TVEpisode 实体上提供 url。
• （体育）请勿在 SportsEvent 实体中添加 url。使用 SportsEvent.potentialAction 提供播放链接。
• （直播电视和体育）确保 BroadcastEvent.@id 与所引用的 Movie、TVSeries、TVEpisode 或 SportsEvent 实体的 @id 不同。

收集 ID、网址和名称

执行以下操作：

1. 收集目录中内容的名称。
2. 确定内容的规范网址。（我们建议您将内容的 url 用作其 @id。）