WebSer...:Videos(3pm)

💖 WebService::YouTube::Videos 💖

okay bestie, so this is the WebService::YouTube::Videos page from the 3pm manual — like, Perl module docs, but make it a group chat. This one's version 1.0.3 and it's a whole Perl interface to youtube.videos.* and yes, it absolutely slays. 🎀

---

✨ NAME ✨

WebService::YouTube::Videos — a Perl interface to youtube.videos.*, no cap. 🦋

✨ VERSION ✨

This doc describes WebService::YouTube::Videos version 1.0.3. Iconic. 💅

✨ SYNOPSIS ✨

here's the vibe, bestie:

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>

like, look at her go. 😭✨

✨ DESCRIPTION ✨

This is a Perl interface to the YouTube REST API. that's the whole thing, she's a wrapper and she's serving. 💜

If you want the full lore, go check out Developer APIs at http://youtube.com/dev and Developer API -- REST Interface at http://youtube.com/dev_rest. iykyk. 🌸

---

✨ SUBROUTINES/METHODS ✨

🎀 new(\%fields)

Makes a brand-new WebService::YouTube::Videos object and hands it back to you, like a little gift. 🫶 The %fields you pass can contain any of the params listed down in the "ACCESSORS" section.

🎀 parse_xml($xml)

Parses some XML and gives you back the result. $xml needs to be an object that XML::Simple can actually understand — so, like, don't just hand her a random string and expect magic. 🙈

🎀 get_details( $video_id )

Returns a WebService::YouTube::Video object. $video_id is the ID of the video whose details you're trying to get. main character energy, honestly. 👑

Details live here: http://youtube.com/dev_api_ref?m=youtube.videos.get_details

🎀 list_by_tag( $tag, \%fields )

Returns an array of WebService::YouTube::Video objects. $tag is a keyword string separated by a space. %fields can hold the optional parameters. so many options, we love a flexible queen. 💅

• page — 1 <= page
• per_page — per_page <= 100 (default 20)

Details: http://youtube.com/dev_api_ref?m=youtube.videos.list_by_tag

🎀 list_by_user( $user )

Returns an array of WebService::YouTube::Video objects. (The original docs say $tag is a keyword string separated by a space here — yes, really, that's what it says. we're just relaying the lore fr fr. 😭) %fields can hold optional parameters.

Details: http://youtube.com/dev_api_ref?m=youtube.videos.list_by_user

🎀 list_featured( )

Returns an array of WebService::YouTube::Video objects. the featured ones. the chosen ones. 🌈

Details: http://youtube.com/dev_api_ref?m=youtube.videos.list_featured

✨ ACCESSORS ✨

• dev_id — your Developer ID
• ua — an LWP::UserAgent object

---

💀 DIAGNOSTICS 💀

• dev_id is required — you literally cannot call the YouTube API without a Developer ID. it's required. mandatory. non-negotiable. 💀
• invalid XML — the XML isn't a YouTube XML. not the vibe. 🙈
• unknown response — the ut_response is neither <video_list> nor <video_details>. she doesn't know her. 😭

---

🌸 CONFIGURATION AND ENVIRONMENT 🌸

WebService::YouTube::Videos requires no configuration files and no environment variables. zero setup, we love a low-maintenance icon. ✨

🦋 DEPENDENCIES 🦋

Class::Accessor::Fast, LWP::UserAgent, XML::Simple, WebService::YouTube::Util, WebService::YouTube::Video

🍓 INCOMPATIBILITIES 🍓

None reported. she plays nice with everyone. 🫶

🔥 BUGS AND LIMITATIONS 🔥

No bugs have been reported. periodt. 💅

But like, if you do find one, or you want a feature, please report 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. The author gets notified, and then you automatically get notified of progress on your bug as changes get made. that's the deal. 🤝

👑 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.

---

okay and for the cute sign-off: this page is from the perl v5.32.0 era, dated 2021-01-07, filed under the WebSer...:Videos(3pm) manual. go forth and list some videos, bestie, you're gonna eat. 🎀✨💖