Extended Tweets & TweetMode

Overview

• What are extended Tweets?
• Extended Tweet Properties
• Tweet Mode
• Tweet Parts

What are extended Tweets?

In 2016, Twitter decided to change the way Tweets work and they decided to call them Extended Tweets

These tweets are different because the length of the text no longer include the @username that was considered as part of the 140 characters of the old generation of Tweets. In addition to this, the link to attachments are also no longer part of the 140 characters size limit.

You can learn more about the changes of Extended Tweets at https://dev.twitter.com/overview/api/upcoming-changes-to-tweets.

Here is a quick image representing how the length is calculated with new type of tweets (source).

Extended Tweet Properties

ITweet includes new properties that you can use to extract the information from an extended tweet.

var tweet = Tweet.PublishTweet("@tweetinviapi forever! pic.twitter.com/42");
var fullText = tweet.FullText; // @tweetinviapi forever!
var prefix_or_mentions = tweet.Prefix; // @tweetinviapi
var content = tweet.Text; // forever!
var suffix = tweet.Suffix; // pic.twitter.com/42

You can also access some other metadata like :

// Contains the location of the text to display (content)
int[] tweet.DisplayTextRange; 

// Contains all the information specific to extended tweets
IExtendedTweet tweet.ExtendedTweet;  

Tweet Mode

Twitter introduced a TweetMode that is either compat or extended. To make it simpler for developers, they will be able to set this value directly from the TweetinviConfig for the lifetime of a thread of for the entire application.

TweetinviConfig.CurrentThreadSettings.TweetMode = TweetMode.Extended;

Note that by default this value will be null. When not set, Tweetinvi will not add the tweet_mode parameter to any of the endpoints that can use it.

In addition to this, the auto_populate_reply_metadata and exclude_reply_user_ids has been added to the PublishTweetOptionalParameters class.

Tweet parts

To preview how a string will be divided you can use the new string extension method TweetParts().

string tweet = "@tweetinviapi Amazing!";
ITweetParts tweetParts = tweet.TweetParts();

string prefix = tweetParts.Prefix;
string content = tweetParts.Content;
int twitterLength = tweetParts.Content.TweetLength();
string[] mentions = tweetParts.Mentions;

NOTE : TweetParts are only to be used with text that is intended to be used with tweet_mode extended and in reply to another tweet.