Yusuke Yamamoto

　Twitter API 1.1　#twtr_hack

2013/2/1

Yusuke Yamamoto

2012年8月16日のアナウンス

https://dev.twitter.com/blog/changes-coming-to-twitter-api

Yusuke Yamamoto

http://www.atmarkit.co.jp/ait/articles/1209/26/news120.html

Yusuke Yamamoto

概要• Twitter エコシステムの定義

• デベロッパ利用規約の変更• API1.0からAPI 1.1へ

Yusuke Yamamoto

Twitter エコシステム

Yusuke Yamamoto

Twitter エコシステム

https://dev.twitter.com/blog/changes-coming-to-twitter-api より

Yusuke Yamamoto

Twitter エコシステム

https://dev.twitter.com/blog/changes-coming-to-twitter-api より

分析 影響力ランキング

CRMエンタープライズメディア連携

クライアントシンジケーション

Yusuke Yamamoto

セグメントの例

https://dev.twitter.com/blog/changes-coming-to-twitter-api より

Yusuke Yamamoto

TwitterがAPIを使ってやってもらいたいこと

https://dev.twitter.com/blog/changes-coming-to-twitter-api より

“we're trying to encourage activity in the upper-left, lower-left and lower right quadrants, and limit certain use cases that occupy the upper-right

quadrant.”

lower rightlower-left

upper-left

Yusuke Yamamoto

何が良くて何が良くないのか• 定量的な判断基準はない• クライアントアプリビジネスは今後かなり無理• キーポイント

• Twitterのビジネスにとって有益になりそうかどうか

• 利用規約の原則‣ Don't surprise users

‣ Don't create or distribute spam

‣ Respect user privacy

‣ Be a good partner to Twitter

Yusuke Yamamoto

デベロッパ利用規約

Yusuke Yamamoto

デベロッパ利用規約• Display GuidelineからRequirementsへ

• Guideline: 「なるべく守って欲しいな」

• Requirements: 「守れ」

Yusuke Yamamoto

Display Guidelines

https://dev.twitter.com/terms/display-guidelinesより

Yusuke Yamamoto

Display Requirements

https://dev.twitter.com/terms/display-requirementsより

Yusuke Yamamoto

ツイートのレンダリング• @ユーザー名の頭には@を付ける: @yusuke

• 必ずavatar(アイコン)を表示:

• 名前は@ユーザー名より先(左か上)に表示

• @ユーザー名、名前はアイコンの右側、または左側に表示

• アイコン、名前、@ユーザー名はTwitterのプロフィールにリンク

Yusuke Yamamoto

タイムラインのレンダリング• ユーザーにはTwitterのタイムラインを見せていることを明確にする

• タイムラインに隣接(上部など)する形でTwitterのロゴを配置

https://twitter.com/logo より

Yusuke Yamamoto

利用規約その他

http://www.slideshare.net/yusukey/twitter-api-5

Yusuke Yamamoto

API 1.0からAPI1.1

Yusuke Yamamoto

API 1.0からAPI1.1へ• エンドポイントの変更• レートリミット方式変更• OAuth必須化

Yusuke Yamamoto

エンドポイントの変更• バージョン1.1に

• xmlは廃止、json のみに

http://api.twitter.com/1.1/users/show.json?screen_name=yusuke

http://api.twitter.com/1/users/show.json?screen_name=yusuke

Yusuke Yamamoto

廃止されるエンドポイントpublic_timeline.jsonaccount_totals.jsonretweeted_by_ids.jsonretweeted_by_me.jsonretweeted_by_user.jsonretweeted_to_me.jsonretweeted_to_user.jsondaily_trends.jsonweekly_trends.jsonretweeted_by.jsonblocks/exists.jsonfriendship/exists.jsontest.json

Yusuke Yamamoto

廃止エンドポイントを呼ぶと？

４０４

Yusuke Yamamoto

レートリミット方式変更• API 1.0

• 1カウント 350回/1時間

• API 1.1

• 基本: 1エンドポイント 15回/15分

• 多く使われるエンドポイント: 180回/15分statuses/user_timeline.jsonstatuses/show/:id.jsonsearch/tweets.jsonusers/lookup.jsonusers/show.jsonusers/search.jsonapplication/rate_limit_status.json

Yusuke Yamamoto

OAuth必須化• API 1.0

• 一部APIは 150回/1時間 でOAuthなしで呼び出し可

• API 1.1

• 全エンドポイントOAuthが必須

Yusuke Yamamoto

期限• API 1.0は3月5日に廃止

• @Anywhere、ウィジェットも3月5日に廃止

https://dev.twitter.com/docs/anywhere/welcome

Yusuke Yamamoto

移行方法• Java

• Twitter4Jを3.0.xに切り替え

• コンパイルエラーの出る箇所を潰す• 移行ガイドを参照

• 他の言語• 置換: s/api.twitter.com\/1\/(.*)$/api.twitter.com\/1.1\/$1/g

• テスト→404で失敗する場所を潰す

http://twitter4j.org/ja/versions.html#migration22x-30x