このセクションでは、
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 つの言語につき 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 |
ラジオ局に関連付けられているキーワードのリスト。これらのキーワードを使用すると、ラジオ局のトリガーとなる検索語句を拡張できます。たとえば“news”は「スポーツ」または「rock」 |
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 です。例: 「HD1」~「HD8」指定可能な値は HD ラジオ、「C8D8」です。DAB で指定できる値です |
BroadcastFrequencySpecification
の例を次に示します。
FM(HD)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
午前
"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 |
必須: 組織のグローバルに一意の ID(URI 形式)。ID は固定されており、時間の経過とともに変化してはなりません。不透明な文字列として扱われるため、有効なリンクである必要はありません。 |
name |
Text |
必須: 組織の名前。 |
sameAs |
URL |
このプロパティは、組織を明確に識別する参照ウェブページの URL です。たとえば、組織の Wikipedia ページや、組織の公式ウェブサイトです。 |
Organization
の例を次に示します。
シングル
"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)の場合、ID は identifier
プロパティで指定できます。これにより、
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
のエンティティ タイプは次のとおりです。
areaServed
プロパティに関連付けてあります。
areaServed
プロパティを使用すると、
ユーザーの位置情報。位置情報の例としては
「近くのラジオ局」などの検索キーワード選択します
プロパティ | タイプ | 説明 |
---|---|---|
@type |
Text |
必須: このプロパティは常に、City 、State 、Country 、AdministrativeArea のいずれかのエンティティ タイプに設定します。 |
name |
Text |
必須: 都市、都道府県、国、地域の名前。最もきめ細かいリージョンを指定します。また、包含チェーンも指定します。形式は次のようにします: city, state, country。 |
areaServed
の例を次に示します。
CITY
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
都道府県
"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(2 つの異なる組織)が所有しています。また、GQED は GPR と GPI が作成したコンテンツの一部を配信しているため、GPR と提携しています。
- GQEI は GQED Inc と GPCB が所有しています。GQED の中継局/通訳局で、別の地域にサービスを提供しています。GQEI も GPR および GPI と提携しています。
- G-music は、GRJ が所有し、G-music(ラジオ局と同じ名前の別の事業体)と提携している国際放送局です。G-music は全国に散在するラジオ局で、ラジオ ネットワーク G-music が制作したコンテンツの一部を配信しています。
関連ページ
プロパティに関連するトピックの詳細については、次のページをご覧ください (このページで説明する):