FlickrとPicasaへの画像アップロード

お仕事でいろんな写真サイトに手元の写真をアップロードするというのをやる予定です。
それに先駆けて、APIも整備されていて有名なところということで、FlickrとPicasaに挑戦してみた。

基本的に、作るのはDjangoのWebApplicationです。
WebApplicationの場合は、Flickr,Picasaとも、基本的に、ユーザからそれぞれのサイトの
ユーザ名とパスワードを預かるのは、さすがに、なんか気持ち悪いですよね、
というのに対処された認証になっているようです。
なんか世の中には、意外にその手のサンプルが少ないようなので、書いてみる。
まあ、ドキュメント読めば、普通に書いてるんだけど。

FlickrとPicasa(というか、Google)は、どちらもトークンというものを
ユーザ操作によって取得し、それを使ってユーザの画像を操作できます。
＃Googleは、OAuthにも対応しているようですが、ライブラリが対応していないっぽいので、
＃実績もあるしー、とかいう弱腰で、AuthSub方式を使いました。

とりあえず、どちらのサイトも、流れは以下になるようです。
・まず、各サイトへの認証URLを生成する
・そのURLへのリンクをクリックさせるか、リダイレクトする
・そのサイトで、このアプリから認証を要求されてるけど、承認するか？ページが表示される
・Cookieとかで認証済みなら、ボタン押すだけか、認証画面からログイン
　すると、自分のアプリサイト（事前に指定済み）のURLへリダイレクトされる
　そのとき、GETの引数として、トークンかそれに準ずるもの(flickrでは、frobというらしい)が渡される
・それを使って、永続的に利用できるトークンを取得する（昇格させる）
・それ以降は、それを使って、アップロード等の操作を行う

こっからは、実際のPythonででっちあげたサンプルコード(Djangoでサイト構築をした場合です。)
Flickrは、flickrpyを利用しました。
いまいち、これ以外に、トークンを使った認証にうまく対応しているライブラリを
見つけられませんでした。

とりあえず、FlickrでAPI Keyを取得します。
そのときに、認証後の戻り先のURL指定があるので、
http://xxx.xxx.xxx.xxx/flickr/gotFrob
というようなURLを指定しておきます。このURLでfrobを取得します。

とりあえず、viewだけ貼り付け。urlconfとかは適当に書く必要がもちろんあります。
あとは、Photoというモデルをつかってるけど、たいしたものでないので、省略。
とりあえず、やっつけこーど。さらに、!!!とか書いてるところはチョー適当。
ほんとは、生成したfrobをちゃんと覚えといて、ユーザとひも付けしないとだめだけど、
そこは適当に今は、渡されたfrobからtokenを取得して、ファイルに保存してるだけ。

from flickrapi import FlickrAPI

FLICKR_TOKEN = u'xxxx'
FLICKR_TOKEN_FILE_PATH = u'flickr_token.txt'
FLICKR_API_KEY = u'yyyy'
FLICKR_API_SECRET = u'zzzz'
FLICKR_PERMISSION = u'delete'

def get_flickr_api(token=None):
  if token is None:
    return FlickrAPI(FLICKR_API_KEY, FLICKR_API_SECRET, format='etree')
  else:
    return FlickrAPI(FLICKR_API_KEY, FLICKR_API_SECRET, token=token, format='etree')


def flickr_redirect_to_login(request):
  flickr = get_flickr_api()
  response = flickr.auth_getFrob()
  frob = None
  if response.attrib['stat'] == u'ok':
    frob = response.findtext('frob')
  else:
    # !!!
    return HttpResponse('Error')

  return HttpResponseRedirect(flickr.auth_url(perms='delete', frob=frob))

def flickr_got_frob(request):
  if request.method == 'GET':
    frob = request.GET['frob']
    flickr = get_flickr_api()
    response = flickr.auth_getToken(frob=frob)
    token = None
    if response.attrib['stat'] == u'ok':
      token = response.findtext('auth/token')
    else:
      # !!!
      return HttpResponse('Error')

  token_file = file(FLICKR_TOKEN_FILE_PATH, 'w')
  token_file.write(token)
  token_file.close()

  return render_to_response('flickr/flickr_got_token.html',
                            dict(frob=frob, token=token))

