自分の「つぶやき」一覧を表示 hometimeline
[ Twitter API V1.1 ]
Twitter API statuses/home_timeline
API Resource
GET statuses/home_timeline
概要
認証ユーザーとそのフォローしているユーザーのステータス情報(各つぶやきとそれに関連する諸々の情報)の最新20件(count引数指定で最大200件)を返します。これは、Twitter.comにログインするときにユーザー自身が見るのと同じタイムライン情報です。
つまり、自分のつぶやきや自分がフォローしているユーザーのつぶやきやリツイートなどの一覧を取得します。自分がログインして見ている一覧と同じです。
このメソッドは、常にリツイートが含まれていることを除いて、statuses/friends_timelineと同じです。
このメソッドは、リツイートも含めて最大800件までステータス情報を返します。
Resource URL(リソースURL)
http://api.twitter.com/1/statuses/home_timeline.format
原文
Resource Information(リソース情報)
Rate Limited(制限) | Yes(あり) |
Requests per rate limit window(1ユーザー[アクセストークン]当たりの制限) | 15/user [user]は、ユーザー毎に割り当て [app]は、アプリケーションのみに割り当て 制限時間は15分 詳細はこちらをどうぞ |
Authentication(認証) | Requires user context(必要) |
Response Formats(フォーマット) | json |
HTTP Methods(HTTPメソッド) | GET(ゲット) |
Resource family(リソースファミリー) | statuses |
Response Object(応答オブジェクト) | Tweets |
API Version | v1.1 |
Parameters(パラメーター)
count ※オプション | サンプル値:5 | 取得するステータス情報のレコード数を指定します。最大200件 |
since_id ※オプション | サンプル値:12345 | 指定されたIDより大きいID、つまり新しいIDのステータス情報を返します。APIを通してアクセス可能なidには制限があります。制限より小さいid、つまり過去のidを指定した場合は、利用可能な最も古いidが強制されます。 |
max_id ※オプション | サンプル値:54321 | 指定されたIDより小さいか等しいIDのステータス情報を返します。 |
page ※オプション | サンプル値:3 | 取得するステータス情報のページ数を指定します。 |
trim_user ※オプション | サンプル値:true | このパラメータを true または 1 にすると、返されるステータス情報のユーザ情報をユーザID(数値ID)のみにします。 |
include_rts ※オプション | サンプル値:true | このパラメータを true または 1 にすると、リツイートも取得します。リツイートの表示形式は home_timeline の参照表現と同じです。このパラメータを指定すると、trim_userをtrueにした場合でもユーザー情報は完全なものとして返されます。(ユーザー情報は数値IDのみになりません。) |
include_entities ※オプション | サンプル値:true | このパラメータを true または 1 にすると、ステータス情報に entities情報が含まれるようになります。entities情報はそのステータス情報に関連するuser_mentions, urls, hashtagsなどのメタデータです。entitiesの詳細はこちらを参照下さい。 |
exclude_replies ※オプション | サンプル値:true | このパラメータを true にすると、取得したステータス情報からリプライを取り除きます。exclude_repliesをtrueにしてcountを指定した場合は、countの指定数を取得した後にリプライを取り除いたステータス情報を返します。 |
contributor_details ※オプション | サンプル値:true | このパラメータを true にすると、ステータス情報に貢献者のscreen_nameが含まれるようになります。通常は数値IDのみです。 |
サンプルコード
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja"> <head> <meta name="robots" content="index"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>TRYPHP! Twitter API ホームタイムラインの取得 GET statuses/home_timeline</title> </head> <body> <?php ######################################### ### 初期設定 //twitteroauth.phpをインクルードします。ファイルへのパスは環境に合わせて記述下さい。 require_once("./twitteroauth.php"); //Consumer keyの値をTwitterAPI開発者ページでご確認下さい。 $consumerKey = "***************"; //Consumer secretの値を格納 $consumerSecret = "***********************************"; //Access Tokenの値を格納 $accessToken = "***********************************"; //Access Token Secretの値を格納 $accessTokenSecret = "***********************************"; //OAuthオブジェクトを生成する $twObj = new TwitterOAuth($consumerKey,$consumerSecret,$accessToken,$accessTokenSecret); ?> <?php ######################################### ### ページ説明 ?> <h1>Twitter API ホームタイムラインの取得 GET statuses/home_timeline</h1> <!-- 説明ページ --> <h3><a href="https://wepicks.net/2012/01/03/phpapptwitter-home_timeline/">→説明はこちら</a></h3> <hr/> <?php ######################################### ### 取得したデータを展開 ?> <h2>取得したデータを展開</h2> <div style="background-color:#f8f8f8;margin:20px; padding:20px; border:solid #cccccc 1px;"> <!-- // =========================== ここから =========================== --> <?php //API実行データ取得 $vRequest = $twObj->OAuthRequest("https://api.twitter.com/1/statuses/home_timeline.xml","GET",array("count"=>"10","trim_user" => true)); //XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する $oXml = simplexml_load_string($vRequest); //オブジェクトを展開 if(isset($oXml->error) && $oXml->error != ''){ echo "パラメーターの指定を確認して下さい。<br>\n"; echo "取得に失敗しました。<br>\n"; echo "エラーメッセージ:".$oXml->error."<br>\n"; }else{ foreach($oXml->status as $oStatus){ $iStatusId = $oStatus->id; //つぶやきステータスID $sText = $oStatus->text; //つぶやき $iUserId = $oStatus->user->id; //ユーザーID $sScreenName = $oStatus->user->screen_name; //screen_name $sUserName = $oStatus->user->name; //ユーザー名 echo "<p><b>statusid(".$iStatusId.") screen_name(".$sScreenName.") userid(".$iUserId.") username(".$sUserName.")</b> <br><a href=\"http://twitter.com/".$sScreenName."/status/".$iStatusId."\">このつぶやきのパーマリンク</a><br>\n".$sText."</p>\n"; } } ?> <!-- =========================== ここまで =========================== // --> </div> <hr/> <?php ######################################### ### 取得したオブジェクトの内容 ?> <h1>取得したオブジェクトの内容</h1> [PHP ruler="true" toolbar="true"] <?php var_dump($oXml); ?> <\/pre> <hr/> </body> </html>
取得データ内容サンプル
object(SimpleXMLElement)#5 (2) { ["@attributes"]=> array(1) { ["type"]=> string(5) "array" } ["status"]=> array(10) { [0]=> object(SimpleXMLElement)#7 (17) { ["created_at"]=> string(30) "Fri Jan 13 12:37:06 +0000 2012" ["id"]=> string(18) "157803357157851136" ["text"]=> string(100) "PHP Vulnerability May Halt Millions of Servers - PHP Classes blog - PHP Classes http://t.co/HYrfnukD" ["source"]=> string(63) "twitterfeed" ["truncated"]=> string(5) "false" ["favorited"]=> string(5) "false" ["in_reply_to_status_id"]=> object(SimpleXMLElement)#25 (0) { } ["in_reply_to_user_id"]=> object(SimpleXMLElement)#26 (0) { } ["in_reply_to_screen_name"]=> object(SimpleXMLElement)#27 (0) { } ["retweet_count"]=> string(1) "0" ["retweeted"]=> string(5) "false" ["user"]=> object(SimpleXMLElement)#28 (1) { ["id"]=> string(8) "25524283" } ["geo"]=> object(SimpleXMLElement)#29 (0) { } ["coordinates"]=> object(SimpleXMLElement)#30 (0) { } ["place"]=> object(SimpleXMLElement)#31 (0) { } ["possibly_sensitive"]=> string(5) "false" ["contributors"]=> object(SimpleXMLElement)#32 (0) { } } } }
タグ(=記事関連ワード)
日付
投稿日:2013年10月27日
最終更新日:2014年02月20日
最終更新日:2014年02月20日
このカテゴリの他のページ
この記事へのコメント
トラックバックurl
https://wepicks.net/phpapptwitterv11-home_timeline/trackback/