このセクションでは、ウォッチ アクションに関する一般的なプロパティの詳細について説明します。
アクション マークアップ プロパティ
プロパティ | タイプ | 説明 |
---|---|---|
@type |
テキスト | 必須 - 常に WatchAction に設定されます。 |
target |
エントリ ポイント | 必須 - ディープリンクをさまざまな Google プラットフォームにマッピングするターゲット オブジェクト。 |
target.@type |
テキスト | 必須 - 常に EntryPoint に設定されます。 |
target.urlTemplate |
URL | 必須 - ユーザーをアプリまたはプラットフォームに誘導し、コンテンツの再生を開始するディープリンク。 |
target.inLanguage |
テキスト | 省略可 - シリーズのオリジナル言語(BCP 47 形式)。 |
target.actionPlatform |
テキスト | 必須 - urlTemplate にマッピングされたプラットフォーム。メディア アクションでは以下がサポートされています。
|
target.additionalProperty |
PropertyValue | 該当する場合は必須 - ディープリンクの追加プロパティを表すプロパティと値のペアのリスト。これには次のものが含まれます。
|
actionAccessibilityRequirement |
ActionAccessSpecification | 必須 - コンテンツのアクセス要件を記述するアクション アクセス指定オブジェクト。アクション アクセス仕様のプロパティをご覧ください。 |
アクション マークアップ関連ページ
これらのプロパティに関連するトピックについては、次のページをご覧ください。
アクション アクセス指定プロパティ
プロパティ | タイプ | 説明 |
---|---|---|
actionAccessibilityRequirement.@type |
テキスト | 必須 - 常に ActionAccessSpecification に設定されます。 |
actionAccessibilityRequirement.category |
テキスト | 必須 - コンテンツのアクセス要件。詳細については、ペイウォールのタイプをご覧ください。 エンティティがコンテンツのグループを表す場合、
|
actionAccessibilityRequirement.availabilityStarts |
Date | 必須 - アクションが使用可能になる日付。ISO 8601 形式(タイムゾーンを含む)で指定します。
対応するエンティティは、availabilityStarts の日付の少なくとも 7 日前にフィードで指定する必要があります。これにより、コンテンツが予定どおりに Google サービスに表示される可能性が高くなります。 |
actionAccessibilityRequirement.availabilityEnds |
Date | 必須 - アクションが不要になった日付。ISO 8601 形式(タイムゾーンを含む)で指定します。
availabilityEnds の日付を変更する場合は、availabilityEnds の日付の 7 日前までにフィードに反映する必要があります。これにより、availabilityEnds 日に Google サービスにコンテンツが表示されなくなる可能性が高まります。 |
actionAccessibilityRequirement.eligibleRegion |
Country、City、State、GeoShape、または Text | 必須 - コンテンツが利用可能な地域。コンテンツがグローバルに利用できる場合は、特殊な文字列 EARTH を使用します。 |
actionAccessibilityRequirement.ineligibleRegion |
Country、City、State、または GeoShape | 該当する場合は必須 - コンテンツが制限されている地域。eligibleRegion のどこからでも利用できる場合は、このプロパティを指定する必要はありません。 |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | 該当する場合は必須 - ユーザーがコンテンツにアクセスするために必要な定期購入の詳細。メディア サブスクリプションのプロパティをご覧ください。
|
actionAccessibilityRequirement.expectsAcceptanceOf |
特典 | コンテンツの購入が必須である場合に必須 - コンテンツに関連付けられている特典の詳細。以下の場合は、料金情報をお知らせください。
Offer オブジェクトを完全に削除し、category を ActionAccessSpecification オブジェクトから free に設定します。特典のプロパティをご覧ください。
|
メディアの有料会員登録プロパティ
actionAccessibilityRequirement.category
が subscription
または externalSubscription
の場合は必須。
プロパティ | タイプ | 説明 |
---|---|---|
requiresSubscription.@type |
テキスト | 必須 - 常に MediaSubscription に設定 |
requiresSubscription.@id |
URL | 必須 - 有料会員登録の一意の ID。異なる複数の定期購入を通じてコンテンツにアクセスできる場合、それぞれの定期購入は一意の ID を持つ必要があります。 |
requiresSubscription.name |
テキスト | 必須 - 有料会員登録の名前。次の点にご注意ください。
|
requiresSubscription.sameAs |
URL | 有料会員登録を説明するページ。 |
requiresSubscription.identifier |
テキスト | category が subscription 、かつ
commonTier が false
の場合は必須です
-
メディア カタログ内のコンテンツ グループへのアクセスを表す、このサブスクリプションの一意の文字列です。
|
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
で、定期購入パッケージに複数のパッケージや階層が含まれている場合、またはアドオン サポートがある場合は、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 タイプがサポートされています。
|
value |
テキスト | 必須 - 指定した ID システムの値。 |
EIDR プロパティ
EIDR(Entertainment Identifier Registry の略)は、映画やテレビ番組など、幅広いメディア コンテンツに対応する世界的に一意の ID システムです。識別システムは、識別子を最上位のタイトルや編集などに関連付けられたメタデータ レコードに解決します。次の表に、EIDR に関連するプロパティとその使用状況の一覧を示します。
プロパティ | タイプ | 説明 |
---|---|---|
titleEIDR |
テキスト | 強く推奨 - EIDR(Entertainment Identifier Registry)識別子は、映画またはテレビの作品を最も抽象的または抽象的なレベルで表したものです。 このプロパティは、TVSeries、TVWeek、TVEpisode、Movie のエンティティ仕様ページで使用できます。 たとえば、「Ghostbusters」という動画の titleEIDR は「10.5240/7EC7-228A-510A-053E-CBB8-J」です。 例: Actions0 |
editEIDR |
テキスト | 強く推奨 - EIDR(Entertainment Identifier Registry)識別子は、映画やテレビの作品に特定の編集 / 編集されている部分を表します。 このプロパティは、TVSong と Movie のエンティティ仕様に関するページに用意されています。 たとえば、titleEID - 例 1 - 例 1 |
コンテンツのレーティング代理店
BroadcastService.contentRating
、Movie.contentRating
、TVSeries.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 オブジェクトには、以下のいずれかの種類のデータが含まれます。
- 郵便番号のリスト(米国、カナダ、他の郵便番号など)
- カナダのフォワード並べ替えエリアのリスト
- 指定マーケット エリア(DMA)ID - 全員が同じテレビ チャンネルや番組を受信する米国内地域の識別子
プロパティ | タイプ | 説明 |
---|---|---|
@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"
}
]
}