get_video_status

Get the status of an uploaded video.

Explorer

Explore this method

Request URL

http://api.tubemogul.com/api/v3/

HTTP method

GET or POST

Arguments

upload_id (integer) - Required

The ID of the uploaded video. This value is returned by list_uploads and upload_video.

Returned Status Codes

0 : Unknown Error.

1 : Successful

5 : The upload is pending.

5 : We were not able to process your file.

7 : We could not recognize the audio/video format.

10 : Incorrect login information.

12 : Google/YouTube account mismatch.

13 : Account does not exist.

14 : Error type -86.

15 : Account locked.

16 : User action required for video site account.

17 : Manual login required on video site.

20 : Error while uploading to video site.

30 : Video rejected by video site.

31 : Invalid video file type.

40 : Identical video already submitted.

50 : User account not confirmed or site terms not accepted.

60 : Video site not currently accepting uploads. Please try again later.

70 : Error retrieving file. Please retry.

80 : Video file is too long for video site. Please shorten it and re-upload.

90 : Account upload privileges are suspended on video site. Contact the site for more info.

100 : Video site account lacks publishing privileges.

101 : Copyright violation.

102 : Producer-Rewards account problem.

103 : Internal error while uploading. Please try again later.

104 : Unexpected video site error. Please try again later.

105 : Account temporarily blocked on video site because of too much activity.

106 : Video flagged as mature content by video site.

107 : File could not be encoded on video site.

108 : Video was removed by user.

109 : Video was removed.

110 : Video could not be transcoded.

111 : Could not confirm video because it is not public.

112 : The upload did not finish. Please try again later.

113 : Video was not successfully uploaded.

114 : Title, description, or tags empty or has invalid character.

115 : Video rejected by site.

116 : Upload had exception. Please try again later.

117 : Internal data error.

120 : File exceeds max size for video site even after compression.

130 : Video go live could not be verified.

210 : Recall failed. Please try again or contact us.

220 : Recall failed because the stored username does not own this video.

230 : Video site does not support recall.

320 : Video delete failed.

330 : Video was deleted by user.

350 : Video delete is pending.

Example Response

<?xml version="1.0" encoding="utf-8" ?>
<response stat="ok">
<sites count="5">
  <site>
    <siteid>1</siteid>
    <status>1</status>
    <videourl>http://www.youtube.com/?watch=y4d4ERcw</videourl>
    <embedcode><object src=http://www.youtube.com/?watch=y4d4ERcw width=234 height=329></embedcode>
    <videoid>32909</videoid>
    <pubid>3302</pubid>
  </site>
  <site>
    <siteid>2</siteid>
    <status>20</status>
    <message>We are unable to upload to the video site because your credentials are incorrect.
             Please go to tubemogul.com to update your credentials.
    </message>
  </site>
  <site>
    <siteid>3</siteid>
    <status>5</status>
    <message>The upload is pending.</message>
  </site>
  <site>
    <siteid>4</siteid>
    <status>40</status>
    <message>The upload is a duplicate file.</message>
  </site>
</sites>
</response>

Error Codes

Standard error codes plus:

10 : uploadid is invalid or does not belong to the user

Example Code

<?
# Your user token
$user_token = '';

# Your partner ID
$partner_id = '';

# Your secret key
$secret_key = '';

# Required uploadid
$upload_id = '';

$method = 'getVideoStatus';

$now = time();

$apihost = 'http://api-upload.tubemogul.com/index.php';

$poststring = "date=".$now.
              "&userToken=".urlencode($user_token).
              "&partnerID=".urlencode($partner_id).
              "&uploadid=".$upload_id.
              "&method=".$method;

$hash = sha1($secret_key.$poststring);

$poststring .= "&hash=".$hash;

echo $poststring;
?>

<br /><br />
<form action='<? echo $apihost; ?>' method='post'>
<input type='hidden' name='date' value='<? echo $now; ?>' />
<input type='hidden' name='userToken' value='<? echo $user_token; ?>' />
<input type='hidden' name='partnerID' value='<? echo $partner_id; ?>' />
<input type='hidden' name='uploadid' value='<? echo $upload_id; ?>' />
<input type='hidden' name='method' value='<? echo $method; ?>' />
<input type='hidden' name='hash' value='<? echo $hash; ?>' />
<input type='submit' value='submit!' />
</form>