Service DRT utilisateur

Remarque

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

Le service DRT utilisateur a été créé pour permettre au DRT (magasin d’utilisateurs central détenu & géré par Corp-IT) de contrôler l’accès des utilisateurs. À terme, les rôles et les autorisations seront régis par le biais du service DRT.

L’ID central utilisé par DRT est , qui stocke les account_iddonnées de mappage entre l’ID utilisateur et l’ID de compte.

Remarque

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

Accès en lecture : tous les administrateurs.
Accès en écriture : seuls certains utilisateurs spécifiés dans la configuration.

API REST

HTTP, méthode	Point de terminaison	Decsription
`POST`	`https://api.appnexus.com/user-DRT` (Json DRT utilisateur)	Create un nouvel objet DRT utilisateur pour un utilisateur.
`PUT`	`https://api.appnexus.com/user-DRT?id=ID` (Json DRT utilisateur)	Modifier un objet DRT utilisateur.
`GET`	`https://api.appnexus.com/user-DRT`	Afficher les informations DRT pour tous les utilisateurs.
`GET`	`https://api.appnexus.com/user-DRT?id=ID`	Afficher les informations DRT pour un utilisateur spécifique.
`GET`	`https://api.appnexus.com/user-DRT?account_id=ACCOUNT_ID`	Affichez les informations DRT pour tous les utilisateurs sous un compte DRT spécifique.
`DELETE`	`https://api.appnexus.com/user-DRT?id=ID`	Supprimer les informations DRT pour un utilisateur.
`GET`	`https://api.appnexus.com/user-DRT/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.
`account_id`	int	ID de compte dans la table DRT. Cette valeur doit être supérieure à `0`. Par défaut:`null`
`username`	string	En lecture seule. Nom de connexion de l’utilisateur.
`first_name`	chaîne	En lecture seule. Prénom de l’utilisateur.
`last_name`	string	En lecture seule. Nom de famille de l’utilisateur.
`email`	string	En lecture seule. Adresse e-mail de l’utilisateur.
`user_type`	string	En lecture seule. Type d’utilisateur. Valeurs possibles : - `"member"` - `"bidder"` - `"publisher"` - `"advertiser"` - `"member_advertiser"` - `"member_publisher"`
`entity_id`	int	En lecture seule. ID de l’entité (membre ou soumissionnaire) à laquelle l’utilisateur appartient.
`read_only`	valeur booléenne	En lecture seule. Si `true`la valeur est , l’utilisateur n’est pas autorisé à apporter des modifications via l’API.

Exemples

Create un nouvel objet DRT utilisateur

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

Modifier les informations DRT pour un utilisateur

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

Afficher les informations DRT pour un utilisateur spécifique

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

Afficher les informations DRT pour tous les utilisateurs sous un compte spécifique

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

Supprimer un objet DRT 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-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
      }
   }
}

Last updated on 2025-04-01

Partager via