Compartir a través de

Servicio de tipo de derechos

  • Artículo

Nota:

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

El servicio de tipo de derechos permite definir un código que se asignará a los miembros a través del servicio de miembros. Este código se usa para proporcionar ciertas características solo para miembros específicos. Por ejemplo, es posible que tengamos miembros a los que se les permita realizar la detección de destinos de palabras clave o de ofertas. Después de usar este servicio para crear tipos de derechos, puede asignar uno o varios tipos de derechos a un miembro.

API de REST

Http (método) Puntos Descripciones
GET https://api.appnexus.com/entitlement-type Ver todos los tipos de derechos
POST https://api.appnexus.com/entitlement-type Create un tipo de derecho
PUT https://api.appnexus.com/entitlement-type?id=ENTITLEMENT_TYPE_ID Modificación de un tipo de derecho
DELETE https://api.appnexus.com/entitlement-type?id=ENTITLEMENT_TYPE_ID Eliminación de un tipo de derecho

Campos JSON

General

Campo Tipo (longitud) Description
id Entero Identificador del tipo de derecho. Este valor se genera automáticamente en POST.

Valor predeterminado: número generado automáticamente.
code string Código asociado al derecho. Este valor lo establece el ingeniero y lo deben proporcionar ellos.
description object Descripción del derecho. Este valor es opcional y no tiene ningún efecto en el derecho real. Descripción es el único campo que se puede modificar una vez creado el tipo de derecho.
created_on Timestamp Fecha y hora en que se creó el derecho.

Valor predeterminado: se genera automáticamente al crear.
last_activity Timestamp Fecha y hora en que se modificó por última vez el derecho.

Valor predeterminado: se genera automáticamente en cada modificación.

Ejemplos

Ver todos los tipos de derechos

$ 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 tipo de derecho

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

Modificación de un tipo de derecho

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

Servicio de miembros