NAME

WebService::GData::Feed::Category - Represent an xml category tag.

SYNOPSIS

    use WebService::GData::Feed;
    
    my $feed = new WebService::GData::Feed($jsonfeed);
    
    my $categories=  $feed->category();
   
    foreach my $category (@$categories){
       #print $category->scheme,$category->term,$category->label;
    }

DESCRIPTION

inherits from WebService::GData::Feed

This package wraps the category data found in a feed using the json format of the Google Data API v2 (no other format is supported!).

CONSTRUCTOR

new

Accept the content of the category tag from a feed that has been perlified (from_json($json_string)).

Parameters

category_info:HashRef - category data coming from a json feed.

Returns

WebService::GData::Feed::Category

Throws

WebService::GData::Error - invalid_parameter_type if it is not an hash reference.

Example:

    use WebService::GData::Feed::Category;
    
    my $category = new WebService::GData::Feed::Category($jsonfeed->{category}->[0]);
    
    #or
    my $category = new WebService::GData::Feed::Category({
        scheme => 'http://gdata.youtube.com/schemas/2007/categories.cat',
        term => 'Shows',
        label => 'Shows',
    });    
    
    $category->term();#Shows

GET/SET METHODS

scheme

get/set the scheme of the category.

Parameters

none - as a getter

scheme:Scalar as a setter

Returns

none - as a setter

scheme:Scalar as a getter

Example:

    use WebService::GData::Feed::Category;
    
    my $category = new WebService::GData::Feed::Category($jsonfeed->{category}->[0]);
    
    $category->scheme("http://schemas.google.com/g/2005#kind");
    
    $category->scheme();#http://schemas.google.com/g/2005#kind

term

get/set the term of the category.

Parameters

none - as a getter

term:Scalar as a setter

Returns

none - as a setter

term:Scalar as a getter

Example:

    use WebService::GData::Feed::Category;
    
    my $category = new WebService::GData::Feed::Category($jsonfeed->{category}->[0]);
    
    $category->term("http://gdata.youtube.com/schemas/2007#video");
    
    $category->term();#http://gdata.youtube.com/schemas/2007#video

label

get/set the label of the category.

Parameters

none - as a getter

label:Scalar as a setter

Returns

none - as a setter

label:Scalar as a getter

Example:

    use WebService::GData::Feed::Category;
    
    my $category = new WebService::GData::Feed::Category($jsonfeed->{category}->[0]);
    
    $category->label("comedy");
    
    $category->label();#comedy

BUGS AND LIMITATIONS

If you do me the favor to _use_ this module and find a bug, please email me i will try to do my best to fix it (patches welcome)!

AUTHOR

shiriru <shirirulestheworld[arobas]gmail.com>

LICENSE AND COPYRIGHT

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.