twitter4j.api.ListsResources Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of twitter4j-core Show documentation
Show all versions of twitter4j-core Show documentation
A Java library for the Twitter API
/*
* Copyright 2007 Yusuke Yamamoto
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package twitter4j.api;
import twitter4j.*;
/**
* @author Joern Huxhorn - jhuxhorn at googlemail.com
*/
public interface ListsResources {
/**
* List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user whose lists are being returned.
*
This method calls https://api.twitter.com/1.1/lists.json
*
* @param listOwnerScreenName The screen name of the list owner
* as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/list | Twitter Developers
* @since Twitter4J 2.1.0
*/
ResponseList getUserLists(String listOwnerScreenName)
throws TwitterException;
/**
* List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user whose lists are being returned.
*
This method calls https://api.twitter.com/1.1/lists.json
*
* @param listOwnerScreenName The screen name of the list owner
* as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param reverse Set this to true if you would like owned lists to be returned first
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/list | Twitter Developers
* @since Twitter4J 4.0.4
*/
ResponseList getUserLists(String listOwnerScreenName, boolean reverse)
throws TwitterException;
/**
* List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user whose lists are being returned.
*
This method calls https://api.twitter.com/1.1/lists.json
*
* @param listOwnerUserId The id of the list owner
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/list | Twitter Developers
* @since Twitter4J 2.2.3
*/
ResponseList getUserLists(long listOwnerUserId)
throws TwitterException;
/**
* List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user whose lists are being returned.
*
This method calls https://api.twitter.com/1.1/lists.json
*
* @param listOwnerUserId The id of the list owner
* @param reverse Set this to true if you would like owned lists to be returned first
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/list | Twitter Developers
* @since Twitter4J 4.0.4
*/
ResponseList getUserLists(long listOwnerUserId, boolean reverse)
throws TwitterException;
/**
* Show tweet timeline for members of the specified list.
*
https://api.twitter.com/1/user/lists/list_id/statuses.json
*
* @param listId The id of the list
* @param paging controls pagination. Supports since_id, max_id, count and page parameters.
* @return list of statuses for members of the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/statuses | Twitter Developers
* @since Twitter4J 2.2.3
*/
ResponseList getUserListStatuses(long listId, Paging paging)
throws TwitterException;
/**
* Show tweet timeline for members of the specified list.
*
https://api.twitter.com/1/user/lists/list_id/statuses.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param paging controls pagination. Supports since_id, max_id, count and page parameters.
* @return list of statuses for members of the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/statuses | Twitter Developers
* @since Twitter4J 3.0.0
*/
ResponseList getUserListStatuses(long ownerId, String slug, Paging paging)
throws TwitterException;
/**
* Show tweet timeline for members of the specified list.
*
https://api.twitter.com/1.1/lists/statuses.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param paging controls pagination. Supports since_id, max_id, count and page parameters.
* @return list of statuses for members of the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/statuses | Twitter Developers
* @since Twitter4J 3.0.2
*/
ResponseList getUserListStatuses(String ownerScreenName, String slug, Paging paging)
throws TwitterException;
/**
* Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy.json
*
* @param listId The id of the list.
* @param userId The screen name of the member you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy | Twitter Developers
* @since Twitter4J 2.1.0
*/
UserList destroyUserListMember(long listId, long userId) throws TwitterException;
/**
* Removes the specified members from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy.json
*
* @param listId The id of the list.
* @param screenName The screen name of the member you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy | Twitter Developers
* @since Twitter4J 3.0.6
*/
UserList destroyUserListMember(long listId, String screenName) throws TwitterException;
/**
* Removes the specified members from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy_all.json
*
* @param listId The id of the list.
* @param screenNames The screen names of the members you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy_all | Twitter Developers
* @since Twitter4J 3.0.6
*/
UserList destroyUserListMembers(long listId, String[] screenNames) throws TwitterException;
/**
* Removes the specified members from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy_all.json
*
* @param listId The id of the list.
* @param userIds The array of ids of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy_all | Twitter Developers
* @since Twitter4J 3.0.6
*/
UserList destroyUserListMembers(long listId, long[] userIds) throws TwitterException;
/**
* Removes the specified members from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy_all.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param screenNames The screen names of the members you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy_all | Twitter Developers
* @since Twitter4J 3.0.6
*/
UserList destroyUserListMembers(String ownerScreenName, String slug, String[] screenNames) throws TwitterException;
/**
* Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The screen name of the member you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList destroyUserListMember(long ownerId, String slug, long userId) throws TwitterException;
/**
* Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.
*
This method calls https://api.twitter.com/1.1/lists/members/destroy.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The screen name of the member you wish to remove from the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/destroy | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList destroyUserListMember(String ownerScreenName, String slug, long userId) throws TwitterException;
/**
* List the lists the authenticating user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.2.4
*/
PagableResponseList getUserListMemberships(long cursor)
throws TwitterException;
/**
* List the lists the authenticating user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param count The amount of results to return per page. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMemberships(int count, long cursor)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberId The id of the list member
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.2.4
*/
PagableResponseList getUserListMemberships(long listMemberId, long cursor)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberId The id of the list member
* @param count The amount of results to return per page. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMemberships(long listMemberId, int count, long cursor)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberScreenName The screen name of the list member
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.1.0
*/
PagableResponseList getUserListMemberships(String listMemberScreenName, long cursor)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberScreenName The screen name of the list member
* @param count The amount of results to return per page. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.1.0
*/
PagableResponseList getUserListMemberships(String listMemberScreenName, int count, long cursor)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberScreenName The screen name of the list member
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param filterToOwnedLists Whether to return just lists the authenticating user owns, and the user represented by listMemberScreenName is a member of.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when filerToOwnedLists is true but authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.2.4
*/
PagableResponseList getUserListMemberships(String listMemberScreenName, long cursor, boolean filterToOwnedLists)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberScreenName The screen name of the list member
* @param count The amount of results to return per page. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param filterToOwnedLists Whether to return just lists the authenticating user owns, and the user represented by listMemberScreenName is a member of.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when filerToOwnedLists is true but authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMemberships(String listMemberScreenName, int count, long cursor, boolean filterToOwnedLists)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberId The id of the list member
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param filterToOwnedLists Whether to return just lists the authenticating user owns, and the user represented by listMemberId is a member of.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when filerToOwnedLists is true but authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.2.4
*/
PagableResponseList getUserListMemberships(long listMemberId, long cursor, boolean filterToOwnedLists)
throws TwitterException;
/**
* List the lists the specified user has been added to.
*
This method calls https://api.twitter.com/1.1/lists/memberships.json
*
* @param listMemberId The id of the list member
* @param count The amount of results to return per page. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param filterToOwnedLists Whether to return just lists the authenticating user owns, and the user represented by listMemberId is a member of.
* @return the list of lists
* @throws TwitterException when Twitter service or network is unavailable
* @throws IllegalStateException when filerToOwnedLists is true but authorization is not enabled
* @see GET lists/memberships | Twitter Developers
* @since Twitter4J 2.2.4
*/
PagableResponseList getUserListMemberships(long listMemberId, int count, long cursor, boolean filterToOwnedLists)
throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param listId The id of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 2.2.3
*/
PagableResponseList getUserListSubscribers(long listId, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param listId The id of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(long listId, int count, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param listId The id of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(long listId, int count, long cursor, boolean skipStatus) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 3.0.0
*/
PagableResponseList getUserListSubscribers(long ownerId, String slug, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(long ownerId, String slug, int count, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(long ownerId, String slug, int count, long cursor, boolean skipStatus) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 3.0.2
*/
PagableResponseList getUserListSubscribers(String ownerScreenName, String slug, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(String ownerScreenName, String slug, int count, long cursor) throws TwitterException;
/**
* Returns the subscribers of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws twitter4j.TwitterException when Twitter service or network is unavailable
* @see GET lists/subscribers | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscribers(String ownerScreenName, String slug, int count, long cursor, boolean skipStatus) throws TwitterException;
/**
* Make the authenticated user follow the specified list.
*
This method calls https://api.twitter.com/1.1/list/subscribers/create.json
*
* @param listId The id of the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/create | Twitter Developers
* @since Twitter4J 2.2.3
*/
UserList createUserListSubscription(long listId) throws TwitterException;
/**
* Make the authenticated user follow the specified list.
*
This method calls https://api.twitter.com/1.1/list/subscribers/create.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/create | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList createUserListSubscription(long ownerId, String slug) throws TwitterException;
/**
* Make the authenticated user follow the specified list.
*
This method calls https://api.twitter.com/1.1/list/subscribers/create.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/create | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList createUserListSubscription(String ownerScreenName, String slug) throws TwitterException;
/**
* Check if the specified user is a subscriber of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers/show.json
*
* @param listId The id of the list.
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/subscribers/show | Twitter Developers
* @since Twitter4J 2.2.3
*/
User showUserListSubscription(long listId, long userId) throws TwitterException;
/**
* Check if the specified user is a subscriber of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers/show.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/subscribers/show | Twitter Developers
* @since Twitter4J 3.0.0
*/
User showUserListSubscription(long ownerId, String slug, long userId) throws TwitterException;
/**
* Check if the specified user is a subscriber of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/subscribers/show.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/subscribers/show | Twitter Developers
* @since Twitter4J 3.0.2
*/
User showUserListSubscription(String ownerScreenName, String slug, long userId) throws TwitterException;
/**
* Unsubscribes the authenticated user form the specified list.
*
This method calls https://api.twitter.com/1.1/subscribers/destroy.json
*
* @param listId The id of the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/destroy | Twitter Developers
* @since Twitter4J 2.2.3
*/
UserList destroyUserListSubscription(long listId) throws TwitterException;
/**
* Unsubscribes the authenticated user form the specified list.
*
This method calls https://api.twitter.com/1.1/subscribers/destroy.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/destroy | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList destroyUserListSubscription(long ownerId, String slug) throws TwitterException;
/**
* Unsubscribes the authenticated user form the specified list.
*
This method calls https://api.twitter.com/1.1/subscribers/destroy.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/subscribers/destroy | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList destroyUserListSubscription(String ownerScreenName, String slug) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param listId The id of the list.
* @param userIds The array of ids of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList createUserListMembers(long listId, long... userIds) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userIds The array of ids of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList createUserListMembers(long ownerId, String slug, long... userIds) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userIds The array of ids of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList createUserListMembers(String ownerScreenName, String slug, long... userIds) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param listId The id of the list.
* @param screenNames The array of screen names of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 2.1.7
*/
UserList createUserListMembers(long listId, String... screenNames) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param screenNames The array of screen names of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList createUserListMembers(long ownerId, String slug, String... screenNames) throws TwitterException;
/**
* Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members, and you are limited to adding up to 100 members to a list at a time with this method.
*
This method calls https://api.twitter.com/1.1/lists/members/create_all.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param screenNames The array of screen names of the user to add as member of the list. up to 100 are allowed in a single request.
* @return the list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create_all | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList createUserListMembers(String ownerScreenName, String slug, String... screenNames) throws TwitterException;
/**
* Check if a user is a member of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members/show.json
*
* @param listId The id of the list.
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/members/show | Twitter Developers
* @since Twitter4J 2.2.3
*/
User showUserListMembership(long listId, long userId) throws TwitterException;
/**
* Check if a user is a member of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members/show.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/members/show | Twitter Developers
* @since Twitter4J 3.0.0
*/
User showUserListMembership(long ownerId, String slug, long userId) throws TwitterException;
/**
* Check if a user is a member of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members/show.json
*
* @param ownerScreenName Id The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user who you want to know is a member or not of the specified list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
* @see GET lists/members/show | Twitter Developers
* @since Twitter4J 3.0.2
*/
User showUserListMembership(String ownerScreenName, String slug, long userId) throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param listId The id of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 2.2.3
*/
PagableResponseList getUserListMembers(long listId, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param listId The id of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(long listId, int count, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param listId The id of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(long listId, int count, long cursor, boolean skipStatus)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 3.0.0
*/
PagableResponseList getUserListMembers(long ownerId, String slug, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(long ownerId, String slug, int count, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(long ownerId, String slug, int count, long cursor, boolean skipStatus)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 3.0.2
*/
PagableResponseList getUserListMembers(String ownerScreenName, String slug, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(String ownerScreenName, String slug, int count, long cursor)
throws TwitterException;
/**
* Returns the members of the specified list.
*
This method calls https://api.twitter.com/1.1/lists/members.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param count Specifies the number of results to return per page. The default is 20, with a maximum of 5,000.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @param skipStatus When set to either true, t or 1 statuses will not be included in the returned user objects.
* @return the members of the specified list.
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/members | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListMembers(String ownerScreenName, String slug, int count, long cursor, boolean skipStatus)
throws TwitterException;
/**
* Adds a member to a list. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members.
*
This method calls https://api.twitter.com/1.1/lists/members/create.json
*
* @param listId The id of the list.
* @param userId The id of the user to add as a member of the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create | Twitter Developers
* @since Twitter4J 2.1.0
*/
UserList createUserListMember(long listId, long userId) throws TwitterException;
/**
* Adds a member to a list. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members.
*
This method calls https://api.twitter.com/1.1/lists/members/create.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user to add as a member of the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList createUserListMember(long ownerId, String slug, long userId) throws TwitterException;
/**
* Adds a member to a list. The authenticated user must own the list to be able to add members to it. Lists are limited to having 5000 members.
*
This method calls https://api.twitter.com/1.1/lists/members/create.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param userId The id of the user to add as a member of the list.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/members/create | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList createUserListMember(String ownerScreenName, String slug, long userId) throws TwitterException;
/**
* Deletes the specified list. Must be owned by the authenticated user.
*
This method calls https://api.twitter.com/1.1/lists/destroy.json
*
* @param listId The id of the list to delete
* @return the deleted list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/destroy | Twitter Developers
* @since Twitter4J 2.1.0
*/
UserList destroyUserList(long listId) throws TwitterException;
/**
* Deletes the specified list. Must be owned by the authenticated user.
*
This method calls https://api.twitter.com/1.1/lists/destroy.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the deleted list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/destroy | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList destroyUserList(long ownerId, String slug) throws TwitterException;
/**
* Deletes the specified list. Must be owned by the authenticated user.
*
This method calls https://api.twitter.com/1.1/lists/destroy.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the deleted list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/destroy | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList destroyUserList(String ownerScreenName, String slug) throws TwitterException;
/**
* Updates the specified list.
*
This method calls https://api.twitter.com/1.1/lists/update.json
*
* @param listId The id of the list to update.
* @param newListName What you'd like to change the list's name to.
* @param isPublicList Whether your list is public or private. Optional. Values can be public or private. Lists are public by default if no mode is specified.
* @param newDescription What you'd like to change the list description to.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/update | Twitter Developers
* @since Twitter4J 2.1.0
*/
UserList updateUserList(long listId, String newListName, boolean isPublicList, String newDescription)
throws TwitterException;
/**
* Updates the specified list.
*
This method calls https://api.twitter.com/1.1/lists/update.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param newListName What you'd like to change the list's name to.
* @param isPublicList Whether your list is public or private. Optional. Values can be public or private. Lists are public by default if no mode is specified.
* @param newDescription What you'd like to change the list description to.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/update | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList updateUserList(long ownerId, String slug, String newListName, boolean isPublicList, String newDescription)
throws TwitterException;
/**
* Updates the specified list.
*
This method calls https://api.twitter.com/1.1/lists/update.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @param newListName What you'd like to change the list's name to.
* @param isPublicList Whether your list is public or private. Optional. Values can be public or private. Lists are public by default if no mode is specified.
* @param newDescription What you'd like to change the list description to.
* @return the updated list
* @throws TwitterException when Twitter service or network is unavailable
* @see POST lists/update | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList updateUserList(String ownerScreenName, String slug, String newListName, boolean isPublicList, String newDescription)
throws TwitterException;
/**
* Creates a new list for the authenticated user. Accounts are limited to 20 lists.
*
This method calls https://api.twitter.com/1.1/lists/create.json
*
* @param listName The name of the list you are creating. Required.
* @param isPublicList set true if you wish to make a public list
* @param description The description of the list you are creating. Optional.
* @return the list that was created
* @throws twitter4j.TwitterException when Twitter service or network is unavailable, or the authenticated user already has 20 lists(TwitterException.getStatusCode() == 403).
* @see POST lists/create | Twitter Developers
* @since Twitter4J 2.1.0
*/
UserList createUserList(String listName, boolean isPublicList, String description)
throws TwitterException;
/**
* Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.
*
This method calls https://api.twitter.com/1.1/lists/show.json
*
* @param listId The id of the list to show
* @return the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see https://dev.twitter.com/docs/api/1.1/get/lists/show | Twitter Developers
* @since Twitter4J 2.2.3
*/
UserList showUserList(long listId) throws TwitterException;
/**
* Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.
*
This method calls https://api.twitter.com/1.1/lists/show.json
*
* @param ownerId The user ID of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see https://dev.twitter.com/docs/api/1.1/get/lists/show | Twitter Developers
* @since Twitter4J 3.0.0
*/
UserList showUserList(long ownerId, String slug) throws TwitterException;
/**
* Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.
*
This method calls https://api.twitter.com/1.1/lists/show.json
*
* @param ownerScreenName The screen name of the user who owns the list being requested by a slug.
* @param slug slug of the list
* @return the specified list
* @throws TwitterException when Twitter service or network is unavailable
* @see https://dev.twitter.com/docs/api/1.1/get/lists/show | Twitter Developers
* @since Twitter4J 3.0.2
*/
UserList showUserList(String ownerScreenName, String slug) throws TwitterException;
/**
* List the lists the specified user follows.
*
This method calls https://api.twitter.com/1.1/lists/subscriptions.json
*
* @param listSubscriberScreenName The screen name of the list subscriber
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists the specified user is subscribed to
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/subscriptions | Twitter Developers
* @since Twitter4J 2.1.0
*/
PagableResponseList getUserListSubscriptions(String listSubscriberScreenName, long cursor)
throws TwitterException;
/**
* List the lists the specified user follows.
*
This method calls https://api.twitter.com/1.1/lists/subscriptions.json
*
* @param listSubscriberScreenName The screen name of the list subscriber
* @param count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists the specified user is subscribed to
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/subscriptions | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscriptions(String listSubscriberScreenName, int count, long cursor)
throws TwitterException;
/**
* List the lists the specified user follows.
*
This method calls https://api.twitter.com/1.1/lists/subscriptions.json
*
* @param listSubscriberId The ID of the list subscriber
* @param cursor Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists the specified user is subscribed to
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/subscriptions | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscriptions(long listSubscriberId, long cursor)
throws TwitterException;
/**
* List the lists the specified user follows.
*
This method calls https://api.twitter.com/1.1/lists/subscriptions.json
*
* @param listSubscriberId The ID of the list subscriber
* @param count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
* @return the list of lists the specified user is subscribed to
* @throws TwitterException when Twitter service or network is unavailable
* @see GET lists/subscriptions | Twitter Developers
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListSubscriptions(long listSubscriberId, int count, long cursor)
throws TwitterException;
/**
* Returns 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.
*
This method calls https://api.twitter.com/1.1/lists/ownerships.json
*
* @param listOwnerScreenName The screen name of the list owner
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.
* @return lists owned by the specified Twitter user
* @throws TwitterException when Twitter service or network is unavailable
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListsOwnerships(String listOwnerScreenName, long cursor)
throws TwitterException;
/**
* Returns 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.
*
This method calls https://api.twitter.com/1.1/lists/ownerships.json
*
* @param listOwnerScreenName The screen name of the list owner
* @param count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.
* @return lists owned by the specified Twitter user
* @throws TwitterException when Twitter service or network is unavailable
* @since Twitter4J 4.0.1
*/
PagableResponseList getUserListsOwnerships(String listOwnerScreenName, int count, long cursor)
throws TwitterException;
/**
* Returns 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.
*
This method calls https://api.twitter.com/1.1/lists/ownerships.json
*
* @param listOwnerId The id of the list owner
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.
* @return lists owned by the specified Twitter user
* @throws TwitterException when Twitter service or network is unavailable
* @since Twitter4J 4.0.4
*/
PagableResponseList getUserListsOwnerships(long listOwnerId, long cursor)
throws TwitterException;
/**
* Returns 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.
*
This method calls https://api.twitter.com/1.1/lists/ownerships.json
*
* @param listOwnerId The id of the list owner
* @param count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
* @param cursor Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.
* @return lists owned by the specified Twitter user
* @throws TwitterException when Twitter service or network is unavailable
* @since Twitter4J 4.0.1
*/
PagableResponseList getUserListsOwnerships(long listOwnerId, int count, long cursor)
throws TwitterException;
}