ウォッチ アクションの一般的なプロパティ

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

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

プロパティ タイプ 説明
@type テキスト 必須 - 常に WatchAction に設定します。
target EntryPoint 必須 - ディープリンクをさまざまな Google プラットフォームにマッピングするためのターゲット オブジェクト。
target.@type テキスト 必須 - 常に EntryPoint に設定します。
target.urlTemplate URL 必須 - アプリやプラットフォームにユーザーを誘導し、コンテンツの再生を開始するためのディープリンク。
target.inLanguage テキスト 省略可 - シリーズの元の言語（BCP 47 形式）。
target.actionPlatform テキスト 必須 - urlTemplate にマッピングされるプラットフォーム。メディア アクションでは以下がサポートされます。
  • 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 プラットフォーム。
要件については、プラットフォーム タイプをご覧ください。
target.additionalProperty PropertyValue 必須（該当する場合）- ディープリンクの追加プロパティを表す、プロパティと値のペアの一覧。これには、次のものが含まれます。
  • contentLanguage: BCP 47 形式のブロードキャスト言語（吹替）。コンテンツが別の言語で吹き替えられている場合は、このプロパティは必須です。複数の言語コードは、配列を使用して指定します。
  • subtitleLanguage: 字幕の言語（BCP 47 形式）。複数の言語コードは、配列を使用して指定します。
  • cameraAngle: コンテンツのカメラ角度（「目の高さ」や「高角度」など）。複数のカメラ角度で使用可能なコンテンツの場合は、このプロパティは必須です。複数のカメラ角度は、配列を使用して指定します。
  • videoFormat: デジタル動画データを保存するためのファイル形式（標準画質の場合は「SD」、高解像度の場合は「HD」など）。有効な動画形式は、SD、HD、2K、4K、8K です。複数の動画形式は、配列を使用して指定します。
  • audioDescriptionLanguage: 音声解説をサポートする、サポートされている音声言語の配列（BCP 47 形式）。これは contentLanguage 配列のサブセットです。
additionalProperty の例をご覧ください。
actionAccessibilityRequirement ActionAccessSpecification 必須 - コンテンツのアクセス要件を説明するアクション アクセス指定オブジェクト。アクション アクセス指定オブジェクトをご覧ください。

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

アクション アクセス指定プロパティ

プロパティ タイプ 説明
actionAccessibilityRequirement.@type テキスト 必須 - 常に ActionAccessSpecification に設定します。
actionAccessibilityRequirement.category テキスト

必須 - コンテンツのアクセス要件。詳しくは、ペイウォール タイプをご覧ください。

一群のコンテンツを表すエンティティの場合は、最も制限の緩やかなコンテンツ アクセス要件を category に設定する必要があります。たとえば、TVSeries に nologinrequired に設定された TVEpisode コンテンツと subscription に設定されたコンテンツが混在している場合、この TVSeries は nologinrequired に設定します。
actionAccessibilityRequirement.availabilityStarts 日付

必須 - アクションが使用可能となる日付を ISO 8601 形式（タイムゾーンを含む）で指定します。

  • 将来の日付も設定できます。

対応するエンティティは、availabilityStarts の日付の 7 日前までにフィードで提供する必要があります。これにより、コンテンツが Google サービスに予定どおりに表示される可能性が高まります。
actionAccessibilityRequirement.availabilityEnds 日付 必須 - アクションが使用できなくなる日付を ISO 8601 形式（タイムゾーンを含む）で指定します。
  • availabilityStarts の 72 時間以上後の日付を指定します。
  • 公開後のコンテンツが常時利用可能である場合は、現在の日付から 20 年後の日付を設定します。

availabilityEnds の日付を更新する場合は、availabilityEnds の日付の少なくとも 7 日前までにフィードで行う必要があります。これにより、availabilityEnds の日付に Google サーフェスでコンテンツが表示されなくなる可能性が高まります。
actionAccessibilityRequirement.eligibleRegion Country、City、State、GeoShape、または Text 必須 - コンテンツが利用可能な地域。グローバルに利用可能なコンテンツの場合は、特殊文字列 EARTH を使用します。
actionAccessibilityRequirement.ineligibleRegion Country、City、State、または GeoShape 必須（該当する場合） - コンテンツが制限されている地域。eligibleRegion 内のどこでもコンテンツが利用可能である場合は、このプロパティは不要です。
actionAccessibilityRequirement.requiresSubscription MediaSubscription

