When using FTP upload, you can directly upload files into an account.
By adding an XML file containing metadata for the file, you can immediately add necessary metadata to the uploaded content without requiring extra API interaction.
Performing an upload¶
You can use your favourite FTP application to connect to the FTP host. Use the username and password that you set using the StreamOne Manager or the ftpuser API.
The XML filename must be in the format of video.mp4.xml (if the video file it accompanies is named video.mp4). The XML will have to be uploaded before uploading the media file is done to ensure that it is read during the ingesting process, before the media file is ingested.
Available XML Fields¶
All of the following fields in the XML file are optional. CDATA should be used when using UTF-8 characters. Failure to parse the XML will cancel the ingest process for that file. The video will be moved to the ‘error’ directory and an ‘item-ingest-xml-fail’ event will be dispatched if this occurs. In order to restart the ingest process for the failed file, the file can be moved back to the ingest root (or uploaded again).
The root element of the XML file must be called <xml>. Every field is a separate element within this root element. There are no attributes for any element.
|copyright||Item copyright info|
|externalid||External ID for this item|
|externallink||Social media link for this item (http/https url)|
|keywords||Item keywords, comma separated|
|securityprofile||Security Profile ID for this item|
|secure||Bool: 0 or 1. If set to 1, content will be restricted (signature access only)|
|archived||Bool: 0 or 1. If set to 1, only the created renditions will be used for streaming; defaults to 1, and should not be set to 0 unless there is a reason to do so|
|categories||Categories to which item should be added, comma separated ID’s. Will only be used for new items|
|exportjobs||Export Jobs to which item should be added, comma separated ID’s|
|transcodeprofilegroup||Transcode Profile Group to which item should be transcoded. If not set, use account default|
|transcodepriority||The priority of Transcode Jobs that are created; one of idle, low, medium, high or realtime; note that some priorities might not be available for the active account and/or profile, in which case the priority is adjusted to the highest allowed priority lower than the given priority|