サイトのトップへ戻る

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

POST account/update_profile_banner

認証ユーザーのプロフィールバナーをアップロードします。 For best results, upload an profile_banner_url node in their Users objects. sizing variationsの詳細情報についてはUser Profile Images and BannersGET users / profile_bannerで見ることができます。

プロフィールバナー画像は非同期で処理されます。 The profile_banner_url and its variant sizes will not necessary be available directly after upload.



HTTP レスポンスコード

コード 意味
200, 201, 202 プロフィールバナー画像のアップロードに成功しました
400 画像もしくは画像データの処理ができませんでした
422 画像がサイズ変更できないか、大きすぎます。


リソースURL

https://api.twitter.com/1.1/account/update_profile_banner.json



リソース情報

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


パラメータ

banner 必須

ユーザーの新しいプロフィール画像としてアップロードするBase64-エンコードされた、もしくは RAW 画像データ。

width 任意

アップロードする画像から切り取る、ピクセル単位の横幅。heightoffset_leftoffset_top を一緒に設定し、画像の表示したい範囲を選んでください。

height 任意

アップロードする画像から切り取る、ピクセル単位の高さ。widthoffset_leftoffset_top を一緒に設定し、画像の表示したい範囲を選んでください。

offset_left 任意

左側を基点とした、アップロードする画像の切り取り開始位置(ピクセル単位)。 heightwidthoffset_topを一緒に設定し、画像の表示したい範囲を選んでください。

offset_top 任意

上側と基点とした、アップロードする画像の切り取り開始位置(ピクセル単位)。 heightwidthoffset_left を一緒に設定し、画像の表示したい範囲を選んでください。

注意: height, width, offset_left, offset_top の各パラメータのうちいずれか一つを設定した場合、全てのサイズパラメータを設定しなければなりません。



OAuth 署名ジェネレータ

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



リクエスト例

POST

https://api.twitter.com/1.1/account/update_profile_banner.json?width=1500&height=500&offset_top=0&offset_left=0&banner=FILE_DATA