コンテンツの ID、URL、名前を収集する

カタログ内のコンテンツ エンティティには、通常、次のプロパティが必要です。

  • @id: エンティティのグローバル ID。
  • url: コンテンツの正規 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 は後から変更できません。
  • Unified Resource Identifier(URI)の形式
    • コンテンツのローカル識別子(ID)が URI 形式でない場合は、この要件を満たすために、ID の前にドメインを追加します。たとえば、コンテンツの ID が 1234abc で、ドメインが https://example.com の場合、@id は https://example.com/1234abc になります。
    • @id は有効な URL である必要はありません。URI 形式であれば問題ありません。
    • @id で使用されるドメイン(例: https://example.com)は、組織が所有している必要があります。

エンティティの url は、識別子としてのすべての要件(グローバルに一意、静的、URI 形式)を満たしているため、エンティティの url を @id として使用することをおすすめします。

正規 URL

正規 URL(url)は、カタログ内のコンテンツと Google のデータベース内のコンテンツを正確に照合するために役立ちます。

「正規 URL とは、サイトにある一連の重複したページの中で、Google が最も代表的と考えるページの URL です。たとえば、同じページに複数の URL(例: example.com?dress=1234 と example.com/dresses/1234)がある場合、Google はそのうちの 1 つを正規 URL として選択します。」(出典: 重複した URL を統合する)

正規 URL の要件は次のとおりです。

  • url はグローバルに一意である必要があります。
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
  • (Listen Actions のみ)url は、ペイウォールでブロックされていないコンテンツの説明ページを指している必要があります。
  • (ライブテレビ)BroadcastEvent エンティティに url を含めないでください。テレビ番組や映画の放送の場合は、基になる Movie、TVSeries、TVEpisode エンティティに url を指定します。
  • (スポーツ)SportsEvent エンティティに url を含めないでください。SportsEvent.potentialAction を使用して再生リンクを指定します。
  • (ライブテレビとスポーツ)BroadcastEvent.@id が、参照されている Movie、TVSeries、TVEpisode、SportsEvent エンティティの @id と異なることを確認します。

ID、URL、および名前の収集

次の手順に従います。

  1. カタログ内のコンテンツの名前を収集します。
  2. コンテンツの正規 URL を特定します(コンテンツの url を @id として使用することをおすすめします)。