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.