twitter4j.api

Interface TweetsResources

All Known Subinterfaces:

Twitter

All Known Implementing Classes:

TwitterImpl

public interface TweetsResources

Author:

Joern Huxhorn - jhuxhorn at googlemail.com

Method Summary

Methods

Modifier and Type	Method and Description
Status	destroyStatus(long statusId) Destroys the status specified by the required ID parameter. Usage note: The authenticating user must be the author of the specified status.
ResponseList<Status>	getRetweets(long statusId) Returns up to 100 of the first retweets of a given tweet.
Status	retweetStatus(long statusId) Retweets a tweet.
Status	showStatus(long id) Returns a single status, specified by the id parameter below.
Status	updateStatus(StatusUpdate latestStatus) Updates the authenticating user's status.
Status	updateStatus(java.lang.String status) Updates the authenticating user's status.

Method Detail

getRetweets

ResponseList<Status> getRetweets(long statusId)
                                 throws TwitterException

Returns up to 100 of the first retweets of a given tweet.
This method calls http://api.twitter.com/1.1/statuses/retweets

Parameters:

statusId - The numerical ID of the tweet you want the retweets of.

Returns:

the retweets of a given tweet

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

Tweets Resources › statuses/retweets/:id

showStatus

Status showStatus(long id)
                  throws TwitterException

Returns a single status, specified by the id parameter below. The status's author will be returned inline.
This method calls http://api.twitter.com/1.1/statuses/show

Parameters:

id - the numerical ID of the status you're trying to retrieve

Returns:

a single status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

GET statuses/show/:id | Twitter Developers

destroyStatus

Status destroyStatus(long statusId)
                     throws TwitterException

Destroys the status specified by the required ID parameter.
Usage note: The authenticating user must be the author of the specified status.
This method calls http://api.twitter.com/1.1/statuses/destroy

Parameters:

statusId - The ID of the status to destroy.

Returns:

the deleted status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

1.0.5

See Also:

POST statuses/destroy/:id | Twitter Developers

updateStatus

Status updateStatus(java.lang.String status)
                    throws TwitterException

Updates the authenticating user's status. A status update with text identical to the authenticating user's text identical to the authenticating user's current status will be ignored to prevent duplicates.
This method calls http://api.twitter.com/1.1/statuses/update

Parameters:

status - the text of your status update

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

POST statuses/update | Twitter Developers

updateStatus

Status updateStatus(StatusUpdate latestStatus)
                    throws TwitterException

Updates the authenticating user's status. A status update with text identical to the authenticating user's text identical to the authenticating user's current status will be ignored to prevent duplicates.
This method calls http://api.twitter.com/1.1/statuses/update or
This method calls https://upload.twitter.com/1/statuses/update_with_media

Parameters:

latestStatus - the latest status to be updated.

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.1

See Also:

POST statuses/update | Twitter Developers

retweetStatus

Status retweetStatus(long statusId)
                     throws TwitterException

Retweets a tweet. Returns the original tweet with retweet details embedded.
This method calls http://api.twitter.com/1.1/statuses/retweet

Parameters:

statusId - The ID of the status to retweet.

Returns:

the retweeted status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

POST statuses/retweet/:id | Twitter Developers