該当する場合は必須 - コンテンツにアクセスするためにユーザーに必要となる有料会員登録の詳細。メディアの有料会員登録プロパティをご覧ください。

  • category が subscription または externalSubscription の場合、このプロパティを指定します。
actionAccessibilityRequirement.expectsAcceptanceOf 特典 コンテンツの購入が必要な場合は必須 - コンテンツに関連付けられた特典の詳細。以下の場合の価格情報を指定します。
  • コンテンツの 1 回だけの購入（rental または purchase）
  • 登録ユーザーは追加購入が必要となる、有料会員登録ベースのコンテンツ（subscription または externalsubscription）。
価格が 0.00 の場合は、Offer オブジェクトを完全に削除し、ActionAccessSpecification オブジェクトの category を free に設定します。特典のプロパティをご覧ください。
actionAccessibilityRequirement.additionalProperty PropertyValue 必須（該当する場合） - エクスペリエンスに表示される定期購入パッケージへの参照。
actionAccessibilityRequirement.additionalProperty.name テキスト 必須 - 常に "DisplaySubscriptionIdentifier" に設定します。
actionAccessibilityRequirement.additionalProperty.value テキスト 必須 - エンティティに表示される requiresSubscription.@id。

メディアの有料会員登録プロパティ

actionAccessibilityRequirement.category が subscription または externalSubscription の場合は必須です。

プロパティ タイプ 説明
requiresSubscription.@type テキスト 必須 - 常に MediaSubscription に設定します。
requiresSubscription.@id URL 必須 - 有料会員登録の一意の ID。異なる複数の有料会員登録からアクセス可能なコンテンツの場合は、個々の有料会員登録に一意の ID が必要です。
requiresSubscription.name テキスト 必須 - 有料会員登録の名前。次の点に注意してください。
  • 異なる複数の有料会員登録からアクセス可能なコンテンツの場合は、この名前がユーザー認証システムで使用されている名前と一致する必要があります。たとえば、ユーザーは「Package 1」という名前の有料会員登録に基づいてコンテンツにアクセスできますが、認証システムでは「PKG1a」という名前が使用されている場合は、「PKG1」を使用します。
  • TVE プロバイダであれば、これは TVE 認証システムに登録された認証システム名となります。TVE 認証システムに対してサービス名を一意に識別する文字列です。
  • 定期購入に複数の名前がある場合は、値の配列として指定してください。複数の翻訳を含む名前の配列を追加する方法については、次の例をご覧ください。
requiresSubscription.sameAs URL 有料会員登録を説明するページ。
requiresSubscription.identifier テキスト category が subscription かつ commonTier が false の場合は必須 - メディア カタログにあるコンテンツ グループへのアクセス権を表す、この定期購入の一意の文字列。
  • Google では、識別子に次の構文を使用することをおすすめします。
    ドメイン名 + コロン（:）+ コンテンツへのアクセスレベル。例: example.com:basic、example.com:premium、example.com:sports
  • 利用資格 API を提供している場合、このプロパティは利用資格識別子と同じになります。
requiresSubscription.authenticator 組織 category が externalsubscription の場合は必須 - 外部プロバイダの認証システムの詳細を提供するコンテナ。
requiresSubscription.authenticator.@type テキスト category が externalsubscription の場合は必須 - 常に Organization に設定します。
requiresSubscription.authenticator.name テキスト category が externalsubscription の場合は必須 - 認証サービスの名前。TVE プロバイダの場合は「TVE」に設定します。
requiresSubscription.commonTier ブール値 必須（該当する場合） - カテゴリが定期購入に設定されている場合は必須です。commonTier の詳細については、共通階層の要件のドキュメントをご覧ください。

Entitlement API の要件

actionAccessibilityRequirement.category が subscription または externalSubscription で、サブスクリプション オファーに複数のパッケージまたはティアが含まれているか、アドオンのサポートがある場合は、利用資格 API が必要です。サブスクリプションが階層化されており、カタログ内のすべてのコンテンツにアクセスできる場合は、この項目を含めないでください。

  • 会社 A は、登録ユーザーが利用可能なすべてのコンテンツにアクセスできる単一のサブスクリプションを提供しています。利用資格識別子 / API は不要です。
  • 会社 B には、一部のコンテンツへのアクセスを提供する基本サブスクリプションと、プレミアム コンテンツへのアクセスを提供するプレミアム サブスクリプションがあります。 利用資格 ID / API が必要
  • 会社 C は、一部のコンテンツへのアクセスを提供する基本サブスクリプションと、サードパーティ コンテンツへのアクセスを提供するアドオン パッケージを提供しています。 利用資格 ID / API が必要

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

