Packagesk.prasa.webapis.picasa
Classpublic final class PicasaService

See also

sk.prasa.webapis.picasa.PicasaResponder
http://code.google.com/apis/picasaweb/


Public Properties
 PropertyDefined by
  access : String

Visibility values let you request data at various levels of sharing.

PicasaService
  albums : Albums
[read-only] Bridge to Album methods
PicasaService
  auth : Auth
[read-only]

Bridge to Authentication methods

Authentication to picasaweb can be done in two ways.

PicasaService
  comments : Comments
[read-only] Bridge to Comments methods
PicasaService
  community : Community
[read-only] Bridge to Community methods
PicasaService
  contacts : Contacts
[read-only] Bridge to Contacts methods
PicasaService
  FEED_API_URL : String = "http://photos.googleapis.com/data/feed/api/"
[static] Picasaweb API access point.
PicasaService
  FEED_BASE_URL : String = "http://photos.googleapis.com/data/feed/base/"
[static] Picasaweb BASE access point.
PicasaService
  imgmax : String

Image size parameter

Valid with album or photo kinds; specifies what image size to use for the media:content.

PicasaService
  max_results : int

Maximum number of results to be retrieved

For any service that has a default max-results value (to limit default feed size), you can specify a very large number if you want to receive the entire feed.

PicasaService
  photos : Photos
[read-only] Bridge to Photos methods
PicasaService
  POLICY_FILE_URL : String = "http://photos.googleapis.com/data/crossdomain.xml"
[static] Picasaweb service doesn't have its crossdomain.xml file at the root of the host, so we have to load manualy.
PicasaService
  start_index : int

1-based index of the first result to be retrieved

Used to page through the result set.

PicasaService
  tags : Tags
[read-only] Bridge to Tags methods
PicasaService
  thumbsize : String

Thumbnail size parameter

Valid with album or photo kinds; specifies what image size to use for thumbnails.

PicasaService
Public Methods
 MethodDefined by
  
PicasaService Constructor Constructing a PicasaService object and loading albums for given user:
   import sk.prasa.webapis.picasa.PicasaService;
   import sk.prasa.webapis.picasa.PicasaResponder;
   import sk.prasa.webapis.picasa.events.PicasaDataEvent;
   
   var service : PicasaService = new PicasaService();
     service.imgmax = "320";
     service.thumbsize = "64c";
     service.max_results = 10;
     
   var responder : PicasaResponder = service.albums.list('username'); 
     responder.addEventListener(PicasaDataEvent.DATA, onCompleteHandler);
     responder.addEventListener(IOErrorEvent.IO_ERROR, onErrorHandler);
     
   
PicasaService
Property detail
accessproperty
access:String  [read-write]

Visibility values let you request data at various levels of sharing. For example, a visibility value of public requests publicly visible data. For a list of values, see Visibility values, below. If you don't specify a visibility value, then the visibility depends on your authentication. For authenticated requests, the default is all. For unauthenticated requests, the default is public.

The URI of a representation of a Picasa Web Albums feed takes the following form: http://picasaweb.google.com/data/feed/projection/path?kind=kind&access=visibility

The following table describes the supported visibility values:

Visibility Description Security Notes
all Shows both public and private data.Requires authentication. Default for authenticated users.
private Shows only private data. Requires authentication.
public Shows only public data. Does not require authentication. Default for unauthenticated users.
Implementation
    public function get access():String
    public function set access(value:String):void

See also

albumsproperty 
albums:Albums  [read-only]

Bridge to Album methods

Implementation
    public function get albums():Albums

See also

authproperty 
auth:Auth  [read-only]

Bridge to Authentication methods

Authentication to picasaweb can be done in two ways.
ClientLogin - this method is used by installed Desktop Apps.
AuthSub - this is the default method for web applications. However, this is not yet supported because of crossdomain.xml issue and Google Auth API.

Implementation
    public function get auth():Auth

See also

commentsproperty 
comments:Comments  [read-only]

Bridge to Comments methods

Implementation
    public function get comments():Comments

See also

communityproperty 
community:Community  [read-only]

Bridge to Community methods

Implementation
    public function get community():Community

See also

contactsproperty 
contacts:Contacts  [read-only]

Bridge to Contacts methods

Implementation
    public function get contacts():Contacts

See also

