サイトのトップへ戻る

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




GET users/profile_banner

指定したユーザーのプロフィールバナーとして使用できるサイズバリエーションのマップを取得します。 このユーザーにプロフィールバナーがアップロードされていない場合、HTTP 404を返します。 プロフィール画像とプロフィールバナーで説明されているように、 user オブジェクトから取得できるprofile_banner_urlの文字列を手動で変更するやり方の代替手段として、このメソッドを使用することができます。

プロフィールバナーデータの各種サイズURLに使用できるのは PNG 形式です。



リソース URL

https://api.twitter.com/1.1/users/profile_banner.json



リソース情報

応答形式
JSON
認証は必要ですか?
はい (user context only)
レート制限はありますか?
はい
リクエスト回数 / 15分 window (ユーザー認証の場合)
180


パラメータ

このメソッドを実行する場合、user_id か screen_nameのどちらかは常に設定してください。

user_id 任意

結果を取得するユーザーのID。ユーザーIDとスクリーンネームが同じ場合に、どちらを指定しているのか明確にするために使います。

サンプル値: 12345

screen_name 任意

結果を取得るユーザーのスクリーンネーム。スクリーンネームとユーザーIDが同じ場合に、どちらを指定しているのか明確にするために使います。

サンプル値: noradio



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/users/profile_banner.json?screen_name=twitterapi

応答結果の例

{
  "sizes": {
    "ipad": {
      "h": 313,
      "w": 626,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/ipad"
    },
    "ipad_retina": {
      "h": 626,
      "w": 1252,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/ipad_retina"
    },
    "web": {
      "h": 260,
      "w": 520,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/web"
    },
    "web_retina": {
      "h": 520,
      "w": 1040,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/web_retina"
    },
    "mobile": {
      "h": 160,
      "w": 320,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/mobile"
    },
    "mobile_retina": {
      "h": 320,
      "w": 640,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/mobile_retina"
    },
    "300x100": {
      "h": 100,
      "w": 300,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/300x100"
    },
    "600x200": {
      "h": 200,
      "w": 600,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/600x200"
    },
    "1500x500": {
      "h": 500,
      "w": 1500,
      "url": "https://pbs.twimg.com/profile_banners/6253282/1347394302/1500x500"
    }
  }
}