特典のプロパティ

プロパティ タイプ 説明
expectsAcceptanceOf.@type テキスト 必須 - 常に Offer に設定します。
expectsAcceptanceOf.price 数値 必須 - コンテンツの購入価格。価格は 0 以外の正の値にする必要があります。価格が 0.00 のエンティティについては、カテゴリを「free」として指定してください。
expectsAcceptanceOf.priceCurrency テキスト 必須 - 価格の通貨（3 文字の ISO 4217 形式）。
expectsAcceptanceOf.seller 組織 コンテンツの購入を提供する組織。
expectsAcceptanceOf.seller.@type テキスト 常に Organization に設定します。
expectsAcceptanceOf.seller.name テキスト 販売者の名前。
expectsAcceptanceOf.seller.sameAs テキスト 販売者を識別するウェブページの URL（販売者のホームページなど）。

特典に関するページ

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

識別子

メディア アクション フィードでは、エンティティを明確に識別するのに役立つさまざまな ID を使用できます。これらの識別子は、フィード内のコンテンツと Google のデータベース内のコンテンツを照合するプロセスを迅速化するのに役立ちます。これらの識別子のほとんどは、さまざまなエンティティ タイプの identifier プロパティを使用してフィードに追加できますが、EIDR には独自の代表プロパティがあります。これらについては、以下で説明します。

ID プロパティ

プロパティ タイプ 説明
identifier テキスト 強く推奨 - 特定のエンティティを明確に識別する識別子（通常は外部識別子）。複数の識別子を使用できます。

このプロパティは、すべてのウォッチ アクション エンティティ タイプで使用できます。

次の表に、identifier プロパティで使用できる識別子とサブプロパティを示します。ウォッチ アクション フィードの例の識別子/EIDR の例をご覧ください。
プロパティ タイプ 説明
@type テキスト 必須 - 常に PropertyValue に設定します。
propertyID テキスト 必須 - 以下の ID タイプがサポートされます。
  • TMS_ROOT_ID: Gracenote（TMS）のルート ID（15829 など）。
    • 。これは、TMS_ID のみを使用する必要がある Organization エンティティと BroadcastService エンティティには適用されません。
  • TMS_ID: Gracenote（TMS）のバリアント ID（MV000398520000 など）。
  • WIKIDATA_ID: WikiData ID（Q134773 など）。
  • IMDB_ID: IMDB ID（tt0109830 など）。
  • OPTA_ID: OPTA Sports ID。
  • STATS_ID: STATS Perform ID。
  • VIP_TIMES_ID: 日本のタレントの Japan VIPTimes（日本タレント名鑑）ID。
  • DMA_ID: GeoShape オブジェクトで使用される米国の指定マーケティング エリア コード。
  • _PARTNER_ID_: このプロパティには文字列「_PARTNER_ID_」が含まれている必要があります。値は、サービス プロバイダが内部または外部でエンティティを識別するために使用する一意の ID である必要があります（例: 12345、a5c604e2-e9e5-4ff3-b728-245799dc37f1）。
value テキスト 必須 - 指定した ID システムの値。

EIDR プロパティ

EIDR（Entertainment Identifier Registry の略）は、映画やテレビ番組など、幅広いメディア コンテンツのグローバルに一意な識別子システムです。識別システムは、識別子をトップレベルのタイトルや編集などに関連付けられたメタデータ レコードに解決します。次の表に、EIDR に関連付けられたプロパティとその使用方法を示します。

プロパティ タイプ 説明
titleEIDR テキスト 強く推奨 - EIDR（Entertainment Identifier Registry）識別子は、最も一般的な抽象レベルで映画またはテレビの作品を表します。

このプロパティは、TVSeries、TVSeason、TVEpisode、Movie のエンティティ仕様ページで利用できます。

