はじめに

ガラポンではAPIを公開しており、開発者様は、ガラポンTVに蓄積された放送番組関連情報を使った様々なサービスの開発が可能です。
あなたも、ガラポンTVのAPIを利用したマッシュアップサービスを作ってみませんか?
録画された大量のテレビ番組データには、あなたの発想次第で無限大の可能性があります。

1.API仕様書

1)ガラポンWeb認証API
ガラポンIDとパスワードを入力すると、ガラポンTV端末のIPアドレスを返却するAPIです。

[ガラポンWEB認証API仕様書をダウンロードする]

2)ガラポンTVAPI
ガラポンTV端末に対して、日付別・ジャンル別に放送番組の一覧を取得したり、特定の単語で番組表データや番組情報内テキストを検索したり、番組情報を表示し、番組を再生したりすることができます。

[ガラポンTV伍・四・参号機API仕様書(API仕様書Ver.3)をダウンロードする]

[ガラポンTV弐号機API仕様書(API仕様書Ver.2)をダウンロードする※公開終了しました]

※ガラポンTV六号機APIについては提供検討中です。

2.APIの利用申請

ガラポンAPIの利用にはお申込みが必要です。
ガラポンAPIは「ガラポンTV保有者全員が無料で利用できるサービスにおいて利用する場合」に限り無料で提供されます(該当サービスの公開中のみ無料)。
その他の場合は有償(価格は問い合わせ)となります。

■API利用申し込みの手順
1)<ガラポンTVビジネス窓口>よりAPI利用希望の旨を申請する
※お申込みには[ガラポンAPI利用規約]に同意いただく必要があります。

2)ガラポン社よりガラポンAPI利用申込書が送付されるので、必要事項を記入しガラポン社まで送付する

3)ガラポンAPI利用申込書がガラポン社に到着次第、開発用デベロッパーIDをご連絡します。
デベロッパーIDがあればガラポンTVのAPIを利用して開発が可能となります。
別途、請求書が郵送されますので、期日までのお振込みをお願いいたします。

3.サンプルプログラムとソースコード

[サンプルプログラムを確認する]

当サンプルプログラムはPHPの動作するレンタルサーバー上に下記の3ファイルを置いて動作させています。
ログイン画面(sample_index.html)にガラポンIDとパスワードを入力してガラポンTV端末にログイン後、任意のGTVID(番組ID)を入力すると、番組の詳細情報と番組内テキスト情報一覧を出力いたします。
(※ガラポンTV所有者が自分の保有するガラポンTV端末にアクセスして利用する形態です。サンプルプログラムの確認のためには、ご自身でガラポンTV参・四・伍号機を所有し利用中である必要があります。)

sample_index.html
:ガラポンIDとパスワードの入力画面です。入力された2つの値をPOSTでsample_gtvlogin.phpに渡します。
[cc lang=”html”]

ガラポンTV LAB

ガラポンTVログイン

ガラポンIDとパスワードを入力してください。

ガラポンID:

パスワード:

[/cc]

sample_gtvlogin.php
:ガラポンIDとパスワードを引数として呼び出され、ガラポンWEB認証と端末認証を行い、HTML部分を出力します。

[cc lang=”php”]
$gtvinfo[“gtvver”] = 2;
} else if ( preg_match(“/^GTV3/”, $gtvver_str) > 0 ) {
$gtvinfo[“gtvver”] = 3;
} else if ( preg_match(“/^GTV4/”, $gtvver_str) > 0 ) {
$gtvinfo[“gtvver”] = 4;
} else if ( preg_match(“/^GTV5/”, $gtvver_str) > 0 ) {
$gtvinfo[“gtvver”] = 5;
}
}

//APIバージョンの判定
if ( $gtvinfo[“gtvver”] == 2 ) {
$gtvinfo[“apiver”] = “v2”; //弐号機のAPIバージョン
} else if ( $gtvinfo[“gtvver”] == 3 || $gtvinfo[“gtvver”] == 4 || $gtvinfo[“gtvver”] == 5 ) {
$gtvinfo[“apiver”] = “v3”; //伍・四・参号機用のAPIバージョン
}

//サーバから見たガラポンTVのIPアドレスは必ずグローバルなのでポート番号をつける
if ( isset($gtvinfo[“ipaddr”]) && isset($gtvinfo[“port”]) ) {
$gtvinfo[“ipaddr”] .= “:”.$gtvinfo[“port”];
}

