Meride API - Roll - Create

This page explains how to create Roll elements.

Entity name: advideo.

POST http://API_DOMAIN/rest/v2/advideo.{format}

Attributes

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

Response

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:s
Y(year) m(month) d(day) H(hours) i(minutes) s(seconds)
preview_image string URL of the associated preview image

Example of a request

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"
}'
            

Example of a JSON response

{
	"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

PHP SDK documentation
$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',
));