たとえば、「ゴーストバスターズ」という映画の titleEIDR は「10.5240/7EC7-228A-510A-053E-CBB8-J」です。

ウォッチ アクション フィードの例のセクションの識別子/EIDR の例をご覧ください。
editEIDR テキスト 強く推奨 - EIDR（Entertainment Identifier Registry）識別子は、映画やテレビ番組の特定の編集/エディションを表します。

このプロパティは、TVEpisode と Movie のエンティティ仕様ページで利用できます。

たとえば、タイトル EIDR が「10.5240/7EC7-228A-510A-053E-CBB8-J」の「ゴーストバスターズ」という映画には、「10.5240/1F2A-E1C5-680A-14C6-E76B-I」や「10.5240/8A35-3BEE-6497-5D12-9E4F-3」などの複数の編集版があります。

titleEIDR プロパティは、editEIDR が指定されている場合は必須です。

「視聴アクション フィードの例」セクションの識別子/EIDR の例をご覧ください。

コンテンツのレーティング機関

この表の値は、BroadcastService.contentRating、Movie.contentRating、TVSeries.contentRating に使用します。レーティング機関はレーティング値の前に付加する必要があります。例:

  • 米国で「R」レーティングの映画の場合、Movie.contentRating の値は「MPAA R」となります。
  • 米国で「TV-MA」と評価されたテレビシリーズの TVSeries.contentRating 値は「TV_PG TV-MA」にする必要があります。

