This page explains how to create Roll elements.
Attribute | Value | Mandatory |
---|---|---|
title | A non-empty string | YES |
video |
Video source URL. Formats accepted: avi , mpg , mp4 , flv , mov , wmv
If you don't have a remote video resource you can upload a video using the Guide to upload a video |
YES |
destination_url | Destination URL at the user's click on the preroll | NO |
destination_url_title | Destination URL title | NO |
short_description | A string | NO |
description | A string | NO |
tags | A string where each tag has the character , as a divider |
NO |
preview_image | A reference to the absolute path of the image on your disk or a remote URL. Formats accepted: jpg , png , gif |
NO |
squeeze_slot | Encoder slot from which you want to convert the video. To view the slots available on your Meride, query the queues_video.json resource | NO |
Field | Value | Description |
---|---|---|
adv_type | string | Ad type |
id | string | Object ID |
title | string | The title of the video |
destination_url | string | Destination URL at the user's click on the preroll |
destination_url_title | string | Destination URL title |
short_description | string | The associated short description |
description | string | The associated complete description |
tags | string | List of tags separated by commas |
available_video | boolean | If the video is available for playback, the value will be set 1 , otherwise it will have the value 0 |
created_at | string | The create date that follows the format Y-m-d H:i:sY(year) m(month) d(day) H(hours) i(minutes) s(seconds) |
preview_image | string | URL of the associated preview image |
curl -i -H "Accept: application/json" -H "Content-Type:application/json" -H "access-token: [your-access-token]" -X POST http://API_DOMAIN/rest/v2/advideo.json -d ' { "title": "Video title", "video": "http:\/\/storage.video\/video_source.mp4", "preview_image": "http:\/\/storage.image\/test_image.jpg", "destination_url": "http:\/\/meride.tv", "destination_url_title": "Meride" }'
{ "adv_type": "video", "id":"2", "title":"Roll title", "destination_url": "http://meride.tv", "destination_url_title": "Meride", "short_description":"", "description":"", "tags":"", "available_video":"0", "created_at":"2012-09-25 17:55:47", "preview_image":"http:\/\/example.com\/meride\/video\/images\/test_image.jpg" }
Note The object created will be returned as a response
$merideApi = new Meride\Api('[your-auth-code]', 'http://API_DOMAIN/', 'v2'); $response = $merideApi->create('advideo', array ( 'title' => 'Video title', 'video' => 'http://storage.video/video_source.mp4', 'preview_image' => 'http://storage.image/test_image.jpg', 'destination_url' => 'http://meride.tv', 'destination_url_title' => 'Meride', ));