Announcement: attributable_user_id on POST media/upload

announcements
media-upload

#1

Today we are announcing a new request parameter on the POST media/upload (INIT) endpoint*. First, some context.

The Tweet and Scheduled Tweet endpoints allow the authenticated user to Tweet on behalf of another user as long as the appropriate permission has been granted. In the past, creating a Tweet with media has only been possible by using the additional_owners parameter on upload. See this post for details.

Every uploaded media asset has an owner, which is always the authenticated user at the time of upload. In order to respect content ownership, on 2018-04-30 2018-05-02, we will begin to render the avatar and display name (on web; Android and iOS will be slightly different) in Tweets when the Tweet’s author is different from the video’s owner. In other words, if user A uploads a video and specifies user B as an additional owner, when user B Tweets the video, user A’s information will be displayed in the Tweet.

In this example, @apimctestface is the owner of the video. @AdsAPI has been added as an additional owner. When @AdsAPI Tweets using this video, we will render @apimctestface’s information in the Tweet.

For instances where the only intended user of the video is user B, use the attributable_user_id parameter on the POST media/upload (INIT) endpoint* to indicate that user B has ownership and to avoid user A’s information from being rendered in the Tweet. Some additional details details:

  • Only one attributable user can be specified per video.
  • Only the attributable user will be able to use the video in a Tweet.
  • If additional owners are also listed, they will be ignored.

When Tweeting on behalf of another user, if you wish to avoid the video owner’s information from being rendered in the Tweet, please make necessary changes before 2018-04-30 2018-05-02.

Twitter Ads API Team


* Documentation will be updated soon.

# INIT step using `attributable_user_id`
# only user 2244994945 (@TwitterDev)
# will be able to use this video
$ twurl -X POST -H upload.twitter.com "/1.1/media/upload.json" -d "command=INIT&media_type=video/mp4&total_bytes=21073864&media_category=amplify_video&attributable_user_id=2244994945"
{
  "media_id": 978672855104696321,
  "media_id_string": "978672855104696321",
  "expires_after_secs": 1295999,
  "media_key": "13_978672855104696321"
}

#2

#3

#4

This change has gone into effect.

Videos uploaded after 2018-05-02 that use the additional_owners request parameter will render the avatar and display name (on web; Android and iOS will be slightly different) of the video’s owner when the owner is different from the Tweet’s author, like in the following example (Tweet link).

However, when attributable_user_id is used, the Tweet renders as follows (Tweet link).