ウォッチ アクション&共通プロパティ

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

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

プロパティ タイプ 説明
@type テキスト 必須 - 常に WatchAction に設定されます。
target エントリ ポイント 必須 - ディープリンクをさまざまな 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 デバイスでのキャストとホーム プラットフォーム。
  • http://schema.googleapis.com/GoogleAudioCast: Chromecast デバイスのキャスト プラットフォームとホーム プラットフォーム(リッスン アクションのみ)。
要件については、プラットフォームの種類のセクションをご覧ください。
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 に設定されている場合は、この TVSeriesnologinrequired に設定します。

actionAccessibilityRequirement.availabilityStarts Date

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

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

対応するエンティティは、availabilityStarts の日付の少なくとも 7 日前にフィードで指定する必要があります。これにより、コンテンツが予定どおりに Google サービスに表示される可能性が高くなります。

actionAccessibilityRequirement.availabilityEnds Date 必須 - アクションが不要になった日付。ISO 8601 形式(タイムゾーンを含む)で指定します。
  • availabilityStarts から 72 時間以上経過している必要があります。
  • コンテンツを公開後にいつでも利用できるようにするには、この日付を現在の日付から 20 年後に設定します。

availabilityEnds の日付を変更する場合は、availabilityEnds の日付の 7 日前までにフィードに反映する必要があります。これにより、availabilityEnds 日に Google サービスにコンテンツが表示されなくなる可能性が高まります。

actionAccessibilityRequirement.eligibleRegion CountryCityStateGeoShape、または Text 必須 - コンテンツが利用可能な地域。コンテンツがグローバルに利用できる場合は、特殊な文字列 EARTH を使用します。
actionAccessibilityRequirement.ineligibleRegion CountryCityState、または GeoShape 該当する場合は必須 - コンテンツが制限されている地域。eligibleRegion のどこからでも利用できる場合は、このプロパティを指定する必要はありません。
actionAccessibilityRequirement.requiresSubscription MediaSubscription

該当する場合は必須 - ユーザーがコンテンツにアクセスするために必要な定期購入の詳細。メディア サブスクリプションのプロパティをご覧ください。

  • categorysubscription または externalSubscription の場合は、このプロパティを指定します。
