サイトのトップへ戻る

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

プロフィール画像とプロフィールバナー



プロフィール画像

Profile images (or avatars) are an important component of a Twitter account’s expression of identity. ユーザーの代わりになるアバターをアップロードするには、 POST account / update_profile_imageを使用してください。



ユーザープロフィール画像で使用できる画像サイズ

You can obtain a user’s most recent profile image, along with the other components comprising their identity on Twitter, from GET users/show. user オブジェクトからは、profile_image_urlフィールド とprofile_image_url_httpsフィールドを取得できます。 一般的には、これらのフィールドはユーザーのアップロード画像をリサイズした “normal”を保持しています。 “normal” は通常 48px x 48px です。

URLを変更することによって、 “bigger”, “mini”, and “original”のような他のサイズの画像を取得することができます。 詳細な例については以下の表を参照してください:

バリエント サイズ URL例
normal 48px x 48px http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png
https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png
bigger 73px x 73px http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_bigger.png
https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_bigger.png
mini 24px x 24px http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_mini.png
https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_mini.png
original original http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3.png
https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3.png
オリジナル画像を取得するには、URLからアンダースコアとバリエント指定を省いてください。この画像は非常に大きなサイズになる可能性があります。


既定のプロフィール画像

ユーザーによってはプロフィール画像をアップロードしていない場合もあります。現在Twitterの既定アバター画像はカラフルな背景に卵が描かれるので、そうしたユーザーは 親しみをこめて “eggs” と呼ばれます。プロフィール画像をアップロードしていないユーザーは、Userオブジェクトの default_profile_imageフィールドの値がtrueになっているので、そこから判別できます。

ユーザーが“egg”として表示されている場合、profile_image_urlprofile_image_url_httpsに設定されるURLはhttp://a0.twimg.com/sticky/default_profile_images/default_profile_6_normal.pngのようになります。



SSL対応のプロフィール画像

プロフィール画像の SSL対応パスは、 profile_image_url_httpsに設定されています。 The table above demonstrates how to apply the same variant selection techniques to SSL-based images.



既に変更されたプロフィール画像

プロフィール画像にアクセスしようとした時に 403 エラーや 404 エラーが発生した場合は、GET users/showを使ってuser オブジェクトを更新し、 最新のprofile_image_urlprofile_image_url_httpsを使うようにしてください。 例えば、ユーザーがプロフィール画像を更新した時にURLが変更されます。



プロフィールバナー

プロフィールバナーは最近Twitter に追加され、ユーザーは自分のプロフィールをさらにカスタマイズして表現できるようになりました。 Profile banners come in a variety of display-enhanced sizes. GET users / profile_bannerに対してのリクエストや、userオブジェクト内の profile_banner_url コンポネントパスの文末を編集する際に、バリエント値を使ってサイズを指定することができます。

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

以下のサイズが使用できます。:

サイズ URL例
1500x500 https://pbs.twimg.com/profile_banners/783214/1347405327/1500x500
600x200 https://pbs.twimg.com/profile_banners/783214/1347405327/600x200
300x100 https://pbs.twimg.com/profile_banners/783214/1347405327/300x100
ラベル サイズ
web 520x260 https://pbs.twimg.com/profile_banners/6253282/1347394302/web
web_retina 1040x520 https://pbs.twimg.com/profile_banners/6253282/1347394302/web_retina
ipad 626x313 https://pbs.twimg.com/profile_banners/6253282/1347394302/ipad
ipad_retina 1252x626 https://pbs.twimg.com/profile_banners/6253282/1347394302/ipad_retina
mobile 320x160 https://pbs.twimg.com/profile_banners/6253282/1347394302/mobile
mobile_retina 640x320 https://pbs.twimg.com/profile_banners/6253282/1347394302/mobile_retina