Servicio DRT de usuario

Artículo
05/18/2024

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

El servicio DRT de usuario se creó para permitir que el DRT (el almacén de usuarios central propiedad de & mantenido por Corp-IT) controlara el acceso de los usuarios. Con el tiempo, los roles y permisos se regirán a través del servicio DRT.

El identificador central usado por DRT es account_id, que almacena los datos de asignación entre el identificador de usuario y el identificador de cuenta.

Nota:

Este servicio solo es accesible para los siguientes tipos de usuarios:

Acceso de lectura: todos los administradores.
Acceso de escritura: solo determinados usuarios especificados en la configuración.

API de REST

Http (método)	Punto de conexión	Decsription
`POST`	`https://api.appnexus.com/user-DRT` (JSON de DRT de usuario)	Cree un nuevo objeto DRT de usuario para un usuario.
`PUT`	`https://api.appnexus.com/user-DRT?id=ID` (JSON de DRT de usuario)	Modificar un objeto DRT de usuario.
`GET`	`https://api.appnexus.com/user-DRT`	Vea la información de DRT para todos los usuarios.
`GET`	`https://api.appnexus.com/user-DRT?id=ID`	Ver la información de DRT de un usuario específico.
`GET`	`https://api.appnexus.com/user-DRT?account_id=ACCOUNT_ID`	Vea la información de DRT de todos los usuarios en una cuenta de DRT específica.
`DELETE`	`https://api.appnexus.com/user-DRT?id=ID`	Quite la información de DRT de un usuario.
`GET`	`https://api.appnexus.com/user-DRT/meta`	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo	Tipo	Descripción
`id`	Entero	Identificador del usuario correspondiente. No se permiten entradas duplicadas del mismo usuario. Obligatorio On:`PUT`/`DELETE`, en la cadena de consulta.
`account_id`	Entero	Identificador de cuenta en la tabla DRT. Debe ser mayor que `0`. Predeterminado:`null`
`username`	string	Solo lectura. Nombre de inicio de sesión del usuario.
`first_name`	string	Solo lectura. Nombre del usuario.
`last_name`	string	Solo lectura. Apellidos del usuario.
`email`	string	Solo lectura. La dirección de correo electrónico del usuario.
`user_type`	string	Solo lectura. Tipo de usuario. Posibles valores: - `"member"` - `"bidder"` - `"publisher"` - `"advertiser"` - `"member_advertiser"` - `"member_publisher"`
`entity_id`	Entero	Solo lectura. Identificador de la entidad (miembro o licitador) a la que pertenece el usuario.
`read_only`	booleano	Solo lectura. Si `true`es , el usuario no puede realizar cambios a través de la API.

Ejemplos

Creación de un nuevo objeto DRT de usuario

$ cat user-DRT.json
{
    "user-DRT": {
        "id": "11",
        "account_id": "123"
    }
}

$ curl -b cookies -c cookies -X POST -d @user-DRT.json 'https://api.appnexus.com/user-DRT'
{
   "response" : {
      "count" : 1,
      "status" : "OK",
      "num_elements" : 100,
      "user-DRT" : {
         "user_type" : "member",
         "last_name" : null,
         "username" : "dwm6",
         "account_id" : 123,
         "email" : null,
         "entity_id" : "6",
         "read_only" : "0",
         "id" : 11,
         "first_name" : null
      },
      "id" : 11,
      "start_element" : 0
   }
}

Modificación de la información de DRT para un usuario

$ cat modify-user-DRT.json
{
    "user-DRT": {
        "account_id": "321"
    }
}

$ curl -b cookies -c cookies -X PUT -d @modify-user-DRT.json 'https://api.appnexus.com/user-DRT?id=11'
{
   "response" : {
      "count" : 1,
      "status" : "OK",
      "num_elements" : 100,
      "user-DRT" : {
         "user_type" : "member",
         "last_name" : null,
         "username" : "dwm6",
         "account_id" : 223,
         "email" : null,
         "entity_id" : "6",
         "read_only" : "0",
         "id" : 11,
         "first_name" : null
      },
      "id" : "11",
      "start_element" : 0
   }
}

Visualización de la información de DRT para un usuario específico

$ curl -b cookies -c cookies -X GET 'https://api.appnexus.com/user-DRT?id=11'
{
   "response" : {
      "count" : 1,
      "status" : "OK",
      "num_elements" : 100,
      "user-DRT" : {
         "user_type" : "member",
         "last_name" : null,
         "username" : "dwm6",
         "account_id" : 223,
         "email" : null,
         "entity_id" : "6",
         "read_only" : "0",
         "id" : 11,
         "first_name" : null
      },
      "start_element" : 0
   }
}

Visualización de la información de DRT para todos los usuarios en una cuenta específica

$ curl -b cookies -c cookies -X GET 'https://api.appnexus.com/user-DRT?account_id=123'
{
   "response" : {
      "count" : 2,
      "status" : "OK",
      "num_elements" : 100,
      "user-DRTs" : [
         {
            "user_type" : "member",
            "last_name" : null,
            "username" : "data-provider",
            "account_id" : 123,
            "email" : null,
            "entity_id" : "3",
            "read_only" : "0",
            "id" : 6,
            "first_name" : null
         },
         {
            "user_type" : "member",
            "last_name" : null,
            "username" : "dwm273",
            "account_id" : 123,
            "email" : null,
            "entity_id" : "273",
            "read_only" : "0",
            "id" : 12,
            "first_name" : null
         }
      ],
      "start_element" : 0
   }
}

Eliminar un objeto DRT de usuario y la información de requisitos de aprobación de la campaña que contiene

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/user-DRT?id=11'
{
   "response" : {
      "status" : "OK",
      "dbg_info" : {
         "warnings" : [],
         "db" : "master",
         "version" : "trunk",
         "time" : 89.476108551025,
         "start_microtime" : 1396626820.4141,
         "awesomesauce_cache_used" : false,
         "count_cache_used" : false,
         "instance" : "localhost",
         "output_term" : "not_found",
         "s1ave_hit" : false
      }
   }
}

Compartir a través de