FEED_API_URLproperty 
public static var FEED_API_URL:String = "http://photos.googleapis.com/data/feed/api/"

Picasaweb API access point. Reflects the "api" projection value. Updatability is r/w when the user of the content is authenticated.

See also

FEED_BASE_URLproperty 
public static var FEED_BASE_URL:String = "http://photos.googleapis.com/data/feed/base/"

Picasaweb BASE access point. Reflects the "base" projection value. Used by feed readers. This is read only.

See also

imgmaxproperty 
imgmax:String  [read-write]

Image size parameter

Valid with album or photo kinds; specifies what image size to use for the media:content. Only a single value may be specified. Refer to the list of valid values below.

Implementation
    public function get imgmax():String
    public function set imgmax(value:String):void

See also

max_resultsproperty 
max_results:int  [read-write]

Maximum number of results to be retrieved

For any service that has a default max-results value (to limit default feed size), you can specify a very large number if you want to receive the entire feed. See the Google Data query parameter reference below.

Implementation
    public function get max_results():int
    public function set max_results(value:int):void

See also

photosproperty 
photos:Photos  [read-only]

Bridge to Photos methods

Implementation
    public function get photos():Photos

See also

POLICY_FILE_URLproperty 
public static var POLICY_FILE_URL:String = "http://photos.googleapis.com/data/crossdomain.xml"

Picasaweb service doesn't have its crossdomain.xml file at the root of the host, so we have to load manualy.

start_indexproperty 
start_index:int  [read-write]

1-based index of the first result to be retrieved

Used to page through the result set. See the Google Data query parameter reference below.

Note that this isn't a general cursoring mechanism. If you first send a query with
?start-index=1&max-results=10 and then send another query with
?start-index=11&max-results=10, the service cannot guarantee that the results are equivalent to
?start-index=1&max-results=20, because insertions and deletions could have taken place in between the two queries.

Implementation
    public function get start_index():int
    public function set start_index(value:int):void

See also

tagsproperty 
tags:Tags  [read-only]

Bridge to Tags methods

Implementation
    public function get tags():Tags

See also

thumbsizeproperty 
thumbsize:String  [read-write]

Thumbnail size parameter

Valid with album or photo kinds; specifies what image size to use for thumbnails. Multiple values may be specified using a comma-delimited list. If multiple values are specified, multiple media:thumbnail elements will be returned in the feed. Refer to the list of valid values below.

The following values are valid for the thumbsize and imgmax query parameters and are embeddable on a webpage. These images are available as both cropped(c) and uncropped(u) sizes by appending c or u to the size. As an example, to retrieve a 72 pixel image that is cropped, you would specify 72c, while to retrieve the uncropped image, you would specify 72u for the thumbsize or imgmax query parameter values.

32, 48, 64, 72, 144, 160

The following values are valid for the thumbsize and imgmax query parameters and are embeddable on a webpage. These images are available as only uncropped(u) sizes by appending u to the size or just passing the size value without appending anything.

200, 288, 320, 400, 512, 576, 640, 720, 800

The following values are valid for the thumbsize and imgmax query parameters and are not embeddable on a webpage. These image sizes are only available in uncropped format and are accessed using only the size (no u is appended to the size).

912, 1024, 1152, 1280, 1440, 1600

There is an additional size d which results in the elements referencing the original uploaded photo, including all original Exif data. It is valid only for use with the imgmax query parameter.

These query parameters are used when retrieving the feeds in order to get images of the appropriate sizes. They cannot be used when retrieving the actual images.

Implementation
    public function get thumbsize():String
    public function set thumbsize(value:String):void

See also

Constructor detail
PicasaService()constructor
public function PicasaService()

PicasaService Constructor Constructing a PicasaService object and loading albums for given user:

   import sk.prasa.webapis.picasa.PicasaService;
   import sk.prasa.webapis.picasa.PicasaResponder;
   import sk.prasa.webapis.picasa.events.PicasaDataEvent;
   
   var service : PicasaService = new PicasaService();
     service.imgmax = "320";
     service.thumbsize = "64c";
     service.max_results = 10;
     
   var responder : PicasaResponder = service.albums.list('username'); 
     responder.addEventListener(PicasaDataEvent.DATA, onCompleteHandler);
     responder.addEventListener(IOErrorEvent.IO_ERROR, onErrorHandler);