ホーム > PHP と Twitter > Twitter API > Lists（リスト） > リストの更新 lists update

リストの更新 lists update

2012年のTwitter APIの記事です。

参考資料として掲載しておきます。

目次 [閉じる]

1. Twitter API lists/update

Twitter API lists/update

API Resource

POST lists/update

概要

　指定したリストの情報(公開／非公開の設定、リストの名前、など)を更新します。
リストを更新するには、認証ユーザー(自分)はリストの所有者である必要があります。

原文

https://dev.twitter.com/docs/api/1/post/lists/update

Resource URL（リソースURL）

https://api.twitter.com/1/lists/update.format

Resource Information（リソース情報）

Rate Limited(制限)	No(なし)
Requires Authentication(認証)	Yes(あり)
Response Formats(フォーマット)	json　xml
HTTP Methods(HTTPメソッド)	POST

Parameters（パラメーター）

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

list_id ※必須	サンプル値：	リストの数値IDを指定します。
slug ※必須	サンプル値：	数値IDの変わりにスラッグ名によっていリストを識別することが出来ます。パラメータ slug を指定する場合、パラメーター owner_screen_name か owner_id によってリストの所有者を指定する必要があります。
name ※オプション	サンプル値：	リストの名前を指定します。
mode ※オプション	サンプル値：public	作成するリストの公開(public)／非公開(private)の設定を指定します。このパラメーターを指定しない場合は公開(public)となります。
description ※オプション	サンプル値：	リストの説明を指定します。
owner_screen_name ※オプション	サンプル値：tryphp	パラメーター slug によって要求されているリストの所有者の screen_name を指定します。
owner_id ※オプション	サンプル値：123	パラメーター slug によって要求されているリストの所有者のユーザー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>Twitter API lists update リスト 更新</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 update リスト 更新</h1>
<!-- 説明ページurl -->
<h3><a href="https://wepicks.net/2012/01/30/phpapptwitter-lists_update/">→説明はこちら</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/update.xml","POST",array('slug' => 'list001', 'owner_screen_name' => 'tryphp', 'mode' => 'public', 'description' => 'リストの説明'));

//XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する
$oXml = simplexml_load_string($vRequest);

//オブジェクトを展開
if(isset($oXml->error) && $oXml->error != ''){
    echo "リスト更新に失敗しました。<br>\n";
    echo "指定リストは存在しません。<br>\n";
    echo "パラメーターの指定を確認して下さい。<br>\n";
    echo "エラーメッセージ:".$oXml->error."<br>\n";
}else{
    echo "リストを更新しました。<br>\n";
    echo "リストid:(".$oXml->id.")<br>\n";
    echo "リスト名:(".$oXml->name.")<br>\n";
    echo "リスト説明:(".$oXml->description.")<br>\n";
    echo "リストmode:(".$oXml->mode.")<br>\n";

    echo "リスト保有者ユーザーid:(".$oXml->user->id.")<br>\n";
    echo "リスト保有者ユーザーname:(".$oXml->user->name.")<br>\n";
    echo "リスト保有者ユーザーscreen_name:(".$oXml->user->screen_name.")<br>\n";
    echo "<hr/>\n";
}
?>

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

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

<h2>取得したオブジェクトの内容</h2>
<?php
var_dump($oXml);
?>
<hr/>

</body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<title>Twitter API lists update リスト更新</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 update リスト更新</h1>

<h3><a href="https://wepicks.net/2012/01/30/phpapptwitter-lists_update/">→説明はこちら</a></h3>

<hr/>

<?php

#########################################

### 取得したデータを展開

<h2>取得したデータを展開</h2>

<?php

//API実行データ取得

$vRequest = $twObj->OAuthRequest("https://api.twitter.com/1/lists/update.xml","POST",array('slug' => 'list001', 'owner_screen_name' => 'tryphp', 'mode' => 'public', 'description' => 'リストの説明'));

//XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する

$oXml = simplexml_load_string($vRequest);

//オブジェクトを展開