Service d’interface utilisateur utilisateur

Remarque

Le service d’interface utilisateur utilisateur est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

Ce service est déconseillé à la fin de juin 2014, dans le cadre de la version API 1.15. Étant donné que la version 1.15 est une version de modification cassant, ce service ne disparaîtra pas jusqu’à 60 jours après la publication de la version 1.15 (probablement fin août 2014).

Le service d’interface utilisateur utilisateur vous permet de modifier si l’approbation des pairs de campagne est requise pour les utilisateurs.

Remarque

Les paramètres de l’interface utilisateur ne sont pas appliqués dans la couche de service pour l’activation de campagne. Ce service d’API n’interagit pas avec la logique d’API. Le service ne peut pas réellement modifier les paramètres d’approbation d’homologue utilisateur et ne peut pas empêcher la création de campagnes non approuvées par un utilisateur dans l’API. Au lieu de cela, l’objectif du service d’interface utilisateur utilisateur est exclusivement de conserver les autorisations pour les cas d’utilisation de l’interface utilisateur graphique autour de l’activation de campagne et d’aider à gérer les flux de travail dans.

Ce service n’est accessible qu’aux types d’utilisateurs suivants :

• member
• advertiser
• member_advertiser

API REST

HTTP, méthode	Endpoint	Description
POST	https://api.appnexus.com/user-ui (JSON de l’interface utilisateur)	Create un nouvel objet d’interface utilisateur utilisateur pour un utilisateur.
PUT	https://api.appnexus.com/user-ui?id=ID (JSON de l’interface utilisateur)	Modifiez les paramètres via un objet d’interface utilisateur.
GET	https://api.appnexus.com/user-ui	Afficher les paramètres de tous les objets d’interface utilisateur utilisateur.
GET	https://api.appnexus.com/user-ui?id=ID	Afficher les paramètres d’un objet d’interface utilisateur utilisateur spécifique.
DELETE	https://api.appnexus.com/user-ui?id=ID	Supprimer les paramètres d’un objet d’interface utilisateur.
GET	https://api.appnexus.com/user-ui/meta	Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Champ	Type	Description
id	int	ID de l’utilisateur correspondant. Les entrées en double du même utilisateur ne sont pas autorisées. Obligatoire On :PUT/DELETE, dans la chaîne de requête.
member_id	int	En lecture seule. ID du membre auquel appartient cet utilisateur.
require_campaign_approval	valeur booléenne	Indique si les campagnes créées par cet utilisateur nécessitent une approbation avant de pouvoir être activées. Par défaut:false

Exemples

Ajouter des exigences d’approbation de campagne pour un utilisateur en créant un objet d’interface utilisateur utilisateur

$ 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
  }
}

Modifier les exigences d’approbation de campagne pour un utilisateur en modifiant l’objet d’interface utilisateur utilisateur

$ 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"
   }
}

Afficher les exigences d’approbation de campagne pour un utilisateur spécifique

$ 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"
   }
}

Supprimer un objet d’interface utilisateur et les informations relatives aux exigences d’approbation de campagne qu’il contient

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/user-ui?id=393404'
{
   "response" : {
      "status" : "OK"
   }
   }