Go Picasa go

Go Picasa go is intended as library written in ruby to manipulate Picasa albums and photos in a easy way. The idea is to provide behaviors to ordinary objects so they can create, retrieve, update and delete albums and photos in a more object oritented way, lefting behind all the HTTP talk that was necessary previouly to interect with this service provided by Google.

This library was implemented based on the Protocol Guide version 2.0 of Picasa Web Albums Data API.

Go Picasa go is still under heavy development but it’s available for testing. We will be glad if you can do some tests and give us your feedback. Thank you.

Quick Start

On the command line, run the user_class generator to create a file with the authentication token and other stuff you need:

go-picasa-go user_class YourUserClass google_user_id, google_password

After running the command above, a file called “your_user_class.rb” will be generated at the current folder you’re at. The google user id and google password are only necessary to generate the authentication token for further operation with Go-picasa-go. It’s also important for you to know that the password is only used on this single operation. All other operations executed by the gem uses only the authentication token generated.

Usage

Your User

user = YourUserClass.new

Working with albums

To create an album:

album = Picasa::DefaultAlbum.new
album.user = user
album.title = "Title"
album.summary = "Summary"
album.location = "Location"
album.keywords = "Keyword, another keyword"
album.access = 'private' # Other options: public, protected

album.picasa_save # Returns true or false
album.picasa_save! # Raise exception in case of not being able to save the album

To update that album:

album.title = "Updating the title"

album.picasa_update # Returns true or false
album.picasa_update! # Raise exception in case of not being able to update the album

To destroy an album:

album.picasa_destroy # Returns true or false
album.picasa_destroy! # Raise exception in case of not being able to destroy the album

To retrieve all albums from an user:

user.albums

To retrieve one specific album

user.find_album album.picasa_id

Working with photos

To create a new photo:

photo = Picasa::DefaultPhoto.new
photo.album = album
photo.description = "Photo summary"
photo.file = File.open 'path/photo.jpg'

photo.picasa_save # Returns true or false
photo.picasa_save! # Raise exception in case of not being able to save the photo

To update an existing photo:

photo.title = "Updating title"
photo.description = "Updating summary"
photo.file = File.open 'path/new_photo.jpg'

photo.picasa_update # Returns true or false
photo.picasa_update! # Raise exception in case of not being able to update the photo

To destroy an existing photo:

photo.picasa_destroy # Returns true or false
photo.picasa_destroy! # Raise exception in case of not being able to delete the photo

To retrieve all photos from an album:

album.photos

To find an specific photo from an album:

album.find_photo photo.id

More detailed configuration

If you need your own classes to interact to Picasa you can do it like this:

class MyUser
  act_as_picasa_user
  has_many_picasa_albums :class_name => "MyAlbum"

  def picasa_id
    'your_google_user_id'
  end

  def auth_token
    'DQAAAHsAAAAdMyvdNfPg_iTFD-T_u6bBb-9Be...'
  end
end

class MyAlbum
  acts_as_picasa_album
  belongs_to_picasa_user :class_name => "MyUser"
  has_many_picasa_photos :class_name => "MyPhoto"
end

class MyPhoto
  acts_as_picasa_photo
  belongs_to_picasa_album :class_name => "MyAlbum"
end

We provided this kind of configuration so your classes can interact with other frameworks like Rails and inherit from ActiveRecord::Base for example.