リッスン アクションの共通プロパティ

このセクションでは、リッスン アクションの一般的なプロパティの詳細について説明します。

アクション マークアップのプロパティ

プロパティ タイプ 説明
potentialAction.@type テキスト 必須 - 常に ListenAction に設定します。
target EntryPoint 必須 - さまざまな Google プラットフォームへのディープリンクのマッピングを提供するターゲット オブジェクト。
target.@type テキスト 必須 - 常に EntryPoint に設定します。
target.urlTemplate URL 必須 - ユーザーをアプリまたはプラットフォームに誘導してコンテンツの再生を開始するためのディープリンク。
target.actionPlatform テキスト 必須 - マッピングされるプラットフォーム urlTemplate。メディア アクションは以下をサポートします。 <ph type="x-smartling-placeholder">
    </ph>
  • 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 デバイスのキャストとホーム プラットフォーム（リッスン アクションのみ）。
で確認できます。 要件については、プラットフォーム タイプ セクションをご覧ください。
expectsAcceptanceOf 特典 必須 - オファー オブジェクトのコンテナ。
expectsAcceptanceOf.@type テキスト 必須 - 常に Offer に設定します。
expectsAcceptanceOf.category テキスト 必須 - コンテンツのアクセス要件。次のいずれかを使用します。 <ph type="x-smartling-placeholder">
    </ph>
  • nologinrequired: 購入やログインを必要としないコンテンツです。
  • free: コンテンツを利用するには、ユーザーがログインする必要があります。有料の定期購入は必要ありません。
  • subscription: コンテンツを利用するには、ユーザーが有料会員登録してログインする必要があります。
expectsAcceptanceOf.availabilityStarts 日付 アクションが使用可能になる ISO 8601 形式（タイムゾーンを含む）の日付。将来の日付も指定できます。このプロパティを使用して、日付と時刻によりアクションの使用可能な期間を制限します。これが指定されていない場合、アクションは無期限で使用可能と見なされます。
expectsAcceptanceOf.availabilityEnds 日付 アクションが使用不可になる ISO 8601 形式（タイムゾーンを含む）の日付。このプロパティを使用して、日付と時刻によりアクションの使用可能な期間を制限します。これが指定されていない場合、アクションは無期限で使用可能と見なされます。
expectsAcceptanceOf.eligibleRegion 国 必須 - アクションが利用可能な国。
expectsAcceptanceOf.eligibleRegion.@type テキスト 必須 - 常に Country に設定します。
expectsAcceptanceOf.eligibleRegion.name テキスト 必須 - 特典が許可されている国。ISO 3166 形式で国を指定します。

これらのプロパティに関連するトピックについては、次のページをご覧ください。

画像マークアップのプロパティ

プロパティ タイプ 説明
image.@type ImageObject 必須 - 常に ImageObject に設定します。
contentUrl URL 必須 - 画像の URL。
dateModified 日付 画像が最後に変更された ISO 8601 形式（タイムゾーンを含む）の日付。
regionsAllowed Place メディアが許可されている国。ISO 3166 形式で国を指定します。
  • 指定しなかった場合、すべてのロケールで画像の表示が許可されていると見なされます。
  • 地域ごとに異なる画像を配信するには、複数の ImageObject を追加して、それぞれに国のグループおよび対応する画像 URL を指定します。

これらのプロパティに関連するトピックについては、次のページをご覧ください。