このセクションでは、RadioBroadcastService エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。詳細については、完全なフィードの例をご覧ください。
仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
Text |
必須: このプロパティは常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。ここで、xx はフィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、適切な言語コードに設定し、BCP 47 形式にする必要があります。たとえば、言語がスペイン語に設定されている場合、字幕や吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。 |
@type |
Text |
必須: このプロパティは常に RadioBroadcastService に設定します。 |
@id |
URL |
必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、「識別子」セクションをご覧ください。 |
url |
URL |
必須: ラジオ局に関する情報を提供するコンテンツの正規 URL。url プロパティは、次の要件を満たしている必要があります。
|
name |
Text |
必須: ラジオ局の正式名称。言語ごとに 1 つの正式名称のみが存在する必要があります。(「WXKS FM」など)。複数の言語で名前を列挙するには、配列を使用します。例については、複数の地域と言語をご覧ください。 |
alternateName |
Text |
ユーザーがラジオ局を識別するのに役立つ別名。このプロパティは、トリガーに影響を与えるキーワードではなく、駅の正当な代替名である必要があります。キーワードの場合は、代わりに keywords プロパティを使用します。複数の言語で名前を列挙するには、配列を使用します。例については、複数の地域と言語をご覧ください。 |
callSign |
Text |
該当する場合は必須: 政府が発行した無線通信局の公式コールサイン。(「KQEI-FM」など)。北米のラジオ局の場合、このプロパティは必須です。コールサインが一般的に使用されていない地域では、これは省略可能です。 |
broadcastDisplayName |
Text |
必須: ラジオ ステーションの表示名またはブランディング。例: 「Fake Radio 105.」この値は、コールサインや名前などの他の重要な情報に加えて、ユーザーがクエリでこのラジオ局を識別するのに役立ちます。 |
description |
Text |
必須: ラジオ ステーションの簡単な説明。このプロパティの文字数は 300 文字までです。複数の言語で説明をマークアップするには、配列を使用します。例については、複数の地域と言語をご覧ください。 |
slogan |
Text |
ラジオ局のスローガン。例: 「Google の架空の音楽ラジオ局ナンバーワン」。 |
logo |
ImageObject |
放送局のロゴ画像。使用可能な最高解像度を指定します。形式は JPEG または PNG である必要があります。詳細と例については、ImageObject のセクションをご覧ください。 |
broadcastFrequency |
BroadcastFrequencySpecification |
必須: 無線通信局の周波数仕様。地上 AM/FM ラジオ局の場合、このプロパティは必須です。オンライン専用ストリームの場合、値は INTERNET_STREAM 文字列に設定する必要があります。詳細と例については、BroadcastFrequencySpecification セクションをご覧ください。 |
areaServed |
City, State, Country, or AdministrativeArea |
必須: ラジオ ステーションがターゲットとする主な地域。このプロパティを使用すると、関連付けられた同様の名前のステーションのネットワークの中から、最も適切なステーションを選択できます。たとえば、これを使用して、ローカル アフィリエイトを持つ全国放送のラジオ サービスを選択します。推奨される形式は city, (optional) state, country です。詳細と例については、City、State、Country、AdministrativeArea をご覧ください。 |
broadcastAffiliateOf |
Organization |
該当する場合に必須: ラジオ局が所属する系列局、またはラジオ局で放送されるコンテンツを提供する系列局。たとえば、「NPR」、「PRI」、「PBS」などです。ラジオ局がどの系列にも加盟していない場合、このプロパティは不要です。詳細と例については、組織のセクションをご覧ください。 |
broadcaster |
Organization |
必須: ラジオ局を所有、運営している組織。詳細と例については、組織のセクションをご覧ください。 |
parentService |
RadioBroadcastService |
該当する場合は必須: このプロパティは、ラジオ局が中継局または変換局である場合にのみ必須です。中継局または変換局が中継する元のラジオ局を表します。詳細と例については、RadioBroadcastService セクションをご覧ください。 |
potentialAction |
ListenAction |
必須: ユーザーがラジオ局を聴くためにトリガーされるアクション。詳しくは、ListenAction セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification |
強く推奨 理由 Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
inLanguage |
Text |
ラジオ局で放送されるコンテンツの言語。値は BCP 47 形式の言語コードである必要があります。この値は、特定の言語のコンテンツをリクエストするユーザーのクエリを満たすために使用します。放送局が異なる時間に異なる言語で放送している場合は、主な言語のみを記載してください。 |
keywords |
Text |
ラジオ放送局に関連付けられたキーワードのリスト。これらのキーワードを使用して、ラジオ局をトリガーするユーザー クエリを拡大します。例: 「ニュース」、「スポーツ」、「ロック」。 |
identifier |
PropertyValue |
強く推奨 理由 - このエンティティを一義的に示す外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
sameAs |
URL |
商品アイテムの ID を明確に示す参照ウェブページの URL。(放送サービスについての Wikipedia ページなど)。 |
エンティティ タイプのプロパティ参照
エンティティ タイプとそのプロパティ参照は次のとおりです。
BroadcastFrequencySpecification
BroadcastFrequencySpecification エンティティ タイプは broadcastfrequency プロパティに関連付けられています。
BroadcastFrequencySpecification エンティティ タイプは、周波数でラジオ局を識別するために使用されます。デジタル ラジオの場合、周波数チャネルは異なる番組を含む複数のサブチャネルを伝送する可能性があります。このような場合、broadcastSubChannel 値は、周波数チャネル内のターゲット ラジオ局を特定するために使用されます。
インターネット ラジオ局のみの場合、BroadcastFrequencySpecification オブジェクトは不要なため、代わりに文字列値 INTERNET_STREAM を使用します。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に BroadcastFrequencySpecification に設定します。 |
broadcastFrequencyValue |
Text |
必須: 周波数の数字部分。例: 「89.3.」Digital Audio Broadcasting(DAB)局の場合、これはブロック番号である必要があります。例: 「12A.」 |
broadcastSignalModulation |
Text |
必須: 周波数の信号変調部分。値は、「FM」、「AM」、「HD」、「DAB」、「DAB+」のいずれかである必要があります。 |
broadcastSubChannel |
Text |
該当する場合は必須: デジタル ラジオの場合のサブチャンネル。DAB および DAB+ ステーションの場合、この値はサービス ID です。たとえば、HD ラジオの場合、「HD1」~「HD8」が可能な値です。DAB の場合、「C8D8」が可能な値です。 |
BroadcastFrequencySpecification の例を次に示します。
FM(HD)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
AM
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "1010",
"broadcastSignalModulation": "AM",
},
DAB
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "12B",
"broadcastSignalModulation": "DAB",
"broadcastSubChannel": "C8D8"
},
インターネットのみ
"broadcastFrequency": "INTERNET_STREAM",
組織
Organization エンティティ タイプは broadcaster プロパティまたは broadcastAffiliateOf プロパティに関連付けられています。
RadioBroadcastService 仕様では、Organization 型は broadcaster プロパティと broadcastAffiliateOf プロパティの両方で使用されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に Organization に設定します。 |
@id |
URL |
必須: URI 形式の組織のグローバルに一意の ID。ID は固定されており、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。 |
name |
Text |
必須: 組織の名前。 |
sameAs |
URL |
このプロパティは、組織を一義的に識別する参照ウェブページの URL です。たとえば、組織の Wikipedia ページや組織の公式ウェブサイトなどです。 |
Organization の例を次に示します。
SINGLE
"broadcaster": {
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio",
"sameAs": "https://www.billyradio-example.org/",
"name": "Billy Radio Inc"
},
複数のオーナー
"broadcaster": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio"
"name": "Billy Radio Inc"
"sameAs": "https://www.billyradio-example.org/"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/Gmusic"
"name": "Gmusic",
}
],
複数のネットワーク
"broadcastAffiliateOf": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/npr",
"name": "NPR",
"sameAs": "https://en.wikipedia.org/wiki/NPR"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/pri",
"name": "PRI",
"sameAs": "https://www.pri.org/"
}
],
RadioBroadcastService
RadioBroadcastService エンティティ タイプは parentService プロパティに関連付けられています。
parentService プロパティは、中継局または変換局が親局を示すために使用されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に RadioBroadcastService に設定します。 |
@id |
URL |
必須: 親ラジオ ステーションを表すグローバルに一意の ID(URL 形式)。親ラジオ局がフィードに別のエンティティとして含まれている場合は、両方の ID が同じであることを確認してください。 |
name |
Text |
必須: 親ラジオ ステーションの名前。 |
sameAs |
URL |
親駅を明確に識別する参照ウェブページの URL。(親ステーションの Wikipedia ページなど)。 |
次に RadioBroadcastService の例を示します。
"parentService": {
"@type": "RadioBroadcastService",
"@id": "https://www.tjradio.org/stations?id=10",
"name": "GQED-FM",
"sameAs": "https://en.vikibedia.org/wiki/GQED-FM"
},
ImageObject
ImageObject エンティティ タイプは logo プロパティに関連付けられています。
logo プロパティは、指定されたラジオ局のロゴ画像を提供するために使用されます。これらの画像は、特定のラジオ エンティティのディープリンクとしてコンテンツとともに表示されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に ImageObject に設定します。 |
height |
Integer |
画像の高さ(ピクセル単位)。 |
width |
Integer |
画像の幅(ピクセル単位)。 |
contentUrl |
URL |
必須: 画像を取得可能な URL。 |
regionsAllowed |
Country |
メディアが許可されている国。プロパティが指定されていない場合、画像はすべての言語 / 地域で表示が許可されていると見なされます。 リージョンごとに異なる画像を送信するには、複数の ImageObject タイプを追加して、それぞれに国のグループおよび対応する画像 URL を指定します。 |
国
Country エンティティ タイプは logo.regionsAllowed プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
このプロパティは常に Country に設定します。 |
name |
Text |
ISO 3166-1 alpha-2。例: 「GB」、「US」 |
ImageObject の例を次に示します。
ユニバーサル ロゴ
"logo": {
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
国別のロゴ
"logo": [
{
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/12345.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "PK"
}
]
},
],
PropertyValue
PropertyValue エンティティ タイプは identifier プロパティに関連付けられています。
コンテンツにサードパーティの ID システム(Gracenote ID(TMS)など)を使用している場合は、identifier プロパティで ID を指定できます。これにより、Google がラジオ局を照合する際の精度が向上します。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に PropertyValue に設定します。 |
propertyID |
Text |
必須: 指定された ID のタイプ。次の ID タイプがサポートされています。
|
value |
Text |
親駅を明確に識別する参照ウェブページの URL。(親ステーションの Wikipedia ページなど)。 |
PropertyValue の例を次に示します。
"identifier": {
"@type": "PropertyValue",
"propertyID": "WIKIDATA_ID",
"value": "Q795598"
},
PopularityScoreSpecification
PopularityScoreSpecification エンティティ タイプは popularityScore プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に PopularityScoreSpecification に設定します。 |
value |
Number |
必須: カタログの他のエンティティと比較される正の数値。数値が大きいほど人気度が高いことを表します。 |
eligibleRegion |
Country |
人気度スコアを適用可能な国または地域のリスト。人気度スコアがグローバルに適用可能な場合は、テキスト値として earth を使用します。特定の地域をリストする必要がある場合は、 Country 型を使用します。このプロパティを省略すると、 eligibleRegion はデフォルトで earth になります。 |
国
Country エンティティ タイプは popularityScore.eligibleRegion プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に Country に設定します。 |
name |
Text |
必須: ISO 3166-1 alpha-2。例: 「GB」、「US」 |
PopularityScoreSpecification の例を次に示します。
世界的な人気度
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
国固有
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
City、State、Country、AdministrativeArea
City、State、Country、AdministrativeArea のエンティティ タイプは、areaServed プロパティに関連付けられています。
areaServed プロパティを使用すると、ユーザーの位置情報に基づいて最適な駅を選択できます。位置情報の例としては、「近くのラジオ局」や「ローカル ニュース ラジオ」などのユーザー クエリがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは、常に City、State、Country、AdministrativeArea のいずれかのエンティティ タイプに設定します。 |
name |
Text |
必須: 都市、州、国、地域の名前。最も粒度の細かいリージョンを指定します。また、包含チェーンも指定します。形式は次のようにします: city, state, country。 |
areaServed の例を次に示します。
都市
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
STATE
"areaServed": [
{
"@type": "State",
"name": "California, US"
},
{
"@type": "State",
"name": "Nevada, US"
}
],
国
"areaServed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "Australia"
}
],
ADMINISTRATIVEAREA
"areaServed": [
{
"@type": "AdministrativeArea",
"name": "Cape Cod, Massachusetts, US"
}
],
ListenAction
ListenAction エンティティ タイプは potentialAction プロパティに関連付けられています。
ListenAction プロパティは、再生用のディープリンクを定義します。また、ユーザーがコンテンツにアクセスするための条件も定義します。例: geo/chronal/login/subscription status
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に ListenAction に設定します。 |
target |
EntryPoint |
必須: ディープリンクの仕様。サポートされているプラットフォームの情報が含まれています。複数の EntryPoint エンティティ タイプを使用して、プラットフォーム セットごとに異なるディープリンクを定義できます。 |
actionAccessibilityRequirement |
ActionAccessSpecification |
必須: このエンティティにアクセスするためのユーザー要件の定義。複数の ActionAccessSpecification エンティティ タイプが存在する場合、仕様条件のいずれかを満たすユーザーがコンテンツにアクセスできます。 |
EntryPoint
EntryPoint エンティティ タイプは potentialAction.target プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に EntryPoint に設定します。 |
urlTemplate |
Text |
必須: コンテンツの再生を開始するリンク。 |
actionPlatform |
Text |
必須: ディープリンクが有効なプラットフォーム。可能な値は次のとおりです。
|
ActionAccessSpecification
ActionAccessSpecification エンティティ タイプは potentialAction.actionAccessibilityRequirement プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に ActionAccessSpecification に設定します。 |
category |
Text |
必須: アクセス要件のタイプ。次のいずれかの値を指定する必要があります。
|
availabilityStarts |
DateTime |
サービス期間の開始時刻。このプロパティを使用して、ユーザーがこのコンテンツを利用できる正確な時刻を制御します。 |
availabilityEnds |
DateTime |
サービス期間の終了時刻。このプロパティを使用すると、ユーザーがこのコンテンツを利用できなくなる正確な時刻を制御できます。 |
eligibleRegion |
Country |
Offer を利用できる国。このプロパティを使用して、コンテンツを利用できる(または利用できない)国と地域を管理します。 |
requiresSubscription |
MediaSubscription |
コンテンツにアクセスするために必要なサブスクリプション パッケージ。サービスで複数の定期購入パッケージを提供している場合は、このプロパティが必要です。サービスが無料の場合や、サブスクリプション サービスが 1 つの階層しかない場合は、このプロパティをスキップできます。 |
国
Country エンティティ タイプは potentialAction.actionAccessibilityRequirement.eligibleRegion プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に Country に設定します。 |
name |
Text |
必須: ISO 3166-1 alpha-2 形式の国コード。 |
MediaSubscription
MediaSubscription エンティティ タイプは potentialAction.actionAccessibilityRequirement.requiresSubscription プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に MediaSubscription に設定します。 |
@id |
Text |
必須: サブスクリプション パッケージのグローバルに一意の ID(URI 形式)。ID は固定されており、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。 |
name |
Text |
必須: サブスクリプション パッケージの名前。例: 「G-Radio Premium」、「A-Radio Basic」。 |
expectsAcceptanceOf |
Offer |
メディア定期購入の購入に関連付けられている Offer タイプ。このプロパティは、定期購入の価格を表すために使用されます。 |
特典
Offer エンティティ タイプは potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf プロパティに関連付けられています。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Text |
必須: このプロパティは常に Offer に設定します。 |
price |
Number |
必須: 定期購入の価格。 |
priceCurrency |
Text |
必須: 価格の通貨。3 文字の ISO 4217 形式で指定します。 |
seller |
Organization |
アクションの有料会員登録または購入を提供する組織。Organization セクションで説明されているのと同じスキーマを使用します。 |
ListenAction の例を次に示します。
ユニバーサル ディープリンク
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
プラットフォーム固有
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/castlink?streamStationId=170",
"actionPlatform": [
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
}
],
"actionAccessibilityRequirement": [
{
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://www.example.com/packages/basic-pack",
"name": "G-Radio Basic Pack",
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 8.99,
"priceCurrency": "USD"
}
},
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
]
},
完全なフィードの例
この完全なフィードの例では、架空のラジオ データ プロバイダ TJ_RADIO を紹介します。TJ_RADIO は、ラジオデータのリスン アクションと、関連付けと所有権の情報を提供します。このフィードでは、3 つのラジオ ネットワーク(提携局にコンテンツを提供)が GPR、GRI、G-music として表示されます。また、GQED、GQEI、G-music の 3 つのラジオ局が表示されます。
- GQED は、別々の組織である GQED Inc と GPCB が所有しています。また、GQED は GPR と提携しており、GPR と GPI が作成したコンテンツの一部を放送しています。
- GQEI は GQED Inc と GPCB が所有しています。GQED のリピーター/トランスレータ ステーションで、別のエリアをカバーしています。GQEI は GPR および GPI にも関連しています。
- G-music は GRJ が所有し、ラジオ ネットワーク G-music(ステーションと同じ名前の別のエンティティ)に所属する国際的なステーションです。G-music ステーションは全国にあり、ラジオ ネットワーク G-music が作成したコンテンツの一部を放送しています。
関連ページ
このページで説明したプロパティに関連するトピックについて詳しくは、次のページをご覧ください。