Modificación de fechas y cantidades de pauta
Modificación de los siguientes atributos de una pauta: fecha_inicio, fecha_fin, cantidad_total.
El request se debe realizar con el método POST
URL: /admin/adnet/pub/admin/pautas.html?op=mfc&o=xml
Requisitos:
- La pauta debe estar creada
- Se debe conocer su identificador (pauta_id)
- La pauta no debe haber sido cancelada.
- La pauta no debe tener múltiples fechas de inicio y fin
- La pauta no debe tener asignaciones de acciones (impresiones o clicks) por espacio.
- Si la pauta ya comenzó, no se puede modificar la fecha de inicio.
- La pauta no debe haberse completado.
- La fecha de inicio siempre debe ser futura. La fecha de fin debe ser posterior a la fecha de inicio y también futura.
Parámetros obligatorios:
Se debe incluir el parámetro pauta_id, con el identificador de la pauta. Además, se deben incluir los siguientes parámetros:
- fecha_inicio: fecha de inicio de la pauta. Sólo se puede indicar si la pauta está en estado Programada o Programada y Aprobada. Debe ser una fecha futura.
- fecha_fin: fecha de finalización de la pauta. Debe ser una fecha futura y mayor que la fecha de inicio.
- cantidad_total: cantidad de impresiones, clicks o conversiones asignada a la pauta. Debe ser un número entero mayor o igual a la cantidad de impresiones (o clicks o conversiones) ya cumplidas. Ej: si la pauta ya cumplió 5.000 impresiones, no se puede especificar una cantidad menor a 5.000.
Parámetros opcionales:
- hora_inicio: hora de inicio de la pauta. Si no se la especifica, se toma como 00:00:00.
- hora_fin: hora de fin de la pauta, en la fecha_fin. Si se la omite, se toma el valor 23:59:59.
Ejemplo de request:
URL: /admin/adnet/pub/admin/pautas.html?op=mfc&o=xml
Parámetros:
pauta_id=43242&&cantidad_total=100000&fecha_inicio=23/03/2006&fecha_fin=23/04/2006&hora_inicio=15:00:00&hora_fin=23:59:59
Explicación de los parámetros:
- pauta_id: identificador de la pauta
- cantidad_total: 100000 impresiones
- fecha_inicio: 23/03/2006
- fecha_fin: 23/04/2006
- hora_inicio: 15:00:00
- hora_fin: 23:59:59
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.
Ejemplo de respuesta sin errores
<operacion> <resultado>1</resultado> </operacion> |
Ejemplo de respuesta con errores
<operacion> <resultado>0</resultado> <errores> <error atributo=”fecha_fin” mensaje=”La fecha de fin no puede ser anterior a la fecha de inicio”> </errores> </operacion> |