Modificación de pauta

Modificación de datos de una pauta previamente creada.  La operación es muy similar a la creación, con la diferencia que se debe incluir el identificador de la pauta a modificar.   

Atención: si se realizaron modificaciones a la pauta a través de la interfaz de administración, al realizar la modificación a través del API estos cambios se perderán, a menos que los especifique también en el request del API.

El request se debe realizar con el método POST

URL: /admin/jsapi/pauta?op=m

En caso de tener habilitada la opción de segmentación avanzada de pautas ver el artículo Segmentación avanzada de pautas más adelante en el manual.

 

Requisitos:

• La pauta debe estar creada
• Se debe conocer su identificador (pauta_id)
• La pauta no debe haber sido cancelada.
• Todos los requisitos para creación de pautas. 

 

Parámetros obligatorios:

    Se debe incluir el parámetro pauta_id, con el identificador de la pauta. Además, se deben incluir todos los mismo parámetros que para la creación. No se puede omitir ninguno, con las siguientes excepciones:

    Si la pauta ya se ha iniciado, no se puede modificar el parámetro fecha_inicio ni hora_inicio, por lo tanto no es necesario incluirlos en el request.   

 

Parámetros opcionales:

Los mismos parámetros que para la creación de pautas.

 

Ejemplo de request:
URL: /admin/jsapi/pauta?op=m
 
Parámetros:

pauta_id=43242&nombre=TestCPM&sitio_id=52432&tipoventa_id=1&cantidad_total=100000&prioridad=1&peso=1&intervalo_activacion=1&fecha_inicio=23/03/2006&fecha_fin=23/04/2006&hora_inicio=15:00:00&hora_fin=23:59:59&ptmodo_id=1&target_sitio_id=13212&target_espacio_id=45234+5414256&accion_retraso_fecha_fin=0

 

Explicación de los parámetros:

• pauta_id: identificador de la pauta
• nombre: Test CPM
• sitio_id: 52432 – el identificador del anunciante dueño de la pauta
• tipoventa_id: 1 (pauta por CPM)
• cantidad_total: 100000 impresiones
• prioridad: 1
• peso: 1
• intervalo_activacion: fecha de inicio y fecha de fin
• fecha_inicio: 23/03/2006
• fecha_fin: 23/04/2006
• hora_inicio: 15:00:00
• hora_fin: 23:59:59
• ptmodo_id: 1 – distribución uniforme de impresiones
• target_sitio_id: 13212 – el identificador del sitio donde correrá la pauta. target_espacio_id: 45234, 541, 426.  La pauta correrá en esos 3 espacios.
• accion_retraso_fecha_fin: 0 – continuar hasta cumplir la pauta. 
• Respuesta:
• Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).
• Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

 

Respuesta:

Contiene un objeto pauta_id , indicando el id de la pauta modificada y un objeto status, que indica el estado del resultado, en este caso 200, indica que la pauta se modifico correctamente.

Si la operación es fallida, mediante el objeto errors, muestra un listado de errores, indicando:

- un atributo que indica cada campo erróneo.

- y el valor de cada uno de esos atributos indicando  mensaje de error correspondiente.

 

También contiene un objeto status, que indica que el resultado fue erróneo, con un valor de 400.

 

Ejemplo de respuesta sin errores

 

Ejemplo de respuesta con errores