The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

WWW::Vimeo::Simple::Group - Group requests for the Vimeo Simple API

VERSION

version 0.08

SYNOPSIS

This module is a full object-oriented implementation of the Vimeo Simple API. The specifications are available at http://vimeo.com/api/docs/simple-api.

Group requests implementation.

    use feature 'say';
    use WWW::Vimeo::Simple::Group;

    my $group_id = 69571;

    # create a new group object
    my $group = WWW::Vimeo::Simple::Group -> new(id => $group_id);

    # retrieve group's information
    $group -> info;

    # print group's information
    say $group -> name;
    say $group -> description;
    say $group -> url;

    # retrieve group's videos
    my $videos = $group -> videos;

    foreach my $video (@$videos) {
      say $video -> title;
      say $video -> description;
      say $video -> url;
    }

    # retrieve group's users
    my $users = $group -> users;

    foreach my $user (@$users) {
      say $user -> display_name;
      say $user -> bio;
      say $user -> url;
    }

METHODS

new( id => $group_id )

Create a WWW::Vimeo::Simple::Group object using the given group ID.

A Group object has the following attributes:

  • id

    Group ID

  • name

    Group name

  • description

    Group description

  • logo

    Group logo (header)

  • url

    URL for the group page

  • created_on

    Date the group was created

  • creator_id

    User ID of the group creator

  • creator_display_name

    Name of the User who created the group

  • creator_url

    The URL to the channel creator's profile

  • total_members

    Total # of users joined

  • total_videos

    Total # of videos posted to the group

  • total_files

    Total # of files uploaded to the group

  • total_forum_topics

    Total # of forum topics

  • total_events

    Total # of events

  • total_upcoming_events

    Total # of upcoming events

info

Fetch album info for the specified group.

videos( $page )

Fetch videos in that group, page optional (default 1). This method returns an array reference of WWW::Vimeo::Simple::Video objects.

users( $page )

Fetch users in that group, page optional (default 1)

INTERNAL SUBROUTINES

_make_url( $request )

Build a Vimeo Simple API url

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

LICENSE AND COPYRIGHT

Copyright 2011 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.