Partager via

Service type de droits d’utilisation

Remarque

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

Le service de type de droit vous permet de définir un code qui sera affecté aux membres par le biais du service membre. Ce code est utilisé pour fournir certaines fonctionnalités uniquement à des membres spécifiques. Par exemple, nous pouvons avoir des membres autorisés à effectuer mot clé ciblage ou la découverte de transactions. Après avoir utilisé ce service pour créer des types de droits, vous pouvez attribuer un ou plusieurs types de droits à un membre.

API REST

HTTP, méthode Points de terminaison Descriptions
GET https://api.appnexus.com/entitlement-type Afficher tous les types de droits
POST https://api.appnexus.com/entitlement-type Create un type de droit
PUT https://api.appnexus.com/entitlement-type?id=ENTITLEMENT_TYPE_ID Modifier un type de droit
DELETE https://api.appnexus.com/entitlement-type?id=ENTITLEMENT_TYPE_ID Supprimer un type de droit

Champs JSON

Généralités

Champ Type (Longueur) Description
id int ID du type de droit. Cette valeur est générée automatiquement sur POST.

Valeur par défaut : nombre généré automatiquement.
code string Code associé au droit d’utilisation. Cette valeur est définie par l’ingénieur et doit être fournie par celui-ci.
description objet Description du droit. Cette valeur est facultative et n’a aucun effet sur le droit réel. Description est le seul champ qui peut être modifié après la création du type de droit.
created_on Timestamp Date et heure de création du droit.

Par défaut : généré automatiquement lors de la création.
last_activity Timestamp Date et heure de la dernière modification du droit.

Par défaut : généré automatiquement à chaque modification.

Exemples

Afficher tous les types de droits

$ curl -b cookies 'https://api.appnexus.com/entitlement-type'
{
    "response": {
        "status": "OK",
        "count": 4,
        "start_element": 0,
        "num_elements": 100,
        "entitlement-types": [
            {
                "id": 1,
                "code": "seller_external_uid",
                "description": "Boolean, when true allows external uid mapping for a seller",
                "last_activity": "2016-10-12 15:39:28",
                "created_on": "2016-10-12 15:39:28"
            },
            {
                "id": 2,
                "code": "seller_deal_discovery",
                "description": "Boolean, when true allows deal discovery for a seller",
                "last_activity": "2016-10-13 16:43:51",
                "created_on": "2016-10-13 16:43:51"
            },
            {
                "id": 3,
                "code": "seller_keyword_targeting",
                "description": "Boolean, when true allows keyword targeting for a seller",
                "last_activity": "2016-10-13 16:43:51",
                "created_on": "2016-10-13 16:43:51"
            },
            {
                "id": 4,
                "code": "seller_keyword_segment_targeting",
                "description": "Boolean, when true allows keyword-based segment targeting for a seller",
                "last_activity": "2016-10-13 16:43:51",
                "created_on": "2016-10-13 16:43:51"
            }
        ],
...
}

Create un type de droit

$cat entitlement_type.json
{
    "entitlement-type": {
        "code": "test_entitlement_code",
        "description": "testing entitlement type"
    }
}

$ curl -b cookies -X POST -d @entitlement_type.json 'https://api.appnexus.com/entitlement-type'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1,
        "start_element": 0,
        "num_elements": 100,
        "entitlement-type": {
            "id": 1,
            "code": "test_entitlement_code",
            "description": "testing entitlement type",
            "last_activity": "2016-12-02 16:47:47",
            "created_on": "2016-12-02 16:47:47"
        }, ...
}

Modifier un type de droit

 $cat entitlement_type_update.json

{
    "entitlement-type": {
        "description": "entitlement type for testing"
    }
}

$ curl -b cookies -X POST -d @entitlement_type_update.json 'https://api.appnexus.com/entitlement-type?id=1'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1,
        "start_element": 0,
        "num_elements": 100,
        "entitlement-type": {
            "id": 1,
            "code": "test_entitlement_code",
            "description": "entitlement type for testing",
            "last_activity": "2016-12-02 16:56:48",
            "created_on": "2016-12-02 16:47:47"
        }, ...
}

Service membre

  • Last updated on