//利用者から見たガラポンTVのIPアドレス
//リモートアドレスとグローバルIPアドレスが一緒であれば宅内利用
if ( isset($gtvinfo[“gipaddr”]) && $gtvinfo[“gipaddr”] == $_SERVER[“REMOTE_ADDR”] && isset($gtvinfo[“pipaddr”]) ) {
$gtvinfo[“cipaddr”] .= $gtvinfo[“pipaddr”];
} else if ( isset($gtvinfo[“gipaddr”]) && $gtvinfo[“gipaddr”] != $_SERVER[“REMOTE_ADDR”] && isset($gtvinfo[“port”]) ) { //宅外からの利用
$gtvinfo[“cipaddr”] .= $gtvinfo[“gipaddr”].”:”.$gtvinfo[“port”];
}

//各値をクッキーにセットしておく(次のAPIコールの時に利用)
foreach ( $gtvinfo as $key => $val ) {
setcookie($key, $val, COOKIE_EXPIRE, “/”);
}

$gtvinfo[“result”] = TRUE;
}

return $gtvinfo;
}

/*
* ガラポンTV端末のAPIを使ってログインする関数
*/
function login_to_gtv($ipaddr, $apiver, $userid, $md5passwd ) {

$url = “http://”.$ipaddr.”/gapi/”.$apiver.”/auth?dev_id=”.DEV_ID;
$post = “type=login”;
$post .= “&loginid=”.$userid;
$post .= “&md5pswd=”.$md5passwd;

$login_result = http_post_request($url, $post);
$logininfo = json_decode($login_result, TRUE);

//クッキーにガラポンTVのAPIを次にコールするときに必要な情報をセットしておく
if( isset($logininfo[“gtvsession”]) ) {
setcookie(‘gtvsession’, $logininfo[‘gtvsession’], COOKIE_EXPIRE, “/”);
}

return $logininfo;
}
?>

ガラポンTV LAB

これらの機能は全てガラポンTV APIで実現しています。

GTVID(番組ID)を入力すると当該番組の字幕を全出力

番組ID:


戻る

[/cc]

sample_bangumi_data.php
:gtvidを引数として呼び出され、番組情報と番組内テキストデータを一覧出力します。

[cc lang=”PHP”]

ガラポンTV LAB

これらの機能は全てガラポンTV APIで実現しています。

番組情報の取得に失敗しました。

戻る



放送日時 番組尺 放送局 番組説明

番組字幕


]


[/cc]

当プログラムの動作環境やライセンスについて

・PHPバージョン:PHP5
・php.iniで「extension=php_curl.dll」を有効にしている必要があります。
・上記のプログラムコードの利用については、修正BSDライセンスに従うものとします。無保証、改変自由、再配布自由。初期開発者情報の表示不要。
・FreeBSD 7.1-RELEASE-p16 i386、Apache/1.3.42 (Unix) mod_ssl/2.8.31 OpenSSL/0.9.8eにて動作確認済み。

4.よくある質問

Q. 現在放送中の字幕取得ができますか?
A. はい、可能です(検索APIにてvideo:all)を指定してください。

Q. APIを通じて取得した情報をに公開したり販売してもいいですか?
A. ダメです。著作権法を勉強してください。

5.API活用サイトのご紹介

g256:ガラポン社とは無関係の個人開発者g256様運営によるガラポンTV独自UIサイト。ニコニコ実況連携や、番組表表示、倍速再生などに対応しております。

ガランチュ:ガラポン社とは無関係の個人開発者makoto_kw様開発のガラポンTV iPadアプリ。番組を視聴しながら他の番組を探せたりします。ソースコードも公開中です。

GaraponMate:ガラポン社とは無関係の個人開発者gae様作成のAndroidアプリ。ブラウザ起動→ログイン→番組検索までをアプリ立ち上げだけで短縮化。とっても便利です。

Kodiful life:ガラポンTVをリモコンで操作してテレビで視聴するサービスです。

・俺ポン(iOS|Android):倍速再生や自動お気に入り登録、検索での除外キーワード設定など、俺が欲しい機能が詰まったアプリです。

・ガラコン:自動お気に入り登録やピンポイント番組検索などの機能があるブラウザ上で使うサービスです。※現在、サービス終了したそうです。

アニチェッカー:深夜アニメのリンク集です。クリックすると該当の番組がガラポンTVで再生できます。