|
|
|
|
WebService::YouTube::Videos(3pm) User Contributed Perl Documentation WebService::YouTube::Videos(3pm) NAME
WebService::YouTube::Videos - Perl interface to youtube.videos.* VERSION
This document describes WebService::YouTube::Videos version 1.0.3 SYNOPSIS
use WebService::YouTube::Videos; my $api = WebService::YouTube::Videos->new( { dev_id => YOUR_DEV_ID } ); # Call API youtube.videos.list_featured my @videos = $api->list_featured; foreach my $video (@videos) { # $video->isa('WebService::YouTube::Video'); } # Call other APIs my @videos = $api->list_by_user($user); my @videos = $api->list_by_tag($tag); my $video = $api->get_details($video_id); # Parse XML my @video = $api->parse_xml($xml); # when $xml contains <video_list> my $video = $api->parse_xml($xml); # when $xml contains <video_details> DESCRIPTION
This is a Perl interface to YouTube REST API. See Developer APIs <http://youtube.com/dev> and Developer API -- REST Interface <http://youtube.com/dev_rest> for details. SUBROUTINES
/METHODS new(\%fields) Creates and returns a new WebService::YouTube::Videos object. %fields can contain parameters enumerated in "ACCESSORS" section. parse_xml($xml) Parses XML and returns the result. $xml should be an object that XML::Simple can understand. get_details( $video_id ) Returns a WebService::YouTube::Video object. $video_id is an ID of the video which you want to get details. See <http://youtube.com/dev_api_ref?m=youtube.videos.get_details> for details. list_by_tag( $tag, \%fields ) Returns an array of WebService::YouTube::Video object. $tag is a keyword string separated by a space. %fields can contain the optional parameters. page 1 <= page per_page per_page <= 100 (default 20) See <http://youtube.com/dev_api_ref?m=youtube.videos.list_by_tag> for details. list_by_user( $user ) Returns an array of WebService::YouTube::Video object. $tag is a keyword string separated by a space. %fields can contain optional parameters. See <http://youtube.com/dev_api_ref?m=youtube.videos.list_by_user> for details. list_featured( ) Returns an array of WebService::YouTube::Video object. See <http://youtube.com/dev_api_ref?m=youtube.videos.list_featured> for details. ACCESSORS dev_id Developer ID ua LWP::UserAgent object DIAGNOSTICS
dev_id is required Developer ID is required when you call API of YouTube. invalid XML The XML is not a YouTube's XML. unknown response The ut_response is neither <video_list> nor <video_details>. CONFIGURATION AND ENVIRONMENT
WebService::YouTube::Videos requires no configuration files or environment variables. DEPENDENCIES
Class::Accessor::Fast, LWP::UserAgent, XML::Simple, WebService::YouTube::Util, WebService::YouTube::Video INCOMPATIBILITIES
None reported. BUGS AND LIMITATIONS
No bugs have been reported. Please report any bugs or feature requests to "bug-webservice-youtube@rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-YouTube>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. AUTHOR
Hironori Yoshida <yoshida@cpan.org> LICENSE AND COPYRIGHT
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. perl v5.10.1 2010-08-01 WebService::YouTube::Videos(3pm)
