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

カタログ内のすべてのエンティティには、以下のプロパティが必要です。

• @id: コンテンツのグローバル 識別子。
• url: コンテンツの正規 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）は次の要件を満たす必要があります。

• カタログ全体でグローバルに一意
  • たとえば、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 がカタログ内のコンテンツを Google のデータベース内のコンテンツと正確に一致させるのに役立ちます。

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

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

• url はグローバルに一意である必要があります。
• url には Google がクロールすることが可能な機能する正規 URL を含める必要があります。
• （リッスン アクションのみ）url は、ペイウォールによってブロックされないコンテンツの説明ページを指す必要があります。

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

次の手順に従います。

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