Permalink
Browse files

Added list_ownerships; released 0.12003

  • Loading branch information...
semifor committed May 3, 2013
1 parent 291e407 commit 6416d6219b5d4eeaeba03991ef899462c24f3cb1
Showing with 47 additions and 11 deletions.
  1. +3 −0 Changes
  2. +1 −1 lib/Net/Twitter/Lite.pm
  3. +15 −3 lib/Net/Twitter/Lite/API/V1_1.pm
  4. +28 −7 lib/Net/Twitter/Lite/WithAPIv1_1.pod
View
@@ -1,3 +1,6 @@
+0.12003 2013-04-25
+ - Added list_ownerships
+
0.12002 2013-03-11
- 30 second delay in OAuth requests fixed with Net::HTTP 6.06
View
@@ -9,7 +9,7 @@ Net::Twitter::Lite - A perl library for Twitter's API v1
=cut
-our $VERSION = '0.12002';
+our $VERSION = '0.12003';
use Carp;
use URI::Escape;
@@ -686,11 +686,11 @@ sub api_def () { +[
} ],
# Lists
- [ 'all_subscriptions', {
- aliases => [ qw/all_lists list_subscriptions/ ],
+ [ 'get_lists', {
+ aliases => [ qw/list_lists all_subscriptions/ ],
path => 'lists/list',
method => 'GET',
- params => [ qw/user_id screen_name/ ],
+ params => [ qw/user_id screen_name reverse/ ],
required => [ qw// ],
add_source => 0,
deprecated => 0,
@@ -902,6 +902,18 @@ sub api_def () { +[
booleans => [ qw// ],
base_url_method => 'apiurl',
} ],
+ [ 'list_ownerships', {
+ aliases => [],
+ path => 'lists/ownerships',
+ method => 'GET',
+ params => [ qw/user_id screen_name count cursor/ ],
+ required => [ qw// ],
+ add_source => 0,
+ deprecated => 0,
+ authenticate => 1,
+ booleans => [ qw// ],
+ base_url_method => 'apiurl',
+ } ],
# Saved Searches
[ 'saved_searches', {
@@ -968,26 +968,32 @@ Returns: List
=item B<get_lists>
-
-=item alias: list_lists
-
=item alias: all_subscriptions
+=item alias: list_lists all_subscriptions
+
=over 4
-=item Parameters: user_id, screen_name
+=item Parameters: user_id, screen_name reverse
=item Required: I<none>
=back
Returns all lists the authenticating or specified user subscribes to, including
-their own. The user is specified using the C<user_id> or C<screen_name> parameters.
+their own. The user is specified using the user_id or screen_name parameters.
If no user is given, the authenticating user is used.
+A maximum of 100 results will be returned by this call. Subscribed lists are
+returned first, followed by owned lists. This means that if a user subscribes
+to 90 lists and owns 20 lists, this method returns 90 subscriptions and 10
+owned lists. The reverse method returns owned lists first, so with C<reverse =>
+1>, 20 owned lists and 80 subscriptions would be returned. If your goal is to
+obtain every list a user owns or subscribes to, use <list_ownerships> and/or
+C<list_subscriptions> instead.
-Returns: Hashref
+Returns: ArrayRef[Lists]
=item B<get_privacy_policy>
@@ -1767,7 +1773,7 @@ Subscribes the authenticated user to the specified list.
Returns: List
-=item B<subscriptions>
+=item B<list_subscriptions>
@@ -1777,6 +1783,8 @@ Returns: List
=item Required: I<none>
+=item Aliases: subscriptions
+
=back
Obtain a collection of the lists the specified user is subscribed to, 20 lists
@@ -1785,6 +1793,19 @@ per page by default. Does not include the user's own lists.
Returns: ArrayRef[List]
+=item B<list_ownerships>
+
+=over 4
+
+=item Parameters: user_id screen_name count cursor
+
+=back
+
+Obtain a collection of the lists owned by the specified Twitter user. Private
+lists will only be shown if the authenticated user is also the owner of the lists.
+
+Returns: Hashref
+
=item B<suggestion_categories>

0 comments on commit 6416d62

Please sign in to comment.