サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳




GET streams/compare_to_target

このエンドポイント へアクセスするには特別なアクセス権が必要で、TV放送をする場合にのみ使用できます。アクセス権の申請をする場合は curator.twitter.comからお願いします。

ストリームのツイート数、もしくは重複を省いたツイート主数を目標数値と比較し、目標数値に占めるパーセンテージを取得します。



リソースURL

https://curator.twitter.com/broadcast/1/streams/compare_to_target



リソース情報

応答形式
JSON
XML
認証は必要ですか?
はい
レート制限はありますか?
はい
リクエスト回数 / 15分枠 (ユーザー認証の場合)
3750
リクエスト回数 / 15分枠 (アプリケーション認証の場合)
3750


パラメータ

stream_ids か project_id のどちらかは必ず設定してください。

stream_ids 必須

ストリームIDをコンマ区切りでまとめた一覧。

project_id 必須

stream IDの一覧を指定するのではなく、代わりにプロジェクトIDを一つ設定してプロジェクト内の全てのストリームを対象とすることができます。

mode 必須

TWEETS か AUTHORS のどちらかの値を設定します。tweets と設定すると、ツイート数と目標数値を比較します。authorsと設定すると、重複を省いたツイート主数と目標数値を比較します。

target 必須

ツイートや重複を省いたツイート主の目標数値。

auth 必須

ユーザーの認証トークン。

start_time 任意

開始時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り捨てが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り捨てが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り捨てが行われます。 180日以上過去の日付を設定することはできません。設定しなかった場合、既定値は end_time - 1時間 になります。

end_time 任意

終了時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り上げが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り上げが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り上げが行われます。 時間範囲を30日以上にすることはできません。設定しなかった場合、既定値は今の時間になります。

format 任意

出力形式をリクエストします。このパラメータは jsonか xmlのどちらかを設定できます。既定値は jsonです。



OAuth 署名ジェネレータ

ログイン して登録アプリケーションの一覧を参照してください。



リクエスト例

GET

https://curator.twitter.com/broadcast/1/streams/compare_to_target?auth=<auth_token>&stream_ids=2283,2284&target=5&mode=tweets

応答結果の例

{
  "start_time": 1408401180000,
  "end_time": 1408404840000,
  "data": [
    {
      "id": 2283,
      "title": "Top Gear",
      "percent_of_goal": 90
    },
    {
      "id": 2284,
      "title": "Top Gear - w/o Friends",
      "percent_of_goal": 60
    }
  ]
}