カタログ内のコンテンツ エンティティには、通常、次のプロパティが必要です。
@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)は、組織が所有している必要があります。
- コンテンツのローカル識別子(ID)が URI 形式でない場合は、この要件を満たすために、ID の前にドメインを追加します。たとえば、コンテンツの ID が 1234abc で、ドメインが 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、および名前の収集
次の手順に従います。
- カタログ内のコンテンツの名前を収集します。
- コンテンツの正規 URL を特定します(コンテンツの
urlを@idとして使用することをおすすめします)。