メディア フィードは、フィードタイプを表すエンティティのコレクションを含む JSON オブジェクトです。 カタログ内のメディア コンテンツ(テレビシリーズ、映画、曲、アルバムなど)最初のステップは、 オンボーディングプロセスとして フィードの開発を開始しますファイルの準備ができたら、host を使用します。 Google が定期的に取得できるように、サポートされているホスティング方法のいずれかを使用してフィードを取得します。
フィード ファイル形式の要件
フィード ファイルの要件は次のとおりです。
- フィード ファイルのファイル名拡張子は
.json
でなければなりません。 - フィード ファイルは暗号化しません。
フィード ファイルを UTF-8 でエンコードします(ファイル エディタの設定を確認してください)。
フィード ファイルが(未圧縮で)1 GB より大きい場合は、ファイルを複数のファイルに分割します。
エンティティ タイプ(
tvseries.json
、tvseasons.json
、tvepisodes.json
、movies.json
など)ごとにファイルを作成することをおすすめします。- これらのファイルのいずれかが 1 GB を超える場合は、エンティティを複数のファイルに分割します。
ファイル(
tvepisodes_01.json
、tvepisodes_02.json
など)。 - ファイルサイズが 1 GB 未満である限り、1 つのファイルに含めることができるエンティティの数に制限はありません。
- これらのファイルのいずれかが 1 GB を超える場合は、エンティティを複数のファイルに分割します。
ファイル(
JSON 仕様に従い、ファイルが BOM なしでエンコードされていることを確認します。Linux OS で確認するには、アドレス 0x00 で
hexdump file.json | head -n 1
をBBEF
で始めることはできません。
フィードのタイプ
本番環境フィード
- カタログ全体を表す JSON フィード ファイルのセットで、 選択しますフィードの作成方法については、以下のセクションをご覧ください。
- 初めて Google と統合する場合は、このフィードのみが必要です。
- このフィードを Google に送信すると、広範囲にわたって分析され、いくつかの キャプチャする情報量とそれに基づいて 正確性を維持することが目的です。
ステージング フィード
- 特定のユースケースでは、本番環境フィードの拡張が必要になる場合があります。例
次のようなシナリオがあります
<ph type="x-smartling-placeholder">
- </ph>
- まだリリースされていない新しいエンティティ タイプを含むようにフィードを拡張。
- フィードを拡張し、膨大な数の新しいエンティティ/メタデータを あります。
- 新しいプラットフォーム タイプへのフィードの展開。たとえば、本番環境のフィードが リリースを Google 検索でリリースしてから、Google TV にも展開したい。
- このような場合は、ステージング フィードが必要です。このフィードは本番環境フィードのコピーです。ただし、 追加のメタデータ(新しいプラットフォーム用のディープリンク、新しい言語 / 地域用のメタデータなど)がある といった具合です
- 本番フィードと同様に、広範囲にわたって分析され、数回反復処理が行われます。 キャプチャされる情報の量とその正確性に関して、より高い品質基準を達成する。 品質基準を満たすと、このフィードが現在の製品版フィードに置き換わり、 作成します。
- このフィードを使用すると、初回リリースと追加リリースを区別し、すべての 本番環境のフィードに影響を与えることなく、必要なテストを行うことができます。これによって終了までのプロセスが 中断されることがありません 向上させることができます
上記についてご不明な点がある場合は、Google の担当者にご相談ください。
フィード ファイルを作成する
フィードを作成する際のベスト プラクティスは次のとおりです。
-
カタログ内のすべてのコンテンツを含むフィードを作成する前に、 エンティティの一部のみを含むサンプル フィードです。フィードの作業中に、次の問題に遭遇することが多くあります。 サポートします。エンティティ セットのサイズを制限することで、これらのエラーをデバッグし、 警告が簡単になります。
-
Google では、フィードが仕様に準拠していることを確認するツールを提供しています。おすすめの方法 これらのツールを使用して、サンプル フィードで見つかったすべてのエラーと警告を解決します。
-
少数のエンティティに対して適切な構造になっていることを確認したら、カタログ全体のフィードを作成します。
サンプル フィードを作成する
- カタログから代表的なエンティティを 1 つ選択します。比較的複雑な構造であるものの、カタログ内のエンティティとしては一般的であるエンティティを選択します。
- データフィード検証ツールを使用して、構文エラーや必須プロパティの欠落がないか確認します。(詳しくは次のセクションをご覧ください)。
単一の
Movie
エンティティを含むフィードの例{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": ["http://schema.org", {"@language": "en"}], "@type": "Movie", "@id": "http://www.example.com/my_favorite_movie", "url": "http://www.example.com/my_favorite_movie", "name": "My Favorite Movie", "potentialAction": { "@type": "WatchAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
サンプル フィードを検証する
Google の構造化データを使用したサンプル フィードの検証には、以下のツールをご利用いただけます。 仕様。
データフィード検証ツール
データフィード検証ツールは、一度に 1 つのエンティティを検証できます。サンプルの検証にこのツールを使用する 構造エラーや一般的なコンテンツ エラーがないか確認できます。詳しくは、 このツールについて詳しくは、こちらをご覧ください。
JSON スキーマ検証ツール
JSON スキーマ検証ツールは、フィード内のすべてのファイルを検証できます。このツールは、 フィードの開発に集中できます。詳しくは、 こちらをご覧ください。
本番フィードを作成する
- サンプル フィードのエラーと警告をすべて解決したら、フィードを展開してすべてのエラーと警告を含めます。 カタログ内のエンティティです
- データフィード検証ツールを使用します。 フィード内の少数のエンティティを一度に検証する(多数のエンティティを ツール上のエンティティによって、ウェブブラウザがフリーズすることがあります)。フィードにすべてのエンティティが含まれていることを確認する フィード内のエンティティ数をカタログ内の商品アイテム数と比較し、 カタログです