PHPでウェブの世界と繋がろう!
menu
ホーム > PHP と Twitter > Twitter API > Lists(リスト) > リストの購読者一覧を取得 lists subscribers

リストの購読者一覧を取得 lists subscribers

Pocket

Twitter API lists/subscribers

API Resource
GET lists/subscribers
概要
 指定したリストを購読しているユーザー一覧を返します。

パラメーター list_id か slug どちらかが必須です。 パラメーター slug を指定した場合は、owner_screen_name か owner_id を指定します。

認証ユーザー(自分)が指定したリストの所有者の場合、プライベートリストの購読者にのみ表示されます。

本文
Resource URL(リソースURL)
https://api.twitter.com/1/lists/subscribers.format
Resource Information(リソース情報)
Rate Limited(制限) Yes(あり)
Requires Authentication(認証) Yes(あり)/No(なし)
Response Formats(フォーマット) json xml
HTTP Methods(HTTPメソッド) GET
Parameters(パラメーター)
パラメーター list_id か slug どちらかが必須です。 パラメーター slug を指定した場合は、owner_screen_name か owner_id を指定します。

list_id
※必須
サンプル値: リストの数値IDを指定します。
slug
※必須
サンプル値: 数値IDの変わりにスラッグ名によっていリストを識別することが出来ます。パラメータ slug を指定する場合、パラメーター owner_screen_name か owner_id によってリストの所有者を指定する必要があります。
owner_screen_name
※オプション
サンプル値:tryphp パラメーター slug によって要求されているリストの所有者の screen_name を指定します。
owner_id
※オプション
サンプル値:123 パラメーター slug によって要求されているリストの所有者の ユーザーID を指定します。
cursor
※オプション
サンプル値:12893764510938 カーソル(cursor)位置を指定して結果をページ分割します。これは、一覧を取得するためにTwitter.comデータベースに指定するカーソル位置です。
指定したカーソル位置からリストを20件取得します。-1を指定した場合、最新から20件分取得します。20以上分はページに分割されます。その場合、「次のページ(next_cursor)」と「前のページ(previous_cursor)」を示すカーソル位置を示す値が取得でき、それらを指定することが出来ます。
include_entities
※オプション
サンプル値:true このパラメータを true または 1 にすると、ステータス情報に entities情報が含まれるようになります。entities情報はそのステータス情報に関連するuser_mentions, urls, hashtagsなどのメタデータです。entitiesの詳細はこちらを参照下さい。
skip_status
※オプション
サンプル値:true このパラメータを true にすると、ステータス情報にユーザーオブジェクトが含まれなくなります。
サンプルコード
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">
<meta name="robots" content="index">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<head>
<title>Twitter API lists subscribers リストの購読者 一覧 取得 表示</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 lists subscribers リストの購読者 一覧 取得 表示</h1>
<!-- 説明ページurl -->
<h3><a href="http://www.tryphp.net/2012/01/29/phpapptwitter-lists_subscribers/">→説明はこちら</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/lists/subscribers.xml","GET",array('slug' => 'media-content', 'owner_screen_name' => 'tsuda'));

//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->users->user as $oUser){
        echo "ユーザーid:(".$oUser->id.")<br/>\n";
        echo "ユーザー名:(".$oUser->name.")<br/>\n";
        echo "ユーザーscreen_name:(".$oUser->screen_name.")<br/>\n";
        echo "<hr/>\n";
    }
}
?>

<!-- =========================== ここまで =========================== // -->
</div>
<hr/>



<?php
#########################################
### 取得したオブジェクトの内容
?>

<h2>取得したオブジェクトの内容</h2>
[PHP ruler="true" toolbar="true"]
<?php
var_dump($oXml);
?>
<\/pre>
<hr/>



</body>
</html>

– サンプル Click Here ! –


タグ(=記事関連ワード)

日付

投稿日:2012年1月29日
最終更新日:2012年07月17日

関連記事

このカテゴリの他のページ

この記事へのコメント

トラックバックurl

http://www.tryphp.net/phpapptwitter-lists_subscribers/trackback/