UploadVideo
Upload video assets in your LinkedIn organization/ad-account which can be used to create posts and ads.
Procedure Specific Information
To use this stored procedure, exactly one of the following parameters must be specified (besides the ones reported in the table below as Required):- LocalFile
- FileStream (if this used, the FileStreamSize parameter must also be specified)
- FileData
If no parameter is used, or more than one parameter is used, the procedure will fail.
If the video has a thumbnail, you can use the value returned in the ThumbnailUploadURL output parameter to upload the video's thumbnail through the UploadVideoThumbnail stored procedure.
If the video has captions, you can use the value returned in the CaptionsUploadURL output parameter to upload the video's captions through the UploadVideoCaptions stored procedure.
For a video asset to be usable (use it to create posts or ads), you must:
- Upload the video through this stored procedure.
- Upload the video's thumbnail (if applicable) through the UploadVideoThumbnail stored procedure.
- Upload the video's captions (if applicable) through the UploadVideoCaptions stored procedure.
Below are some other restrictions for video assets:
- The video's size can't exceed 5 GiB.
- Only the MP4 format is supported.
There are more restrictions for the video, depending on how you intend to use it:
- If you intend to use the video asset for creating non-CTV video ads refer to Video ads advertising specifications.
- If you intend to use the video asset for creating CTV video ads refer to CTV Ads specifications.
Input
| Name | Type | Required | Description |
| AccountURN | String | True | The URN of the account whose media library will contain the new video asset. |
| AssetName | String | True | The name to use for saving this video as an asset in the account's media library. |
| OwnerURN | String | True | The URN of the organization to use as the new video's owner. |
| LocalFile | String | False | The absolute path of the video file in your system to upload to LinkedIn. |
| FileStreamSize | Long | False | The size in bytes of the 'InputStream' object provided in the 'FileStream' parameter. This input is required if the 'FileStream' parameter was used. |
| FileData | String | False | A Base64-encoded string containing the data of the video to upload to LinkedIn. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options. |
| HasCaptions | Boolean | False | Boolean value indicating whether the new video will contain captions or not. If yes (true), the URL for uploading the captions will be returned in the results of the procedure.
The default value is false. |
| HasThumbnail | Boolean | False | Boolean value indicating whether the new video will contain a thumbnail or not. If yes (true), the URL for uploading the thumbnail will be returned in the results of the procedure.
The default value is false. |
Result Set Columns
| Name | Type | Description |
| VideoURN | String | The URN of the new video asset that was created, if the upload was successful. |
| CaptionsUploadURL | String | The URL to use for uploading the video's captions. |
| ThumbnailUploadURL | String | The URL to use for uploading the video's thumbnail. |