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

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

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

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

プロパティ	タイプ	説明
`@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 です。複数の動画形式は、配列を使用して指定します。 additionalProperty の例をご覧ください。
`actionAccessibilityRequirement`	ActionAccessSpecification	必須 - コンテンツのアクセス要件を説明するアクションアクセス指定オブジェクト。アクションアクセス指定プロパティをご覧ください。

アクションマークアップ関連ページ

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

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

プロパティ	タイプ	説明
`actionAccessibilityRequirement.@type`	テキスト	必須 - 常に `ActionAccessSpecification` に設定します。
`actionAccessibilityRequirement.category`	テキスト	必須 - コンテンツのアクセス要件。詳細については、ペイウォールのタイプをご覧ください。一群のコンテンツを表すエンティティの場合は、最も制限の緩やかなコンテンツアクセス要件を `category` に設定する必要があります。たとえば、`TVSeries` に `TVEpisode` コンテンツがいくつかあり、そのうちの一部が `nologinrequired` に設定され、一部が `subscription` に設定されている場合は、この `TVSeries` を `nologinrequired` に設定します。
`actionAccessibilityRequirement.availabilityStarts`	日付	必須 - アクションが使用可能となる日付を ISO 8601 形式（タイムゾーンを含む）で指定します。将来の日付も設定できます。対応するエンティティは、availabilityStarts 日の少なくとも 7 日前までにフィードで指定する必要があります。これにより、コンテンツが Google サーフェスに時間どおりに表示される可能性が高まります。
`actionAccessibilityRequirement.availabilityEnds`	日付	必須 - アクションが使用できなくなる日付を ISO 8601 形式（タイムゾーンを含む）で指定します。 `availabilityStarts` の 72 時間以上後の日付を指定します。公開後のコンテンツが常時利用可能である場合は、現在の日付から 20 年後の日付を設定します。在庫終了日の更新は、在庫終了日の 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.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` の場合に必須 - メディアカタログ内のコンテンツグループへのアクセス権を表す、この定期購入の一意の文字列。識別子には、ドメイン名 + コロン（:）+ コンテンツへのアクセスレベルの構文を使用することをおすすめします。例: example.com:basic、example.com:premium、example.com:sports Entitlement API を指定している場合、このプロパティは利用資格 ID と同じになります。
`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 が必要です。サブスクリプションが 1 つの階層で、カタログ内のすべてのコンテンツにアクセスできる場合は、この項目を含めないでください。

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

メディアの有料会員登録に関するページ

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

特典のプロパティ

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

特典に関するページ

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

識別子

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

ID プロパティ

プロパティ	タイプ	説明
`identifier`	テキスト	強く推奨 - 特定のエンティティを一意に識別する識別子（通常は外部 ID）。複数の識別子を使用できます。このプロパティは、すべての Watch Action エンティティタイプで使用できます。次の表に、使用可能な識別子と `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 スポーツ 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）ID は、映画やテレビの作品を最も一般的な抽象レベルで表します。このプロパティは、TVSeries、TVSeason、TVEpisode、Movie エンティティの仕様ページで使用できます。たとえば、「Ghostbusters」という映画の titleEIDR は「10.5240/7EC7-228A-510A-053E-CBB8-J」です。ウォッチアクションフィードの例のセクションの識別子/EIDR の例をご覧ください。
`editEIDR`	テキスト	強く推奨 - EIDR（Entertainment Identifier Registry）ID は、映画やテレビ作品の特定の編集/エディションを表します。このプロパティは、TVEpisode エンティティと Movie エンティティの仕様ページで使用できます。たとえば、「Ghostbusters」という映画のタイトル 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` が指定されている場合に必須です。 [Watch Actions] フィード例のセクションの識別子/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/ロシア
アルバ（AW）	利用不可	利用不可
オーストラリア（AU）	ACB TV	ACB Movies
オーストリア（AT）	FSK	FSK
アゼルバイジャン（AZ）	利用不可	MKRF/ロシア
バーレーン（BH）	利用不可	MPAA
ベラルーシ（BY）	利用不可	MKRF/ロシア
ベルギー（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/ロシア
ラオス（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/ロシア	MKRF/ロシア
ルワンダ（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/ロシア
タンザニア（TZ）	利用不可	MPAA
タイ（TH）	利用不可	BFVC
トーゴ（TG）	利用不可	CNC
トリニダードトバゴ（TT）	利用不可	利用不可
トルコ（TR）	RTÜK	ECBMCT
トルクメニスタン（TM）	利用不可	MKRF/ロシア
ウガンダ（UG）	利用不可	MPAA
ウクライナ（UA）	利用不可	利用不可
アラブ首長国連邦（AE）	利用不可	MPAA
英国（GB）	BBFC	BBFC
米国（US）	TV_PG	MPAA
ウルグアイ（UY）	利用不可	MPAA
ウズベキスタン（UZ）	利用不可	MKRF/ロシア
ベネズエラ（VE）	利用不可	RESORTEVIOLENCIA
ベトナム（VN）	利用不可	MCST
ザンビア（ZM）	利用不可	MPAA
ジンバブエ（ZW）	利用不可	MPAA

GeoShape プロパティ

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

郵便番号のリスト（米国、カナダ、その他の郵便番号など）
カナダの配送センターのリスト
指定マーケットエリア（DMA）ID - 全員が同じテレビチャンネルや番組を受信する米国内地域の識別子

プロパティ	タイプ	説明
`@id`	URL	必須 - 地域の識別子（URI 形式）。
`@type`	テキスト	必須 - 常に `GeoShape` に設定します。
`addressCountry`	テキスト	必須 - 2 文字の ISO 3166-1 alpha-2 国コード。
`postalCode`	テキスト	省略可 - 1 つ以上の郵便番号または FSA（郵便処理地域）コードのリスト。
`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（郵便番号の配送地域）と郵便番号の組み合わせを含む 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"
    }
  ]
}

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

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

アクション マークアップ関連ページ

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