国 テレビ レーティング機関 映画のレーティング機関
アルバニア（AL） 利用不可 利用不可
アンゴラ（AO） 利用不可 CCE
アンティグア バーブーダ（AG） 利用不可 MPAA
アルゼンチン（AR） INCAA INCAA
アルメニア（AM） 利用不可 MKRF/RUSSIA
アルバ（AW） 利用不可 利用不可
オーストラリア（AU） ACB TV ACB Movies
オーストリア（AT） FSK FSK
アゼルバイジャン（AZ） 利用不可 MKRF/RUSSIA
バーレーン（BH） 利用不可 MPAA
ベラルーシ（BY） 利用不可 MKRF/RUSSIA
ベルギー（BE） 利用不可 MPAA
ベリーズ（BZ） 利用不可 利用不可
ベナン（BJ） 利用不可 CNC
ボリビア（BO） 利用不可 MPAA
ボスニア ヘルツェゴビナ（BA） 利用不可 MPAA
ボツワナ（BW） 利用不可 MPAA
ブラジル（BR） CLASSIND CLASSIND
ブルキナファソ（BF） 利用不可 CNC
カンボジア（KH） 利用不可 利用不可
カナダ（CA） CA_TV CHVRS
カーボベルデ（CV） 利用不可 CCE
チリ（CL） 利用不可 MPAA
コロンビア（CO） 利用不可 MPAA
コスタリカ（CR） 利用不可 MPAA
クロアチア（HR） 利用不可 利用不可
キプロス（CY） 利用不可 GRFILM
チェコ（CZ） 利用不可 CZFILM
デンマーク（DK） 利用不可 MCCYP
エクアドル（EC） 利用不可 MPAA
エジプト（EG） 利用不可 MPAA
エルサルバドル（SV） 利用不可 MPAA
エストニア（EE） 利用不可 EEFILM
フィジー（FJ） 利用不可 利用不可
フィンランド（FI） 利用不可 MEKU
フランス（FR） CSA CSA
ガボン（GA） 利用不可 CNC
ドイツ（DE） FSK FSK
ギリシャ（GR） ESR GRFILM
グアテマラ（GT） 利用不可 MPAA
ハイチ（HT） 利用不可 利用不可
ホンジュラス（HN） 利用不可 MPAA
香港（HK） CA FCO
ハンガリー（HU） 利用不可 MPAA
アイスランド（IS） 利用不可 KIJKWIJZER
インド（IN） CBFC CBFC
インドネシア（ID） KPI LSF
アイルランド（IE） 利用不可 IFCO
イタリア（IT） AGCOM AGCOM
コートジボワール（CI） 利用不可 CNC
ジャマイカ（JM） 利用不可 MPAA
日本（JP） なし EIRIN
ヨルダン（JO） 利用不可 MPAA
カザフスタン（KZ） 利用不可 MRKF
韓国（KR） KMRB KMRB
クウェート（KW） 利用不可 MPAA
キルギス（KG） 利用不可 MKRF/RUSSIA
ラオス（LA） 利用不可 利用不可
ラトビア（LV） 利用不可 NKCLV
レバノン（LB） 利用不可 MPAA
リトアニア（LT） 利用不可 利用不可
ルクセンブルク（LU） 利用不可 KIJKWIJZER
マケドニア（MK） 利用不可 MPAA
マレーシア（MY） 利用不可 FCBM
マリ（ML） 利用不可 CNC
マルタ（MT） 利用不可 MCCAA
モーリシャス（MU） 利用不可 BBFC
メキシコ（MX） RTC RTC
モルドバ（MD） 利用不可 利用不可
ナミビア（NA） 利用不可 利用不可
ネパール（NP） 利用不可 MPAA
オランダ（NL） KIJKWIJZER KIJKWIJZER
ニュージーランド（NZ） BSA OFLC
ニカラグア（NI） 利用不可 MPAA
ニジェール（NE） 利用不可 CNC
ノルウェー（NO） 利用不可 MEDIETILSYNET
オマーン（OM） 利用不可 MPAA
パナマ（PA） 利用不可 MPAA
パプアニューギニア（PG） 利用不可 MPAA
パラグアイ（PY） 利用不可 MPAA
ペルー（PE） 利用不可 MPAA
フィリピン（PH） MTRCB MTRCB
ポーランド（PL） 利用不可 MPAA
ポルトガル（PT） 利用不可 CCE
カタール（QA） 利用不可 MPAA
ロシア（RU） MKRF/RUSSIA MKRF/RUSSIA
ルワンダ（RW） 利用不可 CNC
サウジアラビア（SA） 利用不可 MPAA
セネガル（SN） 利用不可 MPAA
シンガポール（SG） 利用不可 MDA
スロバキア（SK） 利用不可 MPAA
スロベニア（SI） 利用不可 MPAA
南アフリカ（ZA） FPB FPB
スペイン（ES） SETSI ICAA
スリランカ（LK） 利用不可 利用不可
スウェーデン（SE） 利用不可 SMSA
スイス（CH） FSK FSK
台湾（TW） 利用不可 MOCTW
タジキスタン（TJ） 利用不可 MKRF/RUSSIA
タンザニア（TZ） 利用不可 MPAA
タイ（TH） 利用不可 BFVC
トーゴ（TG） 利用不可 CNC
トリニダード トバゴ（TT） 利用不可 利用不可
トルコ（TR） RTÜK ECBMCT
トルクメニスタン（TM） 利用不可 MKRF/RUSSIA
ウガンダ（UG） 利用不可 MPAA
ウクライナ（UA） 利用不可 利用不可
アラブ首長国連邦（AE） 利用不可 MPAA
英国（GB） BBFC BBFC
米国（US） TV_PG MPAA
ウルグアイ（UY） 利用不可 MPAA
ウズベキスタン（UZ） 利用不可 MKRF/RUSSIA
ベネズエラ（VE） 利用不可 RESORTEVIOLENCIA
ベトナム（VN） 利用不可 MCST
ザンビア（ZM） 利用不可 MPAA
ジンバブエ（ZW） 利用不可 MPAA

GeoShape プロパティ

GeoShape オブジェクトには、以下のいずれかの種類のデータが含まれます。

プロパティ タイプ 説明
@id URL 必須 - URI 形式の地域識別子。
@type テキスト 必須 - 常に GeoShape に設定します。
addressCountry テキスト 必須 - 2 文字の ISO 3166-1 alpha-2 国コード。
postalCode テキスト 省略可 - 1 つ以上の郵便番号または FSA（Forward Sortation Area）コードのリスト。
identifier PropertyValue 省略可 - 指定マーケット エリア（DMA）ID。全員が同じテレビ チャンネルや番組を受信する米国内地域の識別子です。
identifier.@type テキスト 必須 - 常に PropertyValue に設定します。
identifier.propertyID テキスト 必須 - 常に DMA_ID に設定します。
identifier.value テキスト 必須 - 地域の DMA コード。

郵便番号のリストを含む GeoShape オブジェクトの例を以下に示します。

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

FSA（Forward Sortation Area）と郵便番号の組み合わせを含む GeoShape オブジェクトの例:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

DMA ID を含む GeoShape オブジェクトの例:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}