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

ライブ TV イベントのコンテンツマークアッププロパティ

このセクションでは、BroadcastEvent エンティティタイプのコンテンツマークアッププロパティについて詳しく説明します。これらのタイプの関係を理解するには、LiveTV イベントのコンセプトをご覧ください。

BroadcastEvent の仕様表

プロパティ	タイプ	説明
`@context`	テキスト	必須 - 常に `["http://schema.org", {"@language": "xx"}]` に設定します。 `xx` を、エンティティの言語コード（BCP 47 形式）に置き換えます（例: "en"）。
`@type`	テキスト	必須 - 常に `BroadcastEvent` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。 `@id` は次の要件を満たす必要があります。カタログ全体でグローバルに一意静的。ID は、番組の URL プロパティが変更されても、時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。 Unified Resource Identifier（URI）の形式 @id 値に使用するドメインが、自分の組織が所有するものであること。エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`name`	テキスト	必須 - 番組またはイベントのタイトル。
`description`	テキスト	番組またはイベントの説明。300 文字以下。配列を使用して複数の言語と長さの説明を含めます。
`startDate`	日付	必須 - タイムゾーンを含む ISO 8601 形式のイベントの開始時刻。
`endDate`	日付	タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
`publishedOn`	BroadcastService	該当する場合は必須 - この番組またはイベントを放送する `BroadcastService` エンティティを指定します。コンテンツが TV チャンネルで配信される場合、このプロパティは必須です。コンテンツがどの TV チャンネルにも関連付けられていない場合は、このプロパティを指定しないでください。
`publishedOn.@type`	テキスト	`BroadcastService` に設定します。
`publishedOn.@id`	URL	この番組またはイベントを放送する `BroadcastService` エンティティの `@id`。
`workPerformed`	CreativeWork	該当する場合は必須 - コンテンツが `Movie`、`TVSeries`、`TVEpisode` のいずれかのエンティティタイプの場合にこのプロパティを使用します。 `BroadcastEvent` エンティティには、次のいずれかを 1 つ以上含めることを強くおすすめします。 `workPerformed` `broadcastOfEvent` `contentToBeAnnounced` を `true` に設定 `offAir` を `true` に設定
`workPerformed.@type`	テキスト	`Movie`、`TVSeries`、`TVEpisode` のいずれかに設定します。
`workPerformed.@id`	URL	コンテンツエンティティの `@id`。
`broadcastOfEvent`	SportsEvent	該当する場合は必須 - コンテンツがライブイベントの場合に、このプロパティを使用します。スポーツイベントの場合は、このプロパティが `SportsEvent` エンティティを参照する必要があります。 `BroadcastEvent` エンティティには、次のいずれかを 1 つ以上含めることを強くおすすめします。 `workPerformed` `broadcastOfEvent` `contentToBeAnnounced` を `true` に設定 `offAir` を `true` に設定
`broadcastOfEvent.@type`	テキスト	`SportsEvent` に設定します。
`broadcastOfEvent.@id`	URL	イベントエンティティの `@id`。イベントエンティティはフィード内に存在し、`BroadcastEvent` とは異なる `@id` を持つ必要があります。
`location`	Text または Country	BroadcastEvent が SportsEvent の場合（`broadcastOfEvent` プロパティがある場合）は必須 - 基になる SportsEvent を放送できる国。複数の国で SportsEvent を放送できる場合は、このフィールドに国のリストを指定できます。
`videoFormat`	テキスト	この放送サービスでサポートされる最高品質の定義。次に例を示します。標準画質用の「SD」。ハイビジョン用の「HD」。 2K 解像度用の「2K」。 4K 解像度用の「4K」。 8K 解像度用の「8K」。
`contentToBeAnnounced`	ブール値	該当する場合は必須 - フィードの作成時にコンテンツが不明な場合に、このプロパティを使用します。放送される内容に関する最新情報がプロバイダにない場合は `true` に設定し、そうでない場合は `false` に設定します。 `BroadcastEvent` エンティティには、次のいずれかを 1 つ以上含めることを強くおすすめします。 `workPerformed` `broadcastOfEvent` `contentToBeAnnounced` を `true` に設定 `offAir` を `true` に設定
`offAir`	ブール値	該当する場合は必須 - このプロパティは、その時間帯に予定されているコンテンツの放送がない場合に使用します。 `BroadcastEvent` エンティティには、次のいずれかを 1 つ以上含めることを強くおすすめします。 `workPerformed` `broadcastOfEvent` `contentToBeAnnounced` を `true` に設定 `offAir` を `true` に設定
`isLiveBroadcast`	ブール値	ライブイベントの場合は `true` に設定します。たとえば、スポーツイベントやコンサートなどです。
`potentialAction`	WatchAction	該当する場合は必須 - コンテンツがチャンネルレスのライブストリーミングイベントとして放送される場合（`contentToBeAnnounced` が `false` に設定されているか、`offAir` が `false` に設定されている場合）、このプロパティを使用してイベントのディープリンクを指定します。
`identifier`	PropertyValue	ブロードキャストコンテンツを識別する外部 ID。詳細については、識別子プロパティのセクションをご覧ください。注: `BroadcastEvent` エンティティタイプは、`TMS_ID` または `TMS_ROOT_ID` の `propertyID` 値のみを受け入れます。このプロパティは、完全に形成された最上位の `Movie`、`TVSeries`、`TVEpisode`、`SportsEvent` エンティティが `workPerformed` プロパティまたは `broadcastOfEvent` プロパティを使用して参照されていない場合にのみ指定してください。プロパティの値は、`workPerformed` プロパティまたは `broadcastOfEvent` プロパティを使用して参照する `Movie`、`TVSeries`、`TVEpisode`、または `SportsEvent` エンティティの `TMS_ID` または `TMS_ROOT_ID` を反映する必要があります。 `TMS_ID` は `TMS_ROOT_ID` 値よりも優先されます。
`contentRating`	Text または Rating	アダルトコンテンツの場合は必須、それ以外の場合は強く推奨理由 - 放送コンテンツの全体的なコンテンツのレーティング。コンテンツの評価がテキスト文字列の形式で指定されている場合は、次の 2 つのバリエーションが使用できます。格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「MPAA」からの「PG-13」格付けは、「MPAA PG-13」と記述します。代理店のリストをご覧ください。映画のレーティングが不明であることを示す値「RATING NOT KNOWN」（大文字と小文字は区別されません）。
`contentRating.author`	組織	`contentRating` で `Rating` が使用されている場合は必須 - 格付け機関の名前。
`contentRating.ratingValue`	テキスト	`contentRating` で `Rating` が使用されている場合必須 - 格付けの値。
`contentRating.advisoryCode`	テキスト	コンテンツに関する注意事項のコード。指定できる値は、D、FV、L、S、V です。D = 会話、FV = ファンタジーの暴力、L = 言語、S = 性的コンテンツ、V = 暴力。

例

ある TV エピソードが、2019 年 10 月 12 日午後 9 時から午後 9 時 30 分の間に、テレビネットワーク Example TV（BroadcastService）で放送されるとします。

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

2019 年 10 月 12 日午後 9 時から午後 9 時 30 分の間にテレビネットワーク Example TV（BroadcastService）で放送されるコンテンツがフィードの作成時に不明な場合の contentToBeAnnounced プロパティの使用例:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "To Be Announced"
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

テレビネットワーク Example TV（BroadcastService）のチャンネルは午後 12 時から午後 8 時まで放送休止で、午後 8 時から午後 12 時まで My favorite show という番組を 1 本放送します。

BroadcastEvent

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00:00-08:00",
   "endDate": "2019-10-12T20:00-08:00",
   "publishedOn": {
       "@type": "BroadcastService",
       "@id": "http://example.com/stations/example_tv"
   },
   "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },

}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

ライブ TV イベントのコンテンツ マークアップ プロパティ コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

BroadcastEvent の仕様表

例

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

関連ページ

ライブ TV イベントのコンテンツマークアッププロパティ