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

• 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)

• 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: (sí), 1 (no)

◦       Valor default: 1 (no)

• Agregar anuncio: mostrar advertencias de formato

◦       Parámetro: usuario_preferencia_9

◦       Valores posibles: (sí), 1 (no)

◦       Valor default: 1 (no)

• Control de validez de URLs de clic

◦       Parámetro: usuario_preferencia_12

◦       Valores posibles: (inactivo), 1 (activo)

◦       Valor default: 1 (activo)

• Al agregar anuncios, seleccionar automáticamente los espacios

◦       Parámetro: usuario_preferencia_13

◦       Valores posibles: (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: (no), 1 (sí)

◦       Valor default: 0 (no)                   

• Recibir por e-mail notificaciones sobre el servicio

◦       Parámetro: usuario_preferencia_15

◦       Valores posibles: (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: (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: (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: (no), 1 (sí)

◦       Valor default: 0 (no)

• Modo de visualización de la interfaz

◦       Parámetro: usuario_preferencia_24

◦       Valores posibles: (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: (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:

https://admin.eu.e-planning.net/admin/adnet/pub/admin/usuarios.html?op=a&o=xml&t=128&nombre=usuario&apellido=api&login=apilog&password=138gfh4&password2=138gfh4&email=sborneoepl@gmail.com&nivel_permisos=1&enviar_mail_bienvenida=0&preferencias_default=1

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

Ejemplo de respuesta con errores