サイトのトップへ戻る

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

サイト内検索

POST statuses/update

認証ユーザーの現在のステータスを更新します。ステータスとはツイートのことです。

更新をする際には毎回、更新するテキストを認証ユーザーの最近のツイートと比較します。比較した結果内容が重複していた場合はブロックされて 403 エラーを返します。 従って、ユーザーは二回続けて同じツイートを投稿することができません。

このAPIによるレート制限はありませんが、ユーザーが一度に作成できるツイート数には制限があります。 ユーザーが投稿した更新数がこのメソッドの制限に達した場合は、 HTTP 403 エラーを返します。



地理情報について

  • ユーザーのgeo_enabledがfalseになっていた場合、ジオタグパラメータに関する更新は無視されます。 (ユーザーが自分の設定で位置情報-geolocation- を有効にしていない場合、これが既定の設定になります。)
  • latには最大で小数点第8位までの数字を設定でき、取得したstatus オブジェクト内の latは設定したのと同じ小数桁になります。
  • Please make sure to use to use a decimal point as the separator (and not the decimal comma) for the latitude and the longitude - usage of the decimal comma will cause the geo-tagged portion of the status update to be dropped.
  • JSONの場合、ほとんどの応答ではGeoJSONの書式を使っています。しかし残念なことに、Twitterで表現するgeoオブジェクトの座標については、GeoJSON の指定とは逆になっています。 (GeoJSON では経度、緯度の順に指定しますが、現時点でTwitterでは緯度、経度の順に指定しています。Twitterの JSON は次のように表現されます: "geo": { "type":"Point", "coordinates":[37.78217, -122.40062] }
  • 現在、geo オブジェクトをcoordinates オブジェクトに置き換えをしています。(geo オブジェクトは非推奨のdate 情報を保持しています) — coordinates オブジェクトは、現時点ではJSONの場合でもGeoJSONの場合でも正しく描写されるという違いがあります。
  • ツイートの更新時に place_id を設定した場合、そのツイートには場所情報が付与されます。 place_idを設定せずにlatitudelongitude を設定した場合は、内部で geo/reverse_geocodeを呼び出して場所情報の付与を試みます。
  • ユーザーは設定ページ上で、自分の全てのツイートからジオタグを全て削除することができます。現時点では自動で削除をしておらず、個別にツイートからジオタグを削除する方法はありません。


リソースURL

https://api.twitter.com/1.1/statuses/update.json



リソース情報

応答形式
JSON
認証は必要ですか?
はい (user context only)
レート制限はありますか?
はい


パラメータ

status 必須

ツイート文、通常は最大で140文字。必要に応じて URL エンコードしてください。 t.co link wrapping は文字数のカウントに影響することがあります。

このフィールドには、注意すべきいくつかの special commands があります。 例えば、メッセージの前に“D ” か “M ”を付け、その後ろにスクリーンネームを付けると、ユーザーへのダイレクトメッセージを作ることができます。これはダイレクトメッセージを送るのを許可されている場合に限ります。

in_reply_to_status_id 任意

この更新でリプライを行う対象ツイートのID。

注意::このパラメータが参照しているツイートのツイート主がツイート本文で言及されていない場合、このパラメータは無視されます。 したがって更新するツイート本文に、リプライするツイートのツイート主の ユーザー名を、@usernameという形式で含めなければなりません。

possibly_sensitive 任意

ヌードや暴力的なものや医療手術のように、不適切なコンテンツと見なされそうなツイートメディアをアップロードする場合は、この値をtrueに設定してください 詳細については画像/動画の表示設定を参照してください。既定では falseが設定されます。

サンプル値: true

lat 任意

このツイートが言及している場所の緯度。-90.0から90.0までの範囲でなければ、このパラメータは無視されます (北の方角が正の値になります)。 対応するlongパラメータがない場合も無視されます。

サンプル値: 37.7821120598956

long 任意

このツイートが言及している場所の経度。 有効な範囲は -180.0 から +180.0 までです(東の方角が正の値になります) 。この範囲外の値や数字以外の値が設定された場合、geo_enabledが無効になっていたり対応するlatパラメータがない場合、このパラメータは無視されます。

サンプル値: -122.400612831116

place_id 任意

地球上での place

サンプル値: df51dec6f4ee2b2c

display_coordinates 任意

ツイート送信元の正確な座標にピンを置くかどうか

サンプル値: true

trim_user 任意

truet1を設定すると、取得したタイムライン上の各ツイートは、ツイート主の数値型IDのみを持ったユーザーオブジェクトを内包します。 このパラメータを省略すると、完全なユーザーオブジェクトを取得します。

サンプル値: true

media_ids 任意

このツイートに関連付けるメディアIDの一覧。最大四つまでのメディアをツイートに関連付けられます。 メディアをアップロードする詳細情報については Uploading Media を参照してください。

サンプル値: 471592142565957632



OAuth 署名ジェネレータ

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



リクエスト例

POST

https://api.twitter.com/1.1/statuses/update.json?status=Maybe%20he%27ll%20finally%20find%20his%20keys.%20%23peterfalk



応答結果の例

{
  "coordinates": null,
  "favorited": false,
  "created_at": "Wed Sep 05 00:37:15 +0000 2012",
  "truncated": false,
  "id_str": "243145735212777472",
  "entities": {
    "urls": [

    ],
    "hashtags": [
      {
        "text": "peterfalk",
        "indices": [
          35,
          45
        ]
      }
    ],
    "user_mentions": [

    ]
  },
  "in_reply_to_user_id_str": null,
  "text": "Maybe he'll finally find his keys. #peterfalk",
  "contributors": null,
  "retweet_count": 0,
  "id": 243145735212777472,
  "in_reply_to_status_id_str": null,
  "geo": null,
  "retweeted": false,
  "in_reply_to_user_id": null,
  "place": null,
  "user": {
    "name": "Jason Costa",
    "profile_sidebar_border_color": "86A4A6",
    "profile_sidebar_fill_color": "A0C5C7",
    "profile_background_tile": false,
    "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg",
    "created_at": "Wed May 28 00:20:15 +0000 2008",
    "location": "",
    "is_translator": true,
    "follow_request_sent": false,
    "id_str": "14927800",
    "profile_link_color": "FF3300",
    "entities": {
      "url": {
        "urls": [
          {
            "expanded_url": "http://www.jason-costa.blogspot.com/",
            "url": "http://t.co/YCA3ZKY",
            "indices": [
              0,
              19
            ],
            "display_url": "jason-costa.blogspot.com"
          }
        ]
      },
      "description": {
        "urls": [

        ]
      }
    },
    "default_profile": false,
    "contributors_enabled": false,
    "url": "http://t.co/YCA3ZKY",
    "favourites_count": 883,
    "utc_offset": -28800,
    "id": 14927800,
    "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg",
    "profile_use_background_image": true,
    "listed_count": 150,
    "profile_text_color": "333333",
    "protected": false,
    "lang": "en",
    "followers_count": 8760,
    "time_zone": "Pacific Time (US & Canada)",
    "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif",
    "verified": false,
    "profile_background_color": "709397",
    "notifications": false,
    "description": "Platform at Twitter",
    "geo_enabled": true,
    "statuses_count": 5532,
    "default_profile_image": false,
    "friends_count": 166,
    "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif",
    "show_all_inline_media": true,
    "screen_name": "jasoncosta",
    "following": false
  },
  "source": "My Shiny App",
  "in_reply_to_screen_name": null,
  "in_reply_to_status_id": null
}



エンジェル戦記