UploadVideo
Uploads video assets to your LinkedIn organization or ad account, making them available for use in video posts, video ads, and campaign creatives.
Procedure Specific Information
To use this stored procedure, exactly one of the following parameters must be specified (in addition to OwnerURN):- 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 (where you can 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 | Uniform Resource Name (URN) that identifies the advertising account whose media library will store the uploaded video asset. |
| AssetName | String | True | Specifies the name under which the video will be saved in the account's media library. |
| OwnerURN | String | True | URN that identifies the organization designated as the owner of the uploaded video asset. |
| LocalFile | String | False | Specifies the absolute local file path of the video to upload to LinkedIn. |
| FileStreamSize | Long | False | Specifies the size in bytes of the InputStream object defined in the FileStream parameter. This field is required when FileStream is used. |
| FileData | String | False | Contains the video data as a Base64-encoded string, used when neither LocalFile nor FileStream parameters can be provided. |
| HasCaptions | Boolean | False | If the value is 'true', the uploaded video will include captions, and a URL for uploading caption files will be returned in the output.
The default value is false. |
| HasThumbnail | Boolean | False | If the value is 'true', the uploaded video will include a thumbnail image, and a URL for uploading the thumbnail will be returned in the output.
The default value is false. |
Result Set Columns
| Name | Type | Description |
| VideoURN | String | URN that uniquely identifies the newly created video asset after a successful upload. |
| CaptionsUploadURL | String | URL provided for uploading caption files associated with the video asset. |
| ThumbnailUploadURL | String | URL provided for uploading the thumbnail image associated with the video asset. |