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

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

  • @id: コンテンツのグローバル 識別子
  • url: コンテンツの正規 URL
  • name: コンテンツの名前。

@idurlname の例:

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

識別子

ID(@id)は次の要件を満たす必要があります。

  • カタログ全体でグローバルに一意
    • たとえば、TVSeriesTVSeason に同じ @id を使用しないでください。
  • 静的
    • @id は後で変更できません。
  • Unified Resource Identifier(URI)の形式
    • コンテンツのローカル識別子(ID)が URI 形式でない場合は、ID の先頭にドメインを追加してこの要件を満たします。たとえば、コンテンツの ID が 1234abc でドメインが https://example.com の場合、@idhttps://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=1234example.com/dresses/1234)、Google はそのうちの 1 つを正規 URL として選択します。」(出典: 重複する URL を統合する

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

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

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

次の手順に従います。

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