Automatic Upload
The Automatic Upload feature allows you to efficiently upload videos to the glomex platform with all necessary metadata.
Metadata Requirements
The Automatic Upload process requires metadata for your videos, including:
- File Paths: Links to the corresponding video and image files
- Descriptive metadata: Title, description, keywords, etc.
- Technical metadata: Publishing time window, geolocations, etc.
Metadata Format
The metadata can be provided in two different formats: XML or JSON.
XML (Media RSS)
Media RSS is a web standard for the delivery of video files with metadata. It is based on XML.
Minimum Example
<rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
<channel>
<title>My Channel</title>
<image>
<url>https://mychannel.com/mychannellogo.png</url>
</image>
<!-- Video 1 -->
<item>
<guid>video_0001</guid>
<title>Title 1</title>
<media:content url="https://mychannel.com/video_0001.mp4" fileSize="28077488" type="video/mp4"/>
<media:thumbnail url="https://mychannel.com/video_0001.jpg"/>
<media:category>News</media:category>
</item>
<!-- Next videos... -->
</channel>
</rss>
XML Item Fields
Field | Short Description | Description | Required |
---|---|---|---|
<guid></guid> | ID of the video | The unique identifier of the video. e.g.: "095fac8d39b2cc0asdasd5asd43321s3df1d" or 12345 | Yes |
<title></title> | Title | The title of the video. Contains titles on different languages.{"en": "Sample video title", "de": "Beispiel Video-Titel 2"} | Yes |
<media:content url="" fileSize="" type=""/> | Video File Path | The URL to the video file. HTTP: http://channel.com/video_1.mp4 (S)FTP: sftp://user:password@example.com:2222/video.mp4 fileSize : size files in bytestype : typeof video. e.g.: video/mp4 | Yes |
<media:thumbnail url=""/> | Image File Path | The URL to the preview image file. HTTP: http://channel.com/video_1.jpg (S)FTP: sftp://user:password@example.com:2222/video1.jpg | Yes |
<media:category></media:category> | Category | The category of the video. Supported categories: News , Cars & Motor , Food & Drink , Fashion & Beauty , Health & Fitness , Cinema & TV , Lifestyle & Documentation , Social & Fun , Sport , Celebrities , Travel & Adventure , Gaming | Yes |
<channel></channel> | Channel | The name of your channel in which the video should be published. e.g.: "ProSieben" | No |
<description></description> | Description | The description of the video. The description will be used for the search results and automated recommendations of your video. | Recommended |
<media:keywords></media:keywords> | Keywords | The keywords of the video. The keywords will be used for the search results and automated recommendations of your video. Keywords can be comma separated, e.g.: <media:keywords>animals, zoo</media:keywords> | Recommended |
<media:subTitle type="text/srt" lang="de-DE" href=""/> | Subtitles File Path | The URL to the subtitles file. HTTP: http://channel.com/video_1.srt (S)FTP: sftp://user:password@example.com:2222/video1.srt | No |
<format></format> | Show | The name of the show or program title. e.g.: "Germany's Next Top Model" | No |
<media:content lang=""/> | Language | The language of the video content. glomex supports the two-letter ISO 639-1 language codes. See the full list here . e.g.: de | No |
<media:rating scheme="fsk"></media:rating> | Age Ratings | The age ratings of the video content. Supported age ratings: FSK0 - Ab 0 freigegebenFSK6 - Ab 6 freigegebenFSK12 - Ab 12 freigegebenFSK16 - Ab 16 freigegebenFSK18 - Ab 18e.g.: <media:rating scheme="fsk">FSK12</media:rating> | No |
<dcterms:valid></dcterms:valid> | Start and end dates | The release and expiration dates of the video. The video will be activated and deactivated on this date. Date format: YYYY-MM-DDThh:mm:ss+TIMEZONE (ISO 8601 )e.g.: <dcterms:valid> start=2020-10-17T17:00+01:00; end=2021-10-17T17:00+01:00; scheme=W3C-DTF</dcterms:valid> | No |
<media:restriction relationship="allow" type="country"></media:restriction> | Geo Locations | The countries in which the video should be allowed to play. e.g.: ["DE","AT","CH"] , default ALL | No |
<media:copyright url=""></media:copyright> | Copyright | The copyright information of the video. e.g.: <media:copyright url="http://www.uphe.de/">Universal</media:copyright> | No |
<media:status state=""/> | Status | Defines whether the video is "active" , "locked" , "blocked" or "deleted" .The default value is "active" . | No |
<pubDate></pubDate> | Publication Date | The publication date of the video. Format: YYYY-MM-DDThh:mm:ss+TIMEZONE | No |
<media:transcript></media:transcript> | Transcript | Allows the inclusion of a text transcript, closed captioning or lyrics of the media content. | No |
JSON Format
The JSON format provides an alternative to XML for specifying video metadata.
Minimum Example
[
{
"id": "video_0001",
"title": {
"de": "Title 1"
},
"uri": "sftp://user:password@upload.glomex.com:2222/videos/video_0001.mp4",
"image_uri": "sftp://user:password@upload.glomex.com:2222/images/video_0001.png",
"categories": [
"Sport"
],
"channel": "My Channel"
},
{
"id": "video_0002",
"title": {
"de": "Title 2"
},
"uri": "sftp://user:password@upload.glomex.com:2222/videos/video_0002.mp4",
"image_uri": "sftp://user:password@upload.glomex.com:2222/images/video_0002.png",
"categories": [
"Sport"
],
"channel": "My Channel"
}
]
JSON Fields
Field | Description | Type | Required |
---|---|---|---|
id | The unique identifier of the video | string|int | Yes |
uri | The URL to the video file | string | Yes |
image_uri | The URL to the preview image file | string | Yes |
title | The title of the video in different languages | Object | Yes |
categories | The categories of the video | [string] | Yes |
channel | The name of your channel | string | Yes |
description | The description of the video in different languages | Object | Recommended |
keywords | The keywords of the video | [string] | Recommended |
subtitle_uri | The URL to the subtitles file | string | No |
format | The name of the show or program title | string | No |
languages | The language of the video | [string] | No |
product_placement | Describes if the video contains product placements | bool | No |
age_ratings | The age ratings of the video content | [Object] | No |
release_date | The release date of the video | string | No |
expiration_date | The expiration date of the video | string | No |
update_date | The date of the last video update | string | No |
geo_locations | The countries in which the video should be allowed to play | [string] | No |
status | The status of the video | string | No |
transcript | Allows the inclusion of a text transcript, closed captioning or lyrics of the media content | string | No |
license_profiles | The license profile id, that should be assigned to this video | [string] | No |
Metadata Transfer
For information about how to deliver your metadata and content files to glomex, please contact your account manager or send an email to service@glomex.com.
To transfer your videos, images and the metadata to the glomex Exchange, you can choose between HTTP(S) Feed or FTP Upload.
HTTP(S) Feed
The content owner provides an URL which contains either a XML or JSON file. The XML or JSON file contains URL paths to your videos and images hosted on a HTTP(S) server.
(S)FTP Upload
You can upload your videos, images and metadata to a glomex (S)FTP Server. The video/image paths in your XML/JSON must also point to this FTP Server.
It is possible to use one JSON/XML to describe all videos (e.g. all-videos.json
) - or to use one JSON/XML file per video (e.g. video-01.json
, video-02.json
).
glomex (S)FTP Server
Field | Description |
---|---|
Host | upload.glomex.com |
Protocol | SFTP |
Port | 2222 |
Username/Password | Please contact your glomex partner for credentials. |
glomex Fetcher
Every 5 minutes or less, glomex fetches your XML/JSON feed and checks if new media files are provided or were changed.
If any new media files are provided, glomex imports and transcodes them. The content will be available for the Exchange Publishers within minutes.