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

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

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

プロパティ タイプ 説明
@type テキスト 必須 - 常に WatchAction に設定します。
target EntryPoint 必須 - ターゲット オブジェクト。 マッピングと ディープ 各種 Google プラットフォームへのリンク
target.@type テキスト 必須 - 常に EntryPoint に設定します。
target.urlTemplate URL 必須 - A ディープ リンク - ユーザーをアプリまたはプラットフォームに誘導して、 必要があります。
target.inLanguage テキスト 省略可 - シリーズの元の言語 BCP 47 使用できます。
target.actionPlatform テキスト 必須 - マッピングされるプラットフォーム urlTemplate。メディア アクションは以下をサポートします。 <ph type="x-smartling-placeholder">
    </ph>
  • http://schema.org/DesktopWebPlatform: 検索プラットフォーム パソコンのウェブブラウザで
  • http://schema.org/MobileWebPlatform: 検索プラットフォーム: オン モバイル ウェブブラウザ。
  • http://schema.org/AndroidPlatform: 検索と 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 必須(該当する場合) - 対象となるプロパティと値のペアのリスト ディープリンクの追加プロパティを表します。たとえば、 次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • contentLanguage: ブロードキャストの言語(吹き替え) BCP 47 形式。コンテンツが別の言語の吹き替えになっている場合は、 プロパティが必要です。複数の言語コードは、配列を使用して指定します。
  • subtitleLanguage: 字幕の言語 字幕、 BCP 47 形式。複数の言語コードは、配列を使用して指定します。
  • cameraAngle: コンテンツのカメラ角度。 例: 「目の高さ」「高アングル」があります。コンテンツが 異なる場合、このプロパティは必須です。配列を使用する 複数のカメラアングルに対応できます。
  • videoFormat: デジタル ファイルの保存に使用されるファイル形式 動画の日付例: 「SD」(標準画質と「HD」) 高画質です。有効な動画形式は SD、HD、2K、4K、8K です。 複数の動画形式は、配列を使用して指定します。
で確認できます。 詳しくは、 additionalProperty 例です。
actionAccessibilityRequirement ActionAccessSpecification 必須 - アクション アクセス仕様オブジェクトで、Google Cloud リソースの できます。アクション アクセス仕様のプロパティ。

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

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

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

必須 - コンテンツのアクセス要件。詳細情報 詳しくは、 ペイウォールのタイプ

