Servicio de interfaz de usuario de usuario

Artículo
05/18/2024

Nota:

El servicio de interfaz de usuario de usuario está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

Este servicio está en desuso a finales de junio de 2014, como parte de la versión api 1.15. Dado que 1.15 es una versión de cambio importante, este servicio no desaparecerá realmente hasta 60 días después de la versión 1.15 (probablemente a finales de agosto de 2014).

El servicio de interfaz de usuario de usuario le permite cambiar si la aprobación del mismo nivel de campaña es necesaria para los usuarios.

Nota:

La configuración de la interfaz de usuario de usuario no se aplica en la capa de servicio para la activación de la campaña. Este servicio de API no interactúa con la lógica de API. El servicio no puede cambiar realmente la configuración de aprobación del mismo nivel de usuario y no puede impedir la creación de campañas no aprobadas por un usuario en la API. En su lugar, el propósito del servicio de interfaz de usuario de usuario es exclusivamente mantener los permisos para los casos de uso de GUI en torno a la activación de la campaña y ayudar con la administración del flujo de trabajo en.

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

member
advertiser
member_advertiser

API de REST

Http (método)	Endpoint	Description
`POST`	`https://api.appnexus.com/user-ui` (JSON de la interfaz de usuario de usuario)	Cree un nuevo objeto de interfaz de usuario de usuario para un usuario.
`PUT`	`https://api.appnexus.com/user-ui?id=ID` (JSON de la interfaz de usuario de usuario)	Modificar la configuración a través de un objeto de interfaz de usuario de usuario.
`GET`	`https://api.appnexus.com/user-ui`	Ver la configuración de todos los objetos de interfaz de usuario de usuario.
`GET`	`https://api.appnexus.com/user-ui?id=ID`	Ver la configuración de un objeto de interfaz de usuario de usuario específico.
`DELETE`	`https://api.appnexus.com/user-ui?id=ID`	Quite la configuración de un objeto de interfaz de usuario de usuario.
`GET`	`https://api.appnexus.com/user-ui/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.
`member_id`	Entero	Solo lectura. Identificador del miembro al que pertenece este usuario.
`require_campaign_approval`	booleano	Si las campañas creadas por este usuario requieren aprobación antes de que se puedan activar. Predeterminado:`false`

Ejemplos

Adición de requisitos de aprobación de campaña para un usuario mediante la creación de un nuevo objeto de interfaz de usuario de usuario

$ cat user-ui.json
{
    "user-ui": {
        "id": "5771",
        "require_campaign_approval": "false"
    }
}

$ curl -b cookies -c cookies -X POST -d @user-ui.json 'https://api.appnexus.com/user-ui'
{
   "response" : {
      "user-ui" : {
         "require_campaign_approval" : false,
         "member_id" : 3897,
         "id" : 5771
      },
      "count" : 1,
      "status" : "OK",
      "id" : 5771
  }
}

Modificación de los requisitos de aprobación de campaña para un usuario mediante la modificación del objeto de interfaz de usuario de usuario

$ cat modify-user-ui.json
{
    "user-ui": {
        "id": "5771",
        "require_campaign_approval": "true"
    }
}

$ curl -b cookies -c cookies -X PUT -d @modify-user-ui.json 'https://api.appnexus.com/user-ui?id=393404'
{
   "response" : {
      "user-ui" : {
         "require_campaign_approval" : true,
         "id" : 5771
      },
      "count" : 1,
      "status" : "OK",
      "id" : "5771"
   }
}

Ver los requisitos de aprobación de campañas para un usuario específico

$ curl -b cookies -c cookies -X GET 'https://api.appnexus.com/user-ui?id=5771'
{
   "response" : {
      "user-ui" : {
         "require_campaign_approval" : true,
         "id" : 5771
      },
      "count" : 1,
      "status" : "OK"
   }
}

Eliminar un objeto de interfaz de usuario 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-ui?id=393404'
{
   "response" : {
      "status" : "OK"
   }
   }

Compartir a través de