メタデータの要件
Apple TVアプリは、サブスクリプションビデオサービス、Apple TV+、MLS Season Pass、チャンネルサブスクリプション、および購入済みのビデオコンテンツを1つにまとめたアプリケーションです。複数のソースから取得したデータを使用しながら1つの正規ページを作成するため、ユーザはコンテンツが利用できる場所であれば統一された表示を確認することができます。コンテンツにメタデータを提供いただくことで、この正規ページを正しく作成することができます。なお、メタデータは同じコンテンツに対して複数のパートナーから提供される可能性があるため、Apple TVアプリにおけるコンテンツの表示が、指定したものと異なる場合があります。
コンテンツのApple TVアプリにおける表示に関するメタデータの必須項目と許容内容については、「UMCカタログおよびアベイラビリティデータインターフェイス仕様」に詳述されています。コンテンツの内容に関するメタデータの提供はカタログフィードを、コンテンツが利用可能な時期や場所に関するメタデータの提供はアベイラビリティフィードを使用してください。
各コンテンツアイテムには、コンテンツIDと呼ばれる一意の識別子を付与し、カタログフィードとアベイラビリティフィードの両方と一致していることを確認してください。コンテンツIDは、ビデオアプリ統合パートナーの統合APIまたはチャンネルパートナーのアセットを介してパートナーアプリによって提供された識別子と一致している必要があります。
コンテンツIDの他に、コンテンツが同じメタデータを使用していながら、一部のストアフロントを対象とした別のビデオアセットがある場合、チャンネルパートナーはバリアントIDを提供してください。バリアントIDは、アベイラビリティの記録とアセットのデリバリ内容にのみ表示され、値はこれら2つのコンポーネントで一致する必要があります。コンテンツIDはアベイラビリティフィードに一度しか表示されませんが、バリアントIDは、1つのストアフロントに対し別個のアセットを使用した上で付与される点にご留意ください。1つのストアフロントで同じコンテンツIDに対して2つのバリアントIDを指定することはできません。
以下にあげるメタデータは、チャンネルパートナー・ビデオアプリ統合パートナーに関わらず、カタログフィードを介して提供してください。
- タイトル
- 説明
- ジャンル(対応ジャンル一覧)
- 年齢制限指定とアドバイザリ(対応指定一覧)
- キャストとスタッフ(クレジット)
- アートワーク
-
isOriginalの指定。オリジナルコンテンツの制作者がパートナーである、またはパートナー名義となるオリジナルコンテンツを他の制作者が制作したことを示す。
- 原語ロケール
- 製作国
- 制作国
- リリース日と放送日
- シーズン番号とエピソード番号(テレビ番組の場合)
- 著作権表示
国や地域別のメタデータ要件
コンテンツには、サービスを利用できる国や地域に基づいてローカライズされたメタデータも含める必要があります。ロケールを示す値は、BCP-47 形式で指定してください。サービスを利用可能にするストアフロントで使用するロケールの選択に関してご不明点がある場合は、Appleテクニカルパートナー担当者にお問い合わせください。
一部のメタデータの要素は、カタログフィードとアベイラビリティフィードのアイテムを取り込む際に必須となります。これらの要素と属性は、カタログ仕様で「必須」の表示があります。
サービスを利用可能にするストアフロントによっては、コンテンツの公開に関する地域のデータ要件が設けられている場合があります。たとえば、ブラジルや日本など一部の地域では、上記の要素をローカライズしたメタデータとして提出することが要件となります。
Appleビデオパートナープログラムに参加するチャネルパートナーおよびビデオアプリ統合パートナーについては、カタログフィードのデータ統合に関する要件の他に、追加のメタデータ要件があります。メタデータの必須要件一覧については、「UMCカタログのデータ要件」を参照してください。
注：仕様書およびデータ要件のドキュメントで一部の項目はオプションである記載がありますが、正規ページにおけるコンテンツのマッピング精度を高める目的で、追加のデータ提供をお願いする場合があります。