認証ユーザーの現在のステータスを更新します。ステータスとはツイートのことです。
更新をする際には毎回、更新するテキストを認証ユーザーの最近のツイートと比較します。比較した結果内容が重複していた場合はブロックされて 403 エラーを返します。 従って、ユーザーは二回続けて同じツイートを投稿することができません。
このAPIによるレート制限はありませんが、ユーザーが一度に作成できるツイート数には制限があります。 ユーザーが投稿した更新数がこのメソッドの制限に達した場合は、 HTTP 403 エラーを返します。
地理情報について
geo_enabledがfalseになっていた場合、ジオタグパラメータに関する更新は無視されます。
(ユーザーが自分の設定で位置情報-geolocation- を有効にしていない場合、これが既定の設定になります。)
latには最大で小数点第8位までの数字を設定でき、取得したstatus オブジェクト内の latは設定したのと同じ小数桁になります。
"geo": { "type":"Point", "coordinates":[37.78217, -122.40062] }
geo オブジェクトは非推奨のdate 情報を保持しています) —
coordinates オブジェクトは、現時点ではJSONの場合でもGeoJSONの場合でも正しく描写されるという違いがあります。
place_id を設定した場合、そのツイートには場所情報が付与されます。
place_idを設定せずにlatitude と longitude を設定した場合は、内部で geo/reverse_geocodeを呼び出して場所情報の付与を試みます。
https://api.twitter.com/1.1/statuses/update.json
ツイート文、通常は最大で140文字。必要に応じて URL エンコードしてください。 t.co link wrapping は文字数のカウントに影響することがあります。
このフィールドには、注意すべきいくつかの special commands があります。 例えば、メッセージの前に“D ” か “M ”を付け、その後ろにスクリーンネームを付けると、ユーザーへのダイレクトメッセージを作ることができます。これはダイレクトメッセージを送るのを許可されている場合に限ります。
この更新でリプライを行う対象ツイートのID。
注意::このパラメータが参照しているツイートのツイート主がツイート本文で言及されていない場合、このパラメータは無視されます。
したがって更新するツイート本文に、リプライするツイートのツイート主の ユーザー名を、@usernameという形式で含めなければなりません。
ヌードや暴力的なものや医療手術のように、不適切なコンテンツと見なされそうなツイートメディアをアップロードする場合は、この値をtrueに設定してください
詳細については画像/動画の表示設定を参照してください。既定では falseが設定されます。
サンプル値: true
このツイートが言及している場所の緯度。-90.0から90.0までの範囲でなければ、このパラメータは無視されます (北の方角が正の値になります)。
対応するlongパラメータがない場合も無視されます。
サンプル値: 37.7821120598956
このツイートが言及している場所の経度。 有効な範囲は -180.0 から +180.0 までです(東の方角が正の値になります) 。この範囲外の値や数字以外の値が設定された場合、geo_enabledが無効になっていたり対応するlatパラメータがない場合、このパラメータは無視されます。
サンプル値: -122.400612831116
ツイート送信元の正確な座標にピンを置くかどうか
サンプル値: true
trueか t か 1を設定すると、取得したタイムライン上の各ツイートは、ツイート主の数値型IDのみを持ったユーザーオブジェクトを内包します。 このパラメータを省略すると、完全なユーザーオブジェクトを取得します。
サンプル値: true
このツイートに関連付けるメディアIDの一覧。最大四つまでのメディアをツイートに関連付けられます。 メディアをアップロードする詳細情報については Uploading Media を参照してください。
サンプル値: 471592142565957632
ログイン して登録アプリケーションの一覧を参照してください。
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
}