actionAccessibilityRequirement.expectsAcceptanceOf 特典 コンテンツの購入が必須である場合に必須 - コンテンツに関連付けられている特典の詳細。以下の場合は、料金情報をお知らせください。
  • 1 回だけの購入コンテンツ(rental または purchase
  • 定期購入者ベース(subscriptionまたはexternalsubscription)からの追加購入が必要な定期購入ベースのコンテンツ
価格が 0.00 の場合は、Offer オブジェクトを完全に削除し、categoryActionAccessSpecification オブジェクトから free に設定します。特典のプロパティをご覧ください。

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

actionAccessibilityRequirement.categorysubscription または externalSubscription の場合は必須。

プロパティ タイプ 説明
requiresSubscription.@type テキスト 必須 - 常に MediaSubscription に設定
requiresSubscription.@id URL 必須 - 有料会員登録の一意の ID。異なる複数の定期購入を通じてコンテンツにアクセスできる場合、それぞれの定期購入は一意の ID を持つ必要があります。
requiresSubscription.name テキスト 必須 - 有料会員登録の名前。次の点にご注意ください。
  • 別のサブスクリプション経由でアクセスできるコンテンツの場合、この名前はユーザー認証システムの名前と一致する必要があります。たとえば、ユーザーがパッケージ 1 というサブスクリプションに基づいてコンテンツにアクセスできても、認証システムが PKG1a という名前を使用している場合は、PKG1 を使用します。
  • TVE プロバイダの場合、これは TVE 認証システムに登録されている認証システム名です。TVE 認証システムでサービス名を一意に識別する文字列です。
requiresSubscription.sameAs URL 有料会員登録を説明するページ。
requiresSubscription.identifier テキスト categorysubscription、かつ commonTierfalse の場合は必須です - メディア カタログ内のコンテンツ グループへのアクセスを表す、このサブスクリプションの一意の文字列です。
  • 識別子には、次の構文を使用することをおすすめします。
    ドメイン名 + コロン(:) + コンテンツに対するアクセスレベル、例 : example.com:basic、example.com:premium、example.com:sports
  • 利用資格 API を提供する場合、このプロパティは利用資格 ID と同じになります。
requiresSubscription.authenticator 組織 categoryexternalsubscription の場合は必須 - 外部プロバイダの認証システムの詳細を提供するコンテナ。
requiresSubscription.authenticator.@type テキスト categoryexternalsubscription の場合は必須 - 常に Organization に設定されます。
requiresSubscription.authenticator.name テキスト categoryexternalsubscription の場合は必須 - 認証サービスの名前。TVE プロバイダの場合は、[TVE] に設定します。
requiresSubscription.commonTier ブール値 必須(該当する場合)- カテゴリが定期購入に設定されている場合は必須です。commonTier の詳細については、コモンティアの要件のドキュメントをご覧ください。

Entitlement API の要件

actionAccessibilityRequirement.categorysubscription または externalSubscription で、定期購入パッケージに複数のパッケージや階層が含まれている場合、またはアドオン サポートがある場合は、Entitlement API が必要です。定期購入が 1 階層で、カタログ内のすべてのコンテンツにアクセスできるようにする場合は、この属性を含めないでください。

  • 会社 A では、購読しているユーザーに利用可能なすべてのコンテンツへのアクセスを提供する購読サービスを 1 つ用意しており、エンタイトルメント識別子 / API は不要です。
  • B 社は一部のコンテンツにアクセスできる基本定期購入と、プレミアム コンテンツへのアクセスを提供するプレミアム定期購入を提供しています。エンタイトルメント識別子 / API が必要です
  • C 社には、一部のコンテンツへのアクセスを提供し、サードパーティのコンテンツへのアクセスを提供するパッケージをベースとする基本サブスクリプションがあります。エンタイトルメント識別子 / API が必要です。

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

特典のプロパティ

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

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

識別子

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

ID プロパティ

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

このプロパティは、すべての Watch Action エンティティ タイプで使用できます。

次の表に、identifier プロパティの有効な識別子とサブプロパティを示します。「ウォッチ アクション」フィードの例の識別子/EIDR の例をご覧ください。
プロパティ タイプ 説明
@type テキスト 必須 - 常に PropertyValue に設定されます。
propertyID テキスト 必須 - 次の ID タイプがサポートされています。
  • TMS_ROOT_ID: Gracenote(TMS)のルート ID(例: 15829)。
  • これは TMS_ID のみを使用する組織エンティティと 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 実行 ID。
  • VIP_TIMES_ID: 日本の才能のための日本 VIPTimes(日本たれんと明館)ID。
  • DMA_ID: 米国指定マーケティング エリア コード。GeoShape オブジェクトで使用されます。
  • _PARTNER_ID_: このプロパティには文字列「_PARTNER_ID_」を含める必要があります。値は、サービス プロバイダがエンティティを識別するために使用する、内部または外部の一意の ID にする必要があります(例: 12345a5c604e2-e9e5-4ff3-b728-245799dc37f1)。
value テキスト 必須 - 指定した ID システムの値。

EIDR プロパティ

EIDR(Entertainment Identifier Registry の略)は、映画やテレビ番組など、幅広いメディア コンテンツに対応する世界的に一意の ID システムです。識別システムは、識別子を最上位のタイトルや編集などに関連付けられたメタデータ レコードに解決します。次の表に、EIDR に関連するプロパティとその使用状況の一覧を示します。

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

このプロパティは、TVSeriesTVWeekTVEpisodeMovie のエンティティ仕様ページで使用できます。

たとえば、「Ghostbusters」という動画の titleEIDR は「10.5240/7EC7-228A-510A-053E-CBB8-J」です。

例: Actions0
editEIDR テキスト 強く推奨 - EIDR(Entertainment Identifier Registry)識別子は、映画やテレビの作品に特定の編集 / 編集されている部分を表します。

このプロパティは、TVSongMovie のエンティティ仕様に関するページに用意されています。

たとえば、titleEID - 例 1 - 例 1

コンテンツのレーティング代理店

BroadcastService.contentRatingMovie.contentRatingTVSeries.contentRating には、この表の値を使用します。評価値の前に評価機関を付加する必要があります。例:

  • 米国でレーティングが「R」の映画は Movie.contentRating の値が「MPAA R」である必要があります。
  • 米国でレーティングが「TV-MA」のテレビシリーズの TVSeries.contentRating の値は「TVPG TV-MA」です。

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

GeoShape プロパティ

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

プロパティ タイプ 説明
@id URL 必須 - URI 形式の地域リージョンの ID。
@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"
    }
  ]
}