Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

コンテンツのプラットフォーム固有のディープリンクを識別する

ユーザーがコンテンツのメディアアクションをクリックすると（たとえば、Google 検索で該当するアイコンをクリックすると）、コンテンツのディープリンクに基づいてアプリまたはプラットフォームのコンテンツに直接誘導されます。

ディープリンク

ディープリンクの要件は次のとおりです。

urlTemplate（ターゲットオブジェクト）にはディープリンクが必要です。
ディープリンクは、指定されたすべてのプラットフォームで対象のコンテンツを開く必要があります。
ディープリンクには、パラメータ（&）またはアンカータグ（#）を含めることができます。
- 自動再生がデフォルトで有効になっていない場合は、&autoplay=true などのパラメータをディープリンクに追加して、アプリやプラットフォームで自動再生機能を有効にすることをおすすめします。

@id、url、urlTemplate の例:

{
   "@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",
       ...
     },
   ...
   },
   ...
}

ディープリンクを使用して再生を開始する

次の疑似コードは、ユーザーが再生を開始したときの望ましい動作を表しています。

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

望ましい再生動作を実現するには、次のプラットフォーム固有の要件に準拠してください。

iOS: ユニバーサルリンクを使用する必要があります。
Android と Android TV: Android アプリリンクまたはカスタムスキームリンクを使用できます。

Android と Android TV のカスタムスキームリンク

Android と Android TV では、カスタムスキームリンクも使用できます。アプリの package_id は、カスタムスキーム URI に含める必要があります。これにより、アプリがインストールされていない場合、ユーザーは Google Play ストアのアプリのページに移動します。そのため、メディアアクションで許容されるカスタムスキームの形式は、次の URI 形式のみです。

android-app://{package_id}/{scheme}/{path}

次に例を示します。

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

詳しくは、仕様の全文をご覧ください。

intent://{package_id}/{scheme}/{path}

次に例を示します。

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

次のような他の URI 形式は、メディアアクションのカスタムスキームリンクとして使用できません。

scheme://{path}: 次に例を示します。
mynetwork://play?series=20114&title=21141&media=e90c89fa4

ベストプラクティス

アプリがインストールされておらず、ウェブプレーヤーがない場合は、ユーザーを Android ストアまたは App Store に自動的にリダイレクトしてアプリをインストールするようにウェブサーバーを設定します。リダイレクトするには、Firebase ダイナミックリンクまたはサードパーティのスマートリンクプラットフォームを使用します。

アプリがインストールされておらず、ウェブプレーヤーがある場合は、ユーザーがアプリをインストールできるように、Android ストアまたは App Store へのリンクまたはスマートアプリバナーを提供します。以下は、実装されたスマートアプリバナーの例です。

実装されたスマートバナーの例

ディープリンクの要件と制限事項の概要

次の表に、iOS、Android、AndroidTV に関連するディープリンクの要件と制限事項を示します。

	iOS	Android と Android TV
http:// または https://	必須	モバイルウェブサイトが再生に対応している場合は推奨されます。
android-app:// または intent://	なし	モバイルウェブサイトが再生に対応していない場合に推奨されます。
foo://（任意の文字列）	許可されない	許可されない

プラットフォーム型

メディアアクションをサポートする複数の Google サーフェスでコンテンツを利用できるようにするには、次の要件を満たしてください。

パートナーがサポートするすべてのプラットフォームで、コンテンツのディープリンクが必要です。
Chromecast プラットフォームの場合は、最新の Cast Application Framework（CAF）Receiver SDK を使用してレシーバーを作成する必要があります。
モバイルプラットフォーム（Android と iOS）については、ディープリンクを使用して再生を開始するセクションの要件をご覧ください。

次の表に、メディアアクションをサポートしているプラットフォームの一覧を示します。

プラットフォーム	説明
`http://schema.org/DesktopWebPlatform`	パソコンのウェブブラウザでの検索プラットフォーム。
`http://schema.org/MobileWebPlatform`	モバイルウェブブラウザでの検索プラットフォーム。
`http://schema.org/AndroidPlatform`	Android アプリの検索と PlayGuide プラットフォーム。
`http://schema.org/AndroidTVPlatform`	Android TV アプリの Android TV プラットフォーム。
`http://schema.org/IOSPlatform`	iOS アプリの検索プラットフォーム。
`http://schema.googleapis.com/GoogleVideoCast`	Chromecast デバイスの Cast プラットフォームと Home プラットフォーム。
`http://schema.googleapis.com/GoogleAudioCast`	リッスンアクション専用。Chromecast デバイスの Cast プラットフォームと Home プラットフォーム。

2 つの異なるディープリンクを持つエンティティの例:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

再生動作

ほとんどのコンテンツでは、Google がユーザーをアプリやプラットフォームに誘導する際に、選択されたコンテンツを自動再生することが求められます。これにより、ユーザーはコンテンツの視聴をすばやく開始できます。

ウォッチアクションの再生動作

Watch Action では、次の再生動作が求められます。

すべてのディープリンク: Movie、TVEpisode、TVSeries、TVSeason

