Meride API - configuration - Read

This page explains how to read the content configuration.

GET http://API_DOMAIN/rest/configuration.{format}

Attributes

No parameter

Response

A collection / array of elements

Field	Value	Description
id	string	Object ID
title	string	Il titolo della configurazione
label	string	The label field associated with the configuration
context_rules	array	Set of context rules
data_inserimento	string	La data di inserimento che segue il formato Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
skin	string	The skin of the player chosen during create
responsive	boolean	`1` if autoplay is responsive. `0` otherwise
autoplay	boolean	`1` if the video is published in autoplay. `0` otherwise
controlbar_visible	boolean	`0` if the player's control bar is hidden. `0` otherwise
seekable	boolean	`0` if the player's scroll bar is disabled. `0` otherwise
wmode	string	The wmode property of the object/embed element on Flash player
skip_preroll	boolean	`1` if the user has the option to skip the preroll. `0` otherwise
skip_time	integer	The number of seconds after which the link to skip the preroll appears
setting_volume	string	Google DART volume. `-1` Predefined. `none` No check. `defaultOn` Volume active. `defaultOff` Volume disabled
preroll	advideo \| advast \| addart \| admast	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	advideo \| advast \| addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
ama_configuration	ama	The associated Akamai Media Analytics object
comscore_account	comscore	The associated Comscore object
nielsen_account	nielsen	The associated Nielsen object

Agli oggetti preroll, postroll, overlay_initial e overlay_main (Flash e HTML5) verrà inserito un campo aggiuntivo tipo_adv che specifica la tipologia di advertising: dart per oggetti Google DART, mast per oggetti MAST, vast per oggetti VAST, video per contenuti Roll)

Example of a curl request

curl -i -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET http://API_DOMAIN/rest/configuration.json

Example of a JSON response

[
	...
{
    "id":"39",
    "titolo":"Configuration title",
    "label":"conf1",
    "context_rules":{
    	"0":"http:\/\/www.meride.tv*",
    	"1":"http:\/\/www.mosaicolab.com*"
    	},
    "skin":"default",
    "data_inserimento":"2012-09-24 09:12:49",
    "responsive":"0",
    "autoplay":"1",
    "controlbar_visible":"1",
    "seekable":"1",
    "wmode":"direct",
    "skip_preroll":"",
    "skip_time":"",
    "setting_volume" : "-1",
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
        "after_time":"0"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "after_time":"0"
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
    "ama_configuration":null,
    "comscore_account" : {
        "id":"1",
        "titolo":"Comscore title",
        "clientid":"14267511",
        "predefinito":"1",
        "descrizione":null,
        "data_inserimento":"2013-02-06 17:11:03"
    },
    "nielsen_account" : null
}
	...
]

GET http://API_DOMAIN/rest/configuration/{resource-id}.{format}

{resource-id}: the object ID

Attributes

No parameter

Response

Field	Value	Description
id	string	Object ID
title	string	Il titolo della configurazione
label	string	The label field associated with the configuration
context_rules	array	Set of context rules
data_inserimento	string	La data di inserimento che segue il formato Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
skin	string	The skin of the player chosen during create
responsive	boolean	`1` if autoplay is responsive. `0` otherwise
autoplay	boolean	`1` if the video is published in autoplay. `0` otherwise
controlbar_visible	boolean	`0` if the player's control bar is hidden. `0` otherwise
seekable	boolean	`0` if the player's scroll bar is disabled. `0` otherwise
wmode	string	The wmode property of the object/embed element on Flash player
skip_preroll	boolean	`1` if the user has the option to skip the preroll. `0` otherwise
skip_time	integer	The number of seconds after which the link to skip the preroll appears
setting_volume	string	Google DART volume. `-1` Predefined. `none` No check. `defaultOn` Volume active. `defaultOff` Volume disabled
preroll	advideo \| advast \| addart \| admast	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	advideo \| advast \| addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
ama_configuration	ama	The associated Akamai Media Analytics object
comscore_account	comscore	The associated Comscore object
nielsen_account	nielsen	The associated Nielsen object

Example of a curl request

curl -i -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET http://API_DOMAIN/rest/configuration/39.json

Example of a JSON response

{
    "id":"39",
    "titolo":"Configuration title",
    "label":"conf1",
    "context_rules":{
    	"0":"http:\/\/www.meride.tv*",
    	"1":"http:\/\/www.mosaicolab.com*"
    	},
    "skin":"default",
    "data_inserimento":"2012-09-24 09:12:49",
    "responsive":"0",
    "autoplay":"1",
    "controlbar_visible":"1",
    "seekable":"1",
    "wmode":"direct",
    "skip_preroll":"",
    "skip_time":"",
    "setting_volume" : "-1",
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
        "after_time":"0"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "after_time":"0"
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
    "ama_configuration":null,
    "comscore_account" : {
        "id":"1",
        "titolo":"Comscore title",
        "clientid":"14267511",
        "predefinito":"1",
        "descrizione":null,
        "data_inserimento":"2013-02-06 17:11:03"
    },
    "nielsen_account" : null
}