エンティティがコンテンツのグループを表す場合は、 category を、最も制限の少ないアクセス要件( できます。たとえば、TVSeries にいくつかの TVEpisode のコンテンツを nologinrequired に設定しました 一部のプロパティが subscription に設定されている場合は、 TVSeries から nologinrequired に変更します。

actionAccessibilityRequirement.availabilityStarts 日付

必須 - アクションが有効になる日付。 ISO 8601 形式(タイムゾーンを含む)。

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

対応するエンティティをフィードの URL で指定する必要があります。 開始日の 7 日前までに更新する必要がありますこれにより コンテンツが時間内に Google の各種サービスに表示される可能性。

actionAccessibilityRequirement.availabilityEnds 日付 必須 - その日以降はアクションが実行できなくなる日付。 ISO 言語 8601 形式(タイムゾーンを含む)。
  • 次の期間から 72 時間以上経過してください availabilityStarts
  • 公開後にコンテンツを常に利用できる場合は、 現在の日付から 20 年後の日付になります。

在庫状況の終了日を更新する 在庫状況の終了日の 7 日前までに送信してください。この コンテンツが Google に表示されなくなる可能性が高くなる 表示されます。

actionAccessibilityRequirement.eligibleRegion Country(国) 市区町村 StateGeoShape テキスト 必須 - コンテンツが利用可能な地域。こちらの 特殊な文字列 EARTH(コンテンツがグローバルで利用できる場合)。
actionAccessibilityRequirement.ineligibleRegion Country(国) 市区町村 State(州) GeoShape 必須(該当する場合) - コンテンツがある地域 制限されています。コンテンツが以下に該当する場合は、このプロパティを指定する必要はありません。 eligibleRegion 内のどこでも利用できます。
actionAccessibilityRequirement.requiresSubscription MediaSubscription

該当する場合は必須 - 有料会員登録が必要です。詳しくは、 メディア サブスクリプションのプロパティ

  • category が次に該当する場合は、このプロパティを指定します。 subscription または externalSubscription
actionAccessibilityRequirement.expectsAcceptanceOf 特典 コンテンツの購入が必要な場合は必須 - 提示します価格情報を入力してください 次のようなケースがあります。 <ph type="x-smartling-placeholder">
    </ph>
  • 1 回だけの購入コンテンツ(rental または purchase)
  • 追加購入が必要な、定期購入ベースのコンテンツ チャンネル登録者数(subscription または externalsubscription)
で確認できます。 価格が 0.00 の場合は、Offer オブジェクトを完全に削除し、ActionAccessSpecification オブジェクトの categoryfree に設定します。詳しくは、 特典のプロパティ

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

actionAccessibilityRequirement.category が次の場合は必須 subscription または externalSubscription

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

Entitlement API の要件

Entitlements API とは actionAccessibilityRequirement.categorysubscription の場合は必須です。 externalSubscription 様、ご利用のサブスクリプション サービスには アドオンサポートがある場合もあります次の場合は含めないでください。 定期購入は 1 階層型で、カタログ内のすべてのコンテンツにアクセスできます。

  • 企業 A は単一のサブスクリプション サービスであり、登録ユーザーは 1 つのみである 利用可能なすべてのコンテンツへのアクセス: 利用資格 ID / 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たとえば 販売者のホームページに表示されます

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

識別子

メディア アクション フィードでは、メディア アクションの識別に役立つさまざまな識別子を使用できます。 定義できます。これらの識別子は フィード内のコンテンツと Google の データベースですこれらの識別子のほとんどは、 identifier プロパティ(EIDR には独自のエンティティ タイプ) 代表プロパティです。以下では、この両方について説明します。

ID プロパティ

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

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

以下の表に、identifier プロパティの使用可能な識別子とサブプロパティを示します。ウォッチ アクション フィードの例のセクションの識別子/EIDR の例をご覧ください。
プロパティ タイプ 説明
@type テキスト 必須 - 常に PropertyValue に設定します。
propertyID テキスト 必須 - 次の ID タイプがサポートされています。 <ph type="x-smartling-placeholder">
    </ph>
  • 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 スポーツ ID。
  • STATS_ID: STATS Perform ID。
  • VIP_TIMES_ID: Japan VIPTimes(Nihon Tarento Meikan)の日本人タレントの ID。
  • DMA_ID: 米国指定マーケティングの市外局番。 GeoShape オブジェクトです。
  • _PARTNER_ID_: このプロパティには文字列を含める必要があります。 「_PARTNER_ID_」を使用する場合、値にはプロバイダーが使用する一意の ID を サービス プロバイダ(組織内外)に組織を (例: 12345a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value テキスト 必須 - 指定された ID システムの値。

EIDR のプロパティ

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

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

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

たとえば、「Ghostbusters」として知られる映画の titleEIDR などです。「10.5240/7EC7-228A-510A-053E-CBB8-J」です。

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

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

たとえば、「ゴーストバスターズ」と呼ばれる映画の場合「10.5240/7EC7-228A-510A-053E-CBB8-J」というタイトルの EIDR には、次のような編集があります。&quot;10.5240/1F2A-E1C5-680A-14C6-E76B-I&quot;および「10.5240/8A35-3BEE-6497-5D12-9E4F-3」。

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

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

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

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

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

テレビ レーティング機関 映画レーティング機関
アルバニア(AL) 利用不可 利用不可
アンゴラ(AO) 利用不可 CCE
アンティグア バーブーダ(AG) 利用不可 MPAA
アルゼンチン(AR) INCAA INCAA
アルメニア(AM) 利用不可 MKRF/RUSSIA
アルバ(AW) 利用不可 利用不可
オーストラリア(AU) ACB テレビ ACB の映画
オーストリア(AT) FSK FSK
アゼルバイジャン(AZ) 利用不可 MKRF/RUSSIA
バーレーン(BH) 利用不可 MPAA
ベラルーシ(BY) 利用不可 MKRF/RUSSIA
ベルギー(BE) 利用不可 MPAA
ベリーズ(BZ) 利用不可 利用不可
ベナン(BJ) 利用不可 CNC
ボリビア(BO) 利用不可 MPAA
ボスニア ヘルツェゴビナ(BA) 利用不可 MPAA
ボツワナ(BW) 利用不可 MPAA
ブラジル(BR) 分類 分類
ブルキナファソ(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) 利用不可 メク
フランス(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(フォワード ソート エリア)コードのリスト。
identifier PropertyValue 省略可 - A 指定マーケット エリア(DMA)ID: 米国のリージョンの 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"
    }
  ]
}