お気に入り関連

現在ではお気に入りとは呼ばず、当世風にいいねという名前になってしまったが、本稿では旧式の用語のままにしておく。以下、星マークとある箇所をハートマークをする等、旧用語は順次読み替えて欲しい。

POST favorites/create

POST favorites/create はツイートを一つ指定して、それをお気に入りとする機能だ。

次にサンプルコードを示す。

#!/usr/bin/env python

# Demonstration POST favorites/create
# See https://dev.twitter.com/rest/reference/post/favorites/create

from secret import twitter_instance
from json import dump
import sys

tw = twitter_instance()

# [1]
response = tw.favorites.create(
    _id=653256646810955776,
    include_entities=False)

# [2]
dump(response, sys.stdout, ensure_ascii=False, indent=4, sort_keys=True)
  • [1] ツイート ID をパラメーター id として指定することになっているが、PTT では _id として値を渡すのが無難だ。

    また、応答データが少しでも軽くなるように include_entities=False を明示的に指定しておく。

  • [2] 返信データ、すなわち指定したツイートオブジェクトを出力する。

POST favorites/destroy

POST favorites/destroy は自分のお気に入りツイートを一つ選択して解除する機能だ。

次にサンプルコードを示す。POST favorites/create と同じ形式になる。

#!/usr/bin/env python

# Demonstration POST favorites/destroy
# See https://dev.twitter.com/rest/reference/post/favorites/destroy

from secret import twitter_instance
from json import dump
import sys

tw = twitter_instance()

# [1]
response = tw.favorites.destroy(
    _id=653256646810955776,
    include_entities=False)

# [2]
dump(response, sys.stdout, ensure_ascii=False, indent=4, sort_keys=True)

GET favorites/list

GET favorites/list は特定のユーザーが星マークを付けたツイート群を取得する機能だ。

次にサンプルコードを示す。

#!/usr/bin/env python

# Demonstration GET favorites
# See https://dev.twitter.com/rest/reference/get/favorites/list

from secret import twitter_instance
from json import dump
import sys

tw = twitter_instance()

# [1]
response = tw.favorites.list(
    screen_name='showa_yojyo',
    count=1,
    include_entities=False)

# [2]
dump(response, sys.stdout, ensure_ascii=False, indent=4, sort_keys=True)
  • [1] ここで示すのは、それほど多くはない決まった数量のツイートを取得する方法となる。パラメーター count に 200 までの値を指定することができる。

    なお 200 を超える量のデータを得たい場合は、パラメーター max_id をうまく利用すること。詳しくは 基本技法 参照。

  • [2] ツイートオブジェクトを含むデータを出力する。