ProgramBuilder
Programオブジェクトのインスタンスを作成するビルダー。
拡張
コンストラクタ
new ProgramBuilder()
new ProgramBuilder():
ProgramBuilder
戻り値
継承元
メソッド
attributes()
attributes(
attributes):ProgramBuilder
Programの属性を設定します。
パラメーター
attributes
string[]
Programの文字列。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
属性が設定されたProgramBuilderオブジェクト。
詳細
このフィールドは番組では任意です。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
build()
build():
IProgram
指定されたパラメーターからProgramオブジェクトをビルドします。
戻り値
ビルドされたProgramオブジェクト。
スロー
必須フィールドが1つ以上欠落していると、InvalidArgumentErrorが発生します。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
オーバーライド
channelDescriptor()
channelDescriptor(
channelDescriptor):ProgramBuilder
番組のChannelDescriptorを設定します。
パラメーター
channelDescriptor
この番組が放送されているチャンネルを一意に識別する記述子。
戻り値
ChannelDescriptorが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは、Programオブジェクトを作成するために必須です。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
description()
description(
description):ProgramBuilder
番組の説明を設定します。
パラメーター
説明
string
特定の番組の簡単な説明。たとえば、エピソードの説明などです。文字列の長さが8192バイトを超えると、文字列は「...」で切り捨てられます。
戻り値
説明が設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
endTimeMs()
endTimeMs(
endTimeMs):ProgramBuilder
番組の終了時刻を設定します。
パラメーター
endTimeMs
number
番組の終了時刻（エポックミリ秒単位）。このフィールドは、過去または将来の値を表すことができます。
戻り値
終了時刻が設定されたProgramBuilderオブジェクト。
詳細
このフィールドは、Programオブジェクトを作成するために必須です。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
genres()
genres(
genres):ProgramBuilder
番組のジャンルを設定します。
パラメーター
genres
string[]
番組に適用されるジャンルのリスト。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
ジャンルが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
identifier()
identifier(
identifier):ProgramBuilder
番組の識別子を設定します。
パラメーター
identifier
string
電子番組表リスト内の番組の識別子。このフィールドはProgramをビルドするために必須です。このフィールドの最大長は8192バイトです。
戻り値
番組識別子が設定されたProgramBuilderオブジェクト。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
フィールドが最大長の8192バイトを超えると、InvalidArgumentErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
posterArtUrl()
posterArtUrl(
url):ProgramBuilder
番組のポスターアートURLを設定します。
パラメーター
url
string
戻り値
ポスターアートのURLが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
フィールドが最大長の8192を超えると、InvalidArgumentErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
ratings()
ratings(
ratings):ProgramBuilder
番組のレーティングを設定します。
パラメーター
ratings
string[]
特定の番組で推奨される保護者による指導レベルを示すために使用される文字列のリスト。これには、番組が放送される国または地域で使用されている任意のレーティングシステムに従うことができます。このフィールドで推奨される標準値のリストについては、開発者ガイドを参照してください。リストの最大サイズは32です。アイテムが32個を超える場合、余分なアイテムは削除されます。各項目の最大サイズは255バイトです。この長さを超える項目は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
レーティングが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
seriesInfo()
seriesInfo(
seriesInfo):ProgramBuilder
番組のシリーズ情報を設定します。
パラメーター
seriesInfo
シーズンやエピソード番号など、番組のシリーズ関連情報。
戻り値
seriesInfoが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、番組がエピソードを表していて、この情報が入手可能な場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
startTimeMs()
startTimeMs(
starTime):ProgramBuilder
番組の開始時刻を設定します。
パラメーター
starTime
number
戻り値
開始時刻が設定されたProgramBuilderオブジェクト。
詳細
このフィールドは、Programオブジェクトを作成するために必須です。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
subtitle()
subtitle(
subtitle):ProgramBuilder
番組のサブタイトルを設定します。
パラメーター
subtitle
string
特定の番組のサブタイトル。たとえば、「MCIS: Los Angeles」のエピソード名である「Maybe Today」など。文字列の長さが255バイトを超えると文字列は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
サブタイトルが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、該当する場合やわかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
thumbnailUrl()
thumbnailUrl(
url):ProgramBuilder
番組のサムネイルURLを設定します。
パラメーター
url
string
戻り値
サムネイルURLが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは任意ですが、わかっている場合は必ず入力する必要があります。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
フィールドが最大長の8192バイトを超えると、InvalidArgumentErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
title()
title(
title):ProgramBuilder
番組のタイトルを設定します。
パラメーター
title
string
特定の番組のタイトルまたは名前。たとえば、「MCIS: Los Angeles」など。文字列の長さが255バイトを超えると文字列は切り捨てられ、最後の3バイトは「...」に置き換えられます。
戻り値
タイトルが設定されたProgramBuilderオブジェクト。
詳細
このフィールドは、Programオブジェクトを作成するために必須です。
スロー
このビルダーインスタンスが既にオブジェクトを1回ビルドした後に関数が呼び出されると、IllegalStateErrorが発生します。
スロー
有効なUTF-8ではない文字列が渡されると、InvalidArgumentErrorが発生します。
Last updated: 2025年9月30日