ログインまたは購入の動作: サービスでログインまたは購入が必要な場合、映画またはエピソードは、そのタイプに応じて、その後再生される必要があります。詳しくは、以下のディープリンクのガイドラインをご覧ください。
再生: サービスがユーザーの状態を追跡している場合、再生は映画またはエピソードのユーザーの以前のマーカーから開始する必要があります。それ以外の場合は、コンテンツの最初から再生を開始する必要があります。
自動再生: プラットフォームによっては、ユーザーが対象のエピソードまたは映画を選択した後、サービスでコンテンツを大きく再生することが求められます。
- 検索: 自動再生を強く推奨しますが、必須ではありません。自動再生がサポートされていない場合は、ユーザーがアプリまたはサービスに移動してから 1 回クリックすると、コンテンツが再生される必要があります。
- Android TV: 映画とエピソードの自動再生が必要です。

TVSeries と TVSeason のディープリンクのみ

対象エピソードの選択: 適切な対象エピソードを選択する必要があります。サービスがユーザーの状態を追跡している場合、ターゲットエピソードはユーザーが最後に視聴を停止したエピソードでなければなりません。または、ユーザーが最後に視聴したエピソードを完全に視聴し終わった場合は、代わりに次のエピソードをターゲットエピソードにします。それ以外の場合、対象のエピソードは次のいずれかである必要があります。

TVSeries
- シリーズの最初のエピソード。連続ドラマにおすすめです。
- 最新シーズンの最初のエピソード。長期にわたる連続ドラマにおすすめです。
- 最新のエピソード。毎日の番組やニュース関連の番組におすすめします。
TVSeason
- シーズンの最初のエピソード。連続ドラマにおすすめです。
- 最新のエピソード。毎日の番組やニュース関連の番組におすすめします。

TVSeries または TVSeason のディープリンクは静的（変更不可）で、ターゲットエピソードに解決される必要があります。特定のエピソードのディープリンクは使用しないでください。

次の表に、TVSeries、TVSeason、TVEpisode のエンティティタイプに必要なターゲットエピソード選択ロジックを示す例をいくつか示します。

	ユーザーが最後に S6E24 を視聴した場合、ターゲットエピソード	ユーザーがエピソードを視聴していない場合は、対象のエピソード
シリーズのディープリンク	S6E24（ユーザーが S6E24 を完了していない場合） S6E25（ユーザーが S6E24 の視聴を完了している場合）	次のいずれかになります。シリーズの最初のエピソード最新シーズンの最初のエピソード最新のエピソード
シーズンディープリンク（S1 ～ S5）	ユーザーがそのシーズンで最後に視聴したエピソード。または、そのシーズンでエピソードを視聴していない場合は、そのシーズンの最初のエピソード。	シーズンの最初のエピソード
シーズンディープリンク（S6）	S6E24（ユーザーが S6E24 を完了していない場合） S6E25（ユーザーが S6E24 の視聴を完了している場合）	次のいずれかになります。シーズンの最初のエピソード最新のエピソード
エピソードのディープリンク	クリックされた特定のエピソード。	クリックされた特定のエピソード。

リッスンアクションの再生動作

リッスンアクションでは、次の再生動作が必要です。

ユーザーがアプリやサービスに移動してから 1 回のクリックでコンテンツを再生できる必要があります。
アプリやプラットフォームでログインが必要な場合は、ログイン後すぐに、または 1 回のクリックでコンテンツを再生する必要があります。
アプリまたはプラットフォームでは、すべてのユーザーが特定の曲、アルバム、アーティスト、プレイリストを再生できる方法を少なくとも 1 つ提供する必要があります。
- 正確なコンテンツを再生できないユーザー（必要な定期購入をしていないなど）に対しては、アプリまたはプラットフォームにアクセスしたときに、正確なコンテンツを再生できるようにするためにユーザーが何をすべきかを説明する必要があります。

アプリまたはプラットフォームにおすすめのベストプラクティスは次のとおりです。

MusicGroup の場合、ユーザーがアーティストを選択するたびに、そのアーティストの別のコンテンツを再生します。
MusicAlbum の場合、アルバムに表示される順序でコンテンツを再生します。
MusicPlaylist の場合、ユーザーがプレイリストを選択するたびに、プレイリストから異なるコンテンツを再生します。

ディープリンクを識別する

次のようにします。

コンテンツごとに、そのディープリンクがプラットフォームによって異なるかどうかを確認します。
ディープリンクごとに、エントリポイント（ディープリンクで移動するアプリまたはプラットフォームのページ）について次の質問をします。
- エントリポイント（コンテンツではない）は複数の言語をサポートしているか？
- エントリポイントは複数の字幕言語をサポートしているか？
- エントリポイントは複数のカメラアングルをサポートしているか？
- エントリポイントは複数の動画形式をサポートしているか？

これらの質問のいずれかに対する回答が「はい」の場合、そのディープリンクの additionalProperty プロパティを指定する必要があります。additionalProperty の例をご覧ください。

メタデータの収集

アクセス要件の特定

コンテンツのプラットフォーム固有のディープリンクを識別する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。