authenticator

user_agent

service_base_url

xml_namespaces

    {
        'http://search.yahoo.com/mrss/'         => 'media',
        'http://schemas.google.com/photos/2007' => 'gphoto',
        'http://www.georss.org/georss'          => 'georss',
        'http://www.opengis.net/gml'            => 'gml',
    }

You may add more namespaces to this list, if needed.

new

  my $service = Net::Google::PicasaWeb->new(%params);

See the "ATTRIBUTES" section for a list of possible parameters.

login

  my $success = $service->login($username, $password, %options);

This is a shortcut for performing:

  $service->authenticator->login($username, $password, %options);

It has some additional error handling. This method will return a true value on success or die on error.

See Net::Google::AuthSub.

list_albums

  my @albums = $service->list_albums(%params);

This will list a set of albums available from Picasa Web Albums. If no %params are set, then this will list the albums belonging to the authenticated user. If the user is not authenticated, this will probably not return anything. Further control is gained by specifying one or more of the following parameters:

user_id

This is the user ID to request a list of albums from. The defaults to "default", which lists those belonging to the current authenticated user.

This method also takes the "STANDARD LIST OPTIONS".

get_album

  my $album = $service->get_album(
      user_id  => 'hanenkamp',
      album_id => '5143195220258642177',
  );

This will fetch a single album from the Picasa Web Albums using the given "user_id" and "album_id". If "user_id" is omitted, then "default" will be used instead.

This method returns "undef" if no such album exists.

list_tags

This method accepts this parameters:

user_id

The ID of the user to find tags for. Defaults to the current user.

This method also takes all the "STANDARD LIST OPTIONS".

list_comments

It accepts the following parameters:

user_id

This is the ID of the user to search for comments within. The comments returned will be commons on photos owned by this user. The default is to search the comments of the authenticated user.

This method also accepts the "STANDARD LIST OPTIONS".

get_comment

  my $comment = $service->get_comment(
      user_id    => $user_id,
      album_id   => $album_id,
      photo_id   => $photo_id,
      comment_id => $comment_id,
  );

Retrieves a single comment from Picasa Web via the given "user_id", "album_id", "photo_id", and "comment_id". If "user_id" is not given, "default" will be used.

Returns "undef" if no matching comment is found.

list_media_entries

list_photos

list_videos

It accepts the following parameters:

user_id

If given, the photos will be limited to those owned by this user. If it is set to "default", then the authenticated user will be used. If no "user_id" is set, then the community feed will be used rather than a specific user. This option may not be combined with "featured".

featured

This can be set to a true value to fetch the current featured photos on PicasaWeb. This option is not compatible with "user_id".

This method also accepts the "STANDARD LIST OPTIONS".

The "list_photos" and "list_videos" methods are synonyms for "list_media_entries".

get_media_entry

get_photo

get_video

  my $media_entry = $service->get_media_entry(
      user_id  => $user_id,
      album_id => $album_id,
      photo_id => $photo_id,
  );

Returns a specific photo or video entry when given a "user_id", "album_id", and "photo_id". If "user_id" is not given, "default" will be used.

If no such photo or video can be found, "undef" will be returned.

request

  my $response = $service->request($method, $path, $query, $content);

This handles the details of making a request to the Google Picasa Web API.

get_entry

  my $entry = $service->get_entry($class, $path, %params);

This is used by the "get_*" methods to pull and initialize a single object from Picasa Web.

list_entries

  my @entries = $service->list_entries($class, $path, %params);

This is used by the "list_*" methods to pull and initialize lists of objects from feeds.