def flickr_upload(request):
  if request.method == 'GET':
    photo_id = request.GET['photo_id']
    photo = Photo.objects.all().filter(photo_id=photo_id).get()
    token_file = file(FLICKR_TOKEN_FILE_PATH, 'r')
    FLICKR_TOKEN = token_file.read()
    token_file.close()
    flickr = get_flickr_api(token=FLICKR_TOKEN)
    response = flickr.upload(filename=photo.get_photo_url().encode('utf-8'), title=photo.caption)
    flickr_photo_id = None
    if response.attrib['stat'] == 'ok':
      flickr_photo_id = response.findtext('photoid')
    else:
      # !!!
      return HttpResponse('Error')

  return render_to_response('flickr/flickr_upload.html',
                            dict(photo_id = photo_id, flickr_photo_id = flickr_photo_id))

流れは、
ユーザ操作によって、flickr_redirect_to_loginが呼び出されます。
すると、flickrの認証画面にとばされます。
んで、flickr_got_frobに帰ってきて、frobを使って、flickrからtokenを取得します。
んで、それを使って、flickr_uploadをつかって、アップロードする。

次は、Picasaの場合、同様にDjango前提。
gdata-python-clientで、AuthSubを利用します。
Picasaの場合は、事前にAPI等を取得するわけではなく、URL生成時に戻り先を指定する。
なんかアプリを事前に登録することで、
アプリ名とかがちゃんとGoogle側でも表示されるらしいので、やったほうがいいかも。
Picasaの場合は、frobのようなものはなく、１回限りのtokenという扱いで、それをsessionトークンに昇格させる。

ポイントは、これはバグだろーみたいな投稿もGoogle Codeであったけど、
Picasaの場合は、対アルバムにしかアップロードできないので、
InsertAlbumをとりあえずやってアルバムを作ってやろうとするけど、
こいつが対象のURLを生成する際に、self.emailを利用しようとする。
これは、ClientLogin()を使う場合は、email,passwordを指定しているから問題ないのだけど、
事前取得済みのsession tokenを使う場合、emailはわからない場合が普通。
そういうときは、Googleでは、'default'をURLとして指定すると、ユーザを勝手にGoogle側で決めてくれるようだ。
（これを調べるのに、ずいぶん手間取った。。。）
というわけで、本来なら、ライブラリ側のコード自体を、emailがNoneなら、defaultにするみたいするべきだけど、
ちょっとめんどくさかったので、emailに'default'をさくっと呼び出す前に代入した。
これで、とりあえず、うまくいくようにはなった。ただ、これはあまりにもやっつけすぎるかも。

import gdata.photos.service

PICASA_TOKEN = ''
PICASA_TOKEN_FILE_PATH = u'picasa_token.txt'

def picasa_redirect_to_login(request):
  gd_client = gdata.photos.service.PhotosService()
  auth_url = gd_client.GenerateAuthSubURL(next='http://xxx.xxx.xxx.xxx/picasa/got_token',
                                       scope='http://picasaweb.google.com/data/',
                                       secure=False, session=True)
  return HttpResponseRedirect(auth_url)

def picasa_got_token(request):
  if request.method == 'GET':
    token = request.GET['token']
    gd_client = gdata.photos.service.PhotosService()
    gd_client.SetAuthSubToken(token)
    gd_client.UpgradeToSessionToken()
    token_file = file(PICASA_TOKEN_FILE_PATH, 'w')
    token_file.write(gd_client.GetAuthSubToken())
    token_file.close()
    return HttpResponse('session token is %s' % (gd_client.GetAuthSubToken()))
  else:
    # !!!
    return HttpResponse('Error')

def picasa_upload(request):
  if request.method == 'GET':
    photo_id = request.GET['photo_id']
    import sys
    photo = Photo.objects.all().filter(photo_id=photo_id).get()
    gd_client = gdata.photos.service.PhotosService()
    PICASA_TOKEN = file(PICASA_TOKEN_FILE_PATH, 'r').read()
    gd_client.SetAuthSubToken(PICASA_TOKEN)
    # bad techs
    gd_client.email = 'default'
    response = gd_client.InsertAlbum('test', 'test')
    album_url = response.GetFeedLink().href
    response = gd_client.InsertPhotoSimple(album_url, photo.caption, photo.comment, photo.get_photo_url())
    return HttpResponse('picasa photo link is here' % response.GetSelfLink().href)
  else:
    # !!!
    return HttpResponse('Error')

長くなったので、これでやめとこう。
とりあえず、こんな感じ。