Hatena::Groupnadesiko

そっとなでしこ RSSフィード


メインのブログに書くまでもない、なでしこ学習帳【記事一覧】 【このブログは何?】


特設!→【目次】なでしこ用Twitter 連携ライブラリ「なこったー」で遊ぶ


2010-09-11

「なこったー」でツイートを削除する

| 「なこったー」でツイートを削除する - そっとなでしこ を含むブックマーク はてなブックマーク - 「なこったー」でツイートを削除する - そっとなでしこ

 日本語プログラミング言語「なでしこ」用Twitter 連携ライブラリ「なこったーの「つぶやき削除」関数を使用し、Twitter APIの「statuses/destroy」 APIを呼んでみるサンプルです。

【【関数】つぶやき削除({ハッシュ=?}PARAMで{文字列}STATUS_IDの)~

 今回使用する関数は、「つぶやき削除」関数です。

■説明

 Twitter APIの「statuses/destroy」 APIを「なでしこ」から呼び、指定したツイートを削除する関数です。

 「statuses/destroy」 APIについては以下の通りです。

ステータスを削除する。ステータスIDの指定は必須。

削除が成功した場合は、format で指定した形式で応答が返る

Twitter API 仕様書 日本語訳

http://watcher.moe-nifty.com/memo/docs/twitterAPI.txt

■引数

詳細は、「Twitter API 仕様書 日本語訳」等を参照のこと。

  • {文字列}STATUS_IDの
    • 必須です。削除するツイートをステータスIDで指定します。
  • {ハッシュ=?}PARAMで
    • 省略可能です。今回のサンプルでは使用していません。
    • ハッシュ形式で設定値を設定しますが…実は現在のTwitter APIの「statuses/destroy」APIでは、オプション指定できる項目がありませんw

■戻り値

 Twitter APIへの問い合わせに成功した場合は、フォローした対象のユーザー情報が、ハッシュテーブルの配列に格納されて戻ります。

 詳細は、以下を参照。

また、次の場合はエラーを返します。

  • 存在しないツイートを削除しようとした場合は、以下のエラー文言を返す。
error=そのIDのツイートがありません。
request=/1/statuses/destroy/xxxxxxxxxxx.json
  • 他人のツイートを削除しようとした場合、以下のエラー文言を返す。
error=他のユーザーのツイートを削除することができません。
request=/1/statuses/destroy/xxxxxxxxxxx.json

■サンプルのソースコード

※「OAuth認証設定」部分を、事前に取得した「コンシューマ・キー」と「コンシューマ・シークレット」、「アクセストークン」と「アクセストークンシークレット」に書き換えて実行して下さい。

 サンプルは、以下のツイート(http://twitter.com/mamenakotter/status/24197674590)、つまりステータスID「24197674590」のツイートを削除するサンプルです。

  


mamenakotter

日本語プログラミング言語"なでしこ"用twitterライブラリ"なこったー"(http://bit.ly/bxAEOs)での

ツイート削除テスト用ツイートです。
(2010/09/11 23:20:46)

link

#-----------------------------------------------------------------------
# OAuth認証設定
#-----------------------------------------------------------------------
# Twitterにアプリケーション登録した際に発行された
# 「コンシューマ・キー」と「コンシューマ・シークレット」を設定
CONSUMER_KEY=「****」。
CONSUMER_SECRET=「****」。
# 「アプリケーションのアクセス許可」&認証で発行された
# 「アクセストークン」と「アクセストークンシークレット」を設定
OAUTH_TOKEN=「****」。
OAUTH_TOKEN_SECRET=「****」。
#-----------------------------------------------------------------------

!「nakotter.nako」を取り込む
なこったークライアントとはNakotter。
そのoauthのコンシューマのトークンキー = CONSUMER_KEY。
そのoauthのコンシューマのシークレット = CONSUMER_SECRET。
そのoauthのトークンキー = OAUTH_TOKEN。
そのoauthのシークレット = OAUTH_TOKEN_SECRET。

なこったークライアントから「24197674590」のつぶやき削除して、メモ記入。





「なこったー」でフォローする

| 「なこったー」でフォローする - そっとなでしこ を含むブックマーク はてなブックマーク - 「なこったー」でフォローする - そっとなでしこ

 なでしこ用Twitter 連携ライブラリ「なこったーの「フォロー」関数を使用し、Twitter APIの「friendships/create」 APIを呼んでみるサンプルです。

【関数】フォロー({ハッシュ=?}PARAMで{文字列}SCREEN_NAMEを)~

 今回使用する関数は、「フォロー」関数です。

■説明

 Twitter APIの「friendships/create」 APIを「なでしこ」から呼び、指定したユーザーをフォローする関数です。

 「friendships/create」 APIについては以下の通りです。

指定ユーザを自分の friend (following) にする。

id, user_id, screen_name のいずれかの引数を必ず指定すること

Twitter API 仕様書 日本語訳

http://watcher.moe-nifty.com/memo/docs/twitterAPI.txt

■引数

詳細は、「Twitter API 仕様書 日本語訳」等を参照のこと。

  • {文字列}SCREEN_NAMEを
    • 必須です。フォローする対象のユーザーを「ユーザー名(screen_name)」あるいは「ユーザーID番号(user_id)」で指定します。
  • {ハッシュ=?}PARAMで
    • 省略可能です。今回のサンプルでは使用していません。
    • ハッシュ形式で以下の項目を指定できます(例:パラムとはハッシュ。#パラム@「follow」=「true」。)
      • follow
        • 指定したユーザをフォローにすると同時に、そのユーザの発言を「指定デバイス」に送信する場合に「true」を設定。

■戻り値

Twitter APIへの問い合わせに成功した場合は、フォローした対象のユーザー情報が、ハッシュテーブルの配列に格納されて戻ります。

詳細は、以下を参照。

■サンプルのソースコード

※「OAuth認証設定」部分を、事前に取得した「コンシューマ・キー」と「コンシューマ・シークレット」、「アクセストークン」と「アクセストークンシークレット」に書き換えて実行して下さい。

#-----------------------------------------------------------------------
# OAuth認証設定
#-----------------------------------------------------------------------
# Twitterにアプリケーション登録した際に発行された
# 「コンシューマ・キー」と「コンシューマ・シークレット」を設定
CONSUMER_KEY=「****」。
CONSUMER_SECRET=「****」。
# 「アプリケーションのアクセス許可」&認証で発行された
# 「アクセストークン」と「アクセストークンシークレット」を設定
OAUTH_TOKEN=「****」。
OAUTH_TOKEN_SECRET=「****」。
#-----------------------------------------------------------------------

!「nakotter.nako」を取り込む
なこったークライアントとはNakotter。
そのoauthのコンシューマのトークンキー = CONSUMER_KEY。
そのoauthのコンシューマのシークレット = CONSUMER_SECRET。
そのoauthのトークンキー = OAUTH_TOKEN。
そのoauthのシークレット = OAUTH_TOKEN_SECRET。

なこったークライアントから「mametanuki」をフォローしてメモ記入。