ホーム > PHP と Twitter API V1.1 > Twitter API V1.1 > Timelines(タイムライン) > 自分の「つぶやき」一覧を表示　hometimeline

自分の「つぶやき」一覧を表示　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

原文

https://dev.twitter.com/docs/api/1/get/statuses/home_timeline

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のみです。

サンプルコード

POINT
以下のサンプルコードを実行するにはOAuth接続が必要です。こちらのページからOAuth接続の設定を行って下さい。

– サンプル Click Here ! –

<!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>

– サンプル Click Here ! –

取得データ内容サンプル

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) {
      }
    }
  }
}

<br /> この部分はインラインフレームを使用しています。<br />

ページトップへ