Meride API - Roll - Update

This page explains how to update Roll elements.

Entity name: advideo.

PUT http://API_DOMAIN/rest/v2/advideo/{resource-id}.{format}

{resource-id}: the object ID

Attributes

Attribute Value Mandatory
title A non-empty string NO
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
It is not possible to change the video source of the object

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]" -H "X-HTTP-Method-Override: PUT" -X POST http://API_DOMAIN/rest/v2/advideo/2.json -d '
{
    "title": "New title"
}'
            

Example of a JSON response

{
	"adv_type": "video",
	"id":"2",
	"title":"New 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 updated object will be returned as a response

Note The PUT method is not supported by all systems. In case of problems, add the parameter to the Header of the callX-HTTP-Method-Override: PUT and use the method POST as default

PHP SDK documentation
$merideApi = new Meride\Api('[your-auth-code]', 'http://API_DOMAIN/', 'v2');
$response = $merideApi->update('advideo', '2', array (
  'title' => 'New title',
));