カタログ内のすべてのエンティティには、以下のプロパティが必要です。
@id、url、name の例:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
識別子
識別子（@id）は、次の要件を満たす必要があります。
- カタログ全体でグローバルに一意
<ph type="x-smartling-placeholder">
- </ph>
- たとえば、
TVSeriesとTVSeasonに同じ@idを使用しないでください。
- たとえば、
- 静的
<ph type="x-smartling-placeholder">
- </ph>
@idを後で変更することはできません。
- 統合リソース識別子（URI）の形式
<ph type="x-smartling-placeholder">
- </ph>
- コンテンツのローカル識別子（ID）が URI 形式でない場合は、この要件を満たすために ID の前にドメインを付加します。たとえば、コンテンツの ID が 1234abc でドメインが https://example.com の場合、
@idは https://example.com/1234abc のように指定できます。 @idは有効な URL である必要はありません。URI 形式にする必要があります。@idで使用するドメイン（例: https://example.com）は、組織が所有している必要があります。
- コンテンツのローカル識別子（ID）が URI 形式でない場合は、この要件を満たすために ID の前にドメインを付加します。たとえば、コンテンツの ID が 1234abc でドメインが 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、および名前の収集
次の手順に従います。
- カタログ内のコンテンツの名前を収集します。
- コンテンツの正規 URL を特定します（コンテンツの
urlを@idとして使用することをおすすめします）。