Tag: TwitterAPI/v1.1
参考情報†
- APIエンドポイントに承認が必要。
- APIエンドポイントごとにレートリミットが採用。
- Twitterクライアントに対する規約強化。
開発者側で必要なこと†
- APIエンドポイントのURL変更。
- レートリミットへの変更。
- Display Requirementsへの対応
APIエンドポイントのURL変更†
通常API†
検索API†
レートリミット変更†
- API 1.0ではREST APIで1時間あたり350回だった。
- API 1.1では1アカウント・15分・エンドポイントあたりに15回または180回。
- X-Rate-Limit-Remainingで残り回数確認できるらしい。X-Rate-Limit-Resetはリセットされる時間。
- ストリーミングAPIの制限は変更なし。
Display Requirementsへの対応†
クライアントにとってこれが一番問題。
個々のTweet†
1. Tweet Author†
- a. アプリケーションがモバイルプラットフォームで明確な物理的・技術的な制限がない場合を除き、アイコンは常に表示されなければならない。
- b. @usernameは、@つきで表示しないといけない。
- c. 著者の名前と@usernameは、アイコンの右側に、一直線か、垂直に積み上げて、名前を先に表示する。
- d. アイコン、名前、@usernameはユーザーのTwitter profileにリンクすること。
2. Tweet Text†
- a. ツイートテキストは著者の名前と@usernameの下に表示し、原則的に改変してはならない(?)
- b. ツイートテキスト中のTweet Entities | Twitter DevelopersはTwitterの適切な場所にリンクする。
- i. User_mentions はユーザーのprofileにリンク。
- ii. ハッシュタグはtwitter.comの検索にリンク。
- iii. 本文中のリンクもただしくリンク。
3. Tweet Action†
- a. Reply, Retweet, Favoriteアイコンは常にTweetと同時にみえていないとだめ。それらのアクションはWeb IntentsやTwitter APIで実装する。
- b. サードパーティのFollow, Reply, Retweet,Favoriteに似たアクションはTweetに添付することはできない。
4. Tweet Timestamp†
- a. timestampは常に表示。“3:00 PM - 31 May 12"。
5. Tweet Permalink†
- a. Tweet timestampはTweet permalinkにリンク。
6. Branding†
- a. ユーザーが見ている内容がTwitterであることが明瞭に。
- b. Twitter logo or Follow buttonは常に表示。
- c. Twitter logoはTwitterにリンク。
タイムライン†
タイムラインの表示ではいくつかの変更が必要
1. Tweet Author†
- a. 著者の名前と@usernameは、アイコンの右側に、一直線か、垂直に積み上げて、名前を先に表示する。
- b. @usernameは常に@つきで表示。
- アイコンは名前、@username、テキストの左に。
2. Tweet Action†
- a. Reply, Retweet, Favoriteアイコンは常に使用可能でないとだめ。例えば、選択、ホバー、タッチ、スワイプなどで。
- b. モバイルプラットフォームでは、Tweetエリア全体をアプリの個々のTweetが、TwitterのTweetにリンクすることもできる。
3. Tweet Timestamp†
- a. timestampは右上に常に表示。
- b. 24時間以内は相対時間で表示。"20s"、"3m"、"5h"などなど。
- c. 24時間以上は "6 Jun"などと表示。
4. Tweet Permalink†
- a. Tweet timestampはTweet permalinkにリンク。
- b. モバイルプラットフォームでは、Tweetエリア全体をTweet permalinkにリンクすることもできる。
5. Retweet Indicator†
- a. もしツイートがRetweetならば、Retweetしてユーザーの名前とRetweetアイコンをTweetテキストの上か下に表示しなければならない。例えば"Retweeted by Josh Brewer"。名前はRetweetしたユーザーのプロフィールにリンク(モバイルプラットフォームで…)
6. Timeline Integrity†
- タイムラインにまとめられているツイートはTwitter以外の内容を表示してはならない。
7. Branding†
- ユーザーが見ている内容がTwitterであることが明瞭に。
- Twitter logoを表示する(例えばタイムラインのトップに)。
Linking to Twitter†
アイコン、名前、@username、Tweet entity、Tweet action, Tweet permalink, Twitterロゴにリンクする場合以下のどちらかの方法でリンクすることができる。
しかしながら、アイコン、名前、@username、hashutagはアプリ内部表示を使用することもできる。この内部表現はtwitter.comやオフィシャルTwitterクライアントのようなマナーをもたなければならない。
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
