このページは Cloud Translation API によって翻訳されました。

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

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

ディープリンク

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

urlTemplate（ターゲットオブジェクト）にはディープリンクが必要です。
ディープリンクは、指定されたすべてのプラットフォームで対象のコンテンツを開く必要があります。
ディープリンクには、パラメータ（&）またはアンカータグ（#）を含めることができます。 <ph type="x-smartling-placeholder">
- 自動再生がデフォルトで有効になっていない場合は、&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",
       ...
     },
   ...
   },
   ...
}

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

次の擬似コードは、ユーザーが開始したときの動作を表しています。 play:

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 に含める必要があります。これによりアプリがインストールされていない場合に、ユーザーが 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 Dynamic Links を使用しますスマートリンクプラットフォームです

アプリがインストールされておらず、ウェブプレーヤーを持っている場合は、 Android または App Store へのリンクやスマートバナーをインストールできます。スマートバナーの実装例を次に示します。

スマートバナーの実装例

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

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

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

プラットフォーム型

Google の複数のプラットフォーム（検索、アシスタント、Android TV、Chromecast）でコンテンツを確実に利用できるようにするには、次の要件に従ってください。

パートナーがサポートするすべてのプラットフォームで、コンテンツへのディープリンクが必要です。
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 デバイスのキャストと Google Home プラットフォーム。
`http://schema.googleapis.com/GoogleAudioCast`	リッスンアクション専用。Chromecast デバイスのキャストと Google 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 がユーザーをアプリやプラットフォームに誘導する際に、選択したコンテンツを自動再生します。これによりユーザーはコンテンツを視聴します

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

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

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

ログインや購入の動作: サービスでログインや購入が映画またはエピソードが、説明します。詳しくは、このモジュールのできます。
再生: サービスがユーザーの状態を追跡している場合、再生はユーザーが映画またはエピソード上で前に移動したマーカー。それ以外の場合は、再生をコンテンツの先頭から始まります。
自動再生: プラットフォームによっては、対象のエピソードや映画をユーザーが選択した後に、サービスでコンテンツを目立つように再生する必要があります。
- 検索: 自動再生を強くおすすめしますが、必須ではありません。自動再生がサポートされていない場合は、ユーザーがアプリまたはサービスに移動した後、1 回のクリックでコンテンツが再生される必要があります。
- Android TV: 映画とエピソードでは自動再生が必要です。

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

対象とするエピソードの選択: 対象とするエピソードを適切に選択する必要があります。条件サービスがユーザーの状態を追跡する場合、対象となるエピソードはユーザーが最後に視聴を停止した動画。ユーザーが購入手続きを最後までターゲットエピソードを次のエピソードにするエピソードをご覧ください。それ以外の場合、対象のエピソードは次のいずれかにする必要があります。以下を行います。

TVSeries
- シリーズの最初のエピソード。シリーズ番組におすすめです。
- 最新シーズンの最初のエピソード。推奨する用途シリーズ化した作品です
- 最新エピソード。日替わり番組やニュース関連の番組におすすめです。
TVSeason
- シーズンの最初のエピソード。シリーズ番組におすすめです。
- 最新エピソード。日替わり番組やニュース関連の番組におすすめです。

TVSeries または TVSeason のディープリンクは静的（不変）である必要があります該当するエピソードに解決しますディープリンクを表示されます。

次の表に、必要な TVSeries、TVSeason、および TVEpisode エンティティタイプ:

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

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

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

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

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

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

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

次のようにします。

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

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

メタデータの収集

アクセス要件の特定