GET http://API_DOMAIN/rest/configuration.{format}

Note The option must be specified -G in the call with the curl command so that the search parameters are passed correctly

Attributes

Attribute	Value	Mandatory
search_string	A non-empty string that will be searched for in the title	NO
search_in_tags	`1` if you want to also search in tags. `0` otherwise	NO
search_in_description	`1` if you want to also search in the description. `0` otherwise	NO
search_date_min	Format DATETIME `aaaa-mm-gg`. Cerca tutti le configurazioni a partire dalla data specificata	NO
search_date_max	Format DATETIME `aaaa-mm-gg`. Cerca tutti le configurazioni fino alla data specificata	NO
search_limit	Intero maggiore di 0. Restituisce n configurazioni per la ricerca specificata.	NO
search_offset	Intero maggiore di 0. Restituisce le configurazioni a partire dal numero specificato.	NO

Response

A collection / array of elements

Field	Value	Description
id	string	Object ID
title	string	Il titolo della configurazione
label	string	The label field associated with the configuration
context_rules	array	Set of context rules
data_inserimento	string	La data di inserimento che segue il formato Y-m-d H:i:s `Y(year)` `m(month)` `d(day)` `H(hours)` `i(minutes)` `s(seconds)`
skin	string	The skin of the player chosen during create
responsive	boolean	`1` if autoplay is responsive. `0` otherwise
autoplay	boolean	`1` if the video is published in autoplay. `0` otherwise
controlbar_visible	boolean	`0` if the player's control bar is hidden. `0` otherwise
seekable	boolean	`0` if the player's scroll bar is disabled. `0` otherwise
wmode	string	The wmode property of the object/embed element on Flash player
skip_preroll	boolean	`1` if the user has the option to skip the preroll. `0` otherwise
skip_time	integer	The number of seconds after which the link to skip the preroll appears
setting_volume	string	Google DART volume. `-1` Predefined. `none` No check. `defaultOn` Volume active. `defaultOff` Volume disabled
preroll	advideo \| advast \| addart \| admast	Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
postroll	advideo \| advast \| addart	Il postroll utilizzato nel player Flash per utenti desktop
overlay_initial	addart	L'overlay iniziale utilizzato nel player Flash per utenti desktop
overlay_main	addart	L'overlay principale utilizzato nel player Flash per utenti desktop
html5_preroll	addart	Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati
html5_postroll	addart	Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_initial	addart	L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
html5_overlay_main	addart	L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili.
ama_configuration	ama	The associated Akamai Media Analytics object
comscore_account	comscore	The associated Comscore object
nielsen_account	nielsen	The associated Nielsen object

Example of a curl request

curl -i -G -H "Accept: application/json" -H "access_token: Zuqk4nX6SfiaL20cO6np2i29Xyhn6NCW8T636UZPZ8QA0GDFDRUvZNuNbB08ft" -X GET -d "search_string=title&search_limit=5" http://API_DOMAIN/rest/configuration.json

Note Cerca le ultimi 5 configurazioni inserite con la stringa "title" contenuta nel titolo

Example of a JSON response

[
	...
{
    "id":"39",
    "titolo":"Configuration title",
    "label":"conf1",
    "context_rules":{
    	"0":"http:\/\/www.meride.tv*",
    	"1":"http:\/\/www.mosaicolab.com*"
    	},
    "skin":"default",
    "data_inserimento":"2012-09-24 09:12:49",
    "responsive":"0",
    "autoplay":"1",
    "controlbar_visible":"1",
    "seekable":"1",
    "wmode":"direct",
    "skip_preroll":"",
    "skip_time":"",
    "setting_volume" : "-1",
    "preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "postroll":null,
    "overlay_initial":{
        "tipo_adv":"dart",
        "id":"59",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml",
        "descrizione":"",
        "data_inserimento":"2012-12-17 11:38:26",
        "stay_time":"15"
        "after_time":"0"
    },
    "overlay_main":null,
    "html5_preroll":{
        "tipo_adv":"dart",
        "id":"2",
        "titolo":"Google dart",
        "url_sorgente":"http:\/\/googledarturl.com/advertising.xml",
        "tags":"lorem, ipsum",
        "descrizione":"Lorem ispum dolor sit amet",
        "data_inserimento":"2012-09-21 20:26:18"
    },
    "html5_postroll":null,
    "html5_overlay_initial":null,
    "html5_overlay_main":{
        "tipo_adv":"dart",
        "id":"33",
        "tipo":"non-linear",
        "titolo":"Overlay",
        "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml",
        "descrizione":"",
        "data_inserimento":"2012-05-23 18:26:20",
        "fixed":"0",
        "after_time":"0"
        "stay_time":"15",
        "delay_time":"20",
        "max_width":"728",
        "max_height":"90"
    },
    "ama_configuration":null,
    "comscore_account" : {
        "id":"1",
        "titolo":"Comscore title",
        "clientid":"14267511",
        "predefinito":"1",
        "descrizione":null,
        "data_inserimento":"2013-02-06 17:11:03"
    },
    "nielsen_account" : null
}
	...
]