Creación de usuarios

URL: /admin/adnet/pub/admin/usuarios.html?op=a&o=xml
 
Parámetros obligatorios:

Tipo de sitio.
◦     Parámetro: t
◦     Valores posibles:
1 Usuario de cuenta: Indicar según tipo de cuenta si es una network (128), si es un sitio (8) o si es una agencia (16)
2 Network externa: 512
3 Agencia: 1.
4 Anunciante: 4
5 Anunciante con autogestión: 1024
6 Sitio propio (de la cuenta): 64
7 Sitio de otra empresa: 2
8  

Identificación de sitio (sólo si en el punto anterior se eligió opción 2 a 7).
◦     Parámetro: sitio_id_TIPO (donde TIPO debe ser reemplazado por el valor del parámetro t del punto anterior).
◦     Valores posibles: Son los IDS correspondientes al tipo de sitio seleccionada. Por ejemplo, si en el punto anterior se eligió un Anunciante, entonces el nombre del parámetro será sitio_id_4 y su valor será el ID de un anunciante.
 
Nombre.
◦     Parámetro: nombre
◦     Valor: Cadena de caracteres
 
Apellido.
◦     Parámetro: apellido
◦     Valor: Cadena de caracteres
 
Login.
◦     Parámetro: login
◦     Valor: Cadena de caracteres. El login debe ser único para cada usuario de la interfaz del cliente.
 
Contraseña
◦     Parámetro: password
◦     Valor: Cadena de caracteres que contenga números y letras.
 
Contraseña (confirmación)
◦     Parámetro: password2
◦     Valor: Debe tener exactamente el mismo contenido que el parámetro password.
 
E-mail
◦     Parámetro: email
◦     Valor: Una dirección de e-mail válida
 
Permisos
◦     Parámetro: nivel_permisos
◦     Valores posibles: 0 si desea otorgar al usuario un set de permisos mínimos, 1 si desea otorgar todos los permisos posibles. Tanto los permisos mínimos como máximos están determinados por el perfil del usuario (anunciante, agencia, etc.)
 
Enviar mail de bienvenida
◦     Parámetro: enviar_mail_bienvenida
◦     Valores posibles:
1 No: 0
2 Login y clave: 1 (sólo envía mail con login y clave del usuario)
3 Datos de soporte: 2 (sólo envía mail con datos de contacto de soporte)
4 Login, clave y datos de soporte: 3 (con el contenido de los dos puntos anteriores)
5 

Preferencias
◦     Parámetro: preferencias_default
◦     Valores posibles: 1 (Toma las preferencias seteadas por default en la cuenta)


Parámetros opcionales:

Instant messenger
◦     Parámetro: instant_messenger
◦     Valor: El nombre de usuario utilizando en algún software de mensajería instantánea.
 
Celular
◦     Parámetro: celular
◦     Valor: Un número de teléfono celular
 
Teléfono
◦     Parámetro: telefono
◦     Valor: Un número de teléfono
 
Identificador personalizado
◦     Parámetro: custom_id
◦     Obligatorio: según lo establecido en la Preferencia Global de la cuenta.
◦     Valor: Es un ID que identifica al usuario de e-planning en un sistema de terceros. Puede ser alfanumérico.
 
Observaciones
◦     Parámetro: observaciones
◦     Valor: Campo de texto libre para ingresar comentarios acerca del usuario
 
Grupo de pautas
◦     Parámetro: gpauta_id
◦     Valores posibles: Son los ids de los grupos de pautas a los que tendrá acceso el usuario en los informes estadísticos.
 
Direcciones IP de acceso permitidas
◦     Parámetro: redes_permitidas
◦     Valor: Puede ingresar de a una por línea, las direcciones IPs desde las cuales se le permitirá acceso a la interfaz. Dejar en blanco para acceso irrestricto. Utilizar el formato aaa.bbb.ccc.ddd/nnn.nnn.nnn.nnn para ingresar bloques de direcciones.
 

Preferencias del usuario:

Al crear un usuario es posible especificar sus preferencias: idioma, formatos de fecha y número, etc.   Es posible indicar el valor de cada preferencia en forma individual o solicitar que se utilicen los valores default de cada una de ellas.
Para indicar que se utilicen valores default, debe agregarse el parámetro preferencias_default=1 al request en cuestión. Sin embargo, si se quisiera especificar el valor de alguna preferencia en particular, entonces habrá que hacerlo para todas y cada una de ellas. No es posible combinar ambos mecanismos (valores default para algunas preferencias e indicar valores específicos para otras).
Las preferencias y sus valores posibles son las siguientes:
 
Idioma
◦       Parámetro: usuario_preferencia_1
◦       Valores posibles: ar (árabe), bg (búlgaro), ca (catalán), de (alemán), en (inglés), es (español), pt (portugués), ru (ruso).
◦       Valor default: es (español).
 
Formato de fecha
◦       Parámetro: usuario_preferencia_3
◦       Valores posibles: 1 (dd/mm/aaaa), 2 (mm/dd/aaaa), 3 (formato árabe).
◦       Valor default: 1 (dd/mm/aaaa).
 
Formato de número
◦       Parámetro: usuario_preferencia_4
◦       Valores posibles: 1 (x.xxx.xxx,yy), 2 (x,xxx,xxx.yy), 3 (formato árabe).
◦       Valor default: 1 (x.xxx.xxx,yy).
 
Cantidad de filas para informes
◦       Parámetro: usuario_preferencia_6
◦       Valores posibles: 10, 30, 50, 100, 200, 500, 1000, 2000, 5000, 10000
◦       Valor default: 30
 
Cantidad de filas para listados
◦       Parámetro: usuario_preferencia_7
◦       Valores posibles: 10, 30, 50, 100
◦       Valor default: 30
 
Animación de gráficos
◦       Parámetro: usuario_preferencia_8
◦       Valores posibles: 0 (sí), 1 (no)
◦       Valor default: 1 (no)
 
Agregar anuncio: mostrar advertencias de formato
◦       Parámetro: usuario_preferencia_9
◦       Valores posibles: 0 (sí), 1 (no)
◦       Valor default: 1 (no)
 
Control de validez de URLs de clic
◦       Parámetro: usuario_preferencia_12
◦       Valores posibles: 0 (inactivo), 1 (activo)
◦       Valor default: 1 (activo)
 
Al agregar anuncios, seleccionar automáticamente los espacios
◦       Parámetro: usuario_preferencia_13
◦       Valores posibles: 0 (nunca), 1 (siempre), 2 (sólo cuando haya un único espacio)
◦       Valor default: 2 (sólo cuando haya un único espacio)
 
Mostrar fechas de inicio y fin en listado de anuncios
◦       Parámetro: usuario_preferencia_14
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 0 (no)                  
 
Recibir por e-mail notificaciones sobre el servicio
◦       Parámetro: usuario_preferencia_15
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 1 (sí)
 
En el listado de pautas, mostrar el identificador de la pauta junto al nombre
◦       Parámetro: usuario_preferencia_18
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 0 (no)
 
En el listado de pautas mostrar filtro por tamaño del anuncio
◦       Parámetro: usuario_preferencia_21
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 0 (no)
 
Richmedia - Mostrar el tag en el listado (hace que la página tarde más en cargar)
◦       Parámetro: usuario_preferencia_22
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 0 (no)
 
Modo de visualización de la interfaz
◦       Parámetro: usuario_preferencia_24
◦       Valores posibles: 0 (tradicional), 1 (nueva versión)
◦       Valor default: 0 (tradicional)
 
Filtro de información de pautas por contacto trafficker de la orden
◦       Parámetro: usuario_preferencia_25
◦       Valores posibles: 0 (no), 1 (sí)
◦       Valor default: 0 (no)
 
Formato de los informes por mail
◦       Parámetro: usuario_preferencia_26
◦       Valores posibles: csv (Formato CSV), xslx (Formato Excel 2007+)
◦       Valor default: csv (Formato CSV)
 
Ejemplo de URL con parámetros:
/admin/jsapi/usuario?op=a&t=128&nombre=usuario&apellido=api&login=apilog&password=138gfh4&password2=138gfh4&email=mail@gmail.com&nivel_permisos=1&enviar_mail_bienvenida=0&preferencias_default=1&sitio_id_128=1661567

Respuesta:
Contiene un objeto usuario_id , indicando el id del  usuario creado y un objeto status, que indica el estado del resultado, en este caso 200, indica que el usuario se creo 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: