In order for your upload to succeed, your XML file must comply with our internal schema. Format your XML file according to the schema in the sample file below.
To ensure your upload is successful, you must format your XML file similarly to the one below:
For a video, you can import the following metadata:
Video Metadata | Description |
---|---|
source | Mandatory. If the source for your video file is not specified, then the XML file is invalid. Your upload will fail. |
title | By default, the system will use the original file name. (Optional) |
description | Enter a short description for you video. (Optional) |
keywords | You can enter multiple keywords, if desired. (Optional) |
customMetadata | Edit custom metadata for a video. The fields are the same as the ones displayed in your video list (date uploaded, category, etc.). (Optional) |
channels | Assign your video to a channel by specifying one or more channel IDs. (Optional) If you don't want to assign your video to a channel, you'll need to remove this tag entirely, or the upload will fail. |
groupId | Specify the Id of the user group this video should be assigned to. If no Id is assigned, the video will automatically be assigned to the default "Company" group. (Optional) |
securityPolicyId | Specify the Id of the security policy that should be applied to your video. (Optional) |
release | Specify the release status of the video via the <publish> tag. (Optional) Times are according to D ISO 8601, in the format YYYY-MM-DDThh:mm:ssTZD where:
Example: 2019-07-01T09:00:00+02:00 would release the video at 0900 Berlin time, 0800 London time and 0700 UTC.
If you entered an invalid date (for example, the release date you entered is in the past), the video will be imported without any release status. |
download | You can activate the download release via the <download/> element. (Optional) |
delete | Specify the date when the video has to be automatically deleted. (Optional) |
still | Specify what file should be used as a thumbnail for the video. (Optional) The thumbnail file must not be larger than 10000 KB. You must use a thumbnail image if you define one in the XML schema. Otherwise, the upload will fail. |
inform | Specify additional people who should receive notification emails about file ingest status. The uploader will always receive notifications by default. (Optional) Notifications will be sent for the following errors:
|
disableAutoDelete | Use this tag to prevent the system from automatically deleting video files and stills from the FTP server after processing. (Optional) |
When uploading your XML file, we check against our internal validation schema (shown below).