Servicio de grupo de miembros del vendedor

Artículo
05/17/2024

Nota:

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

Un grupo de miembros del vendedor consta de uno o varios miembros que venden inventario. Los compradores pueden dirigirse a grupos de miembros del vendedor además de miembros individuales para tener acceso a una mayor variedad de inventario, como el de publicadores más recientes y más pequeños.

Solo los administradores pueden escribir en este servicio.

API de REST

Http (método)	Endpoint	Description
`GET`	`https://api.appnexus.com/seller-member-group`	Ver una lista de todos los grupos de miembros del vendedor
`GET`	`https://api.appnexus.com/seller-member-group?id=SELLER_MEMBER_GROUP_ID`	Visualización de un grupo de miembros de vendedor específico
`GET`	`https://api.appnexus.com/seller-member-group?id=1,2,3`	Visualización de varios grupos de miembros de vendedor por identificador mediante una lista separada por comas

funciones de solo Administración

Solo los empleados de Xandr pueden crear, modificar o eliminar un grupo de miembros del vendedor.

Http (método)	Endpoint	Description
`POST`	`https://api.appnexus.com/seller-member-group` (JSON del grupo de miembros del vendedor)	Agregar un nuevo grupo de miembros del vendedor (solo administrador)
`PUT`	`https://api.appnexus.com/seller-member-group?id=SELLER_MEMBER_GROUP_ID` (JSON del grupo de miembros del vendedor)	Modificar un grupo de miembros del vendedor existente (solo administrador)
`DELETE`	`https://api.appnexus.com/seller-member-group?id=SELLER_MEMBER_GROUP_ID`	Eliminar un grupo de miembros del vendedor (solo administrador)

Campos JSON

Campo	Tipo	Description
`id`	Entero	Especifica el identificador interno asociado al grupo de miembros del vendedor. Obligatorio activado: `PUT`, en la cadena de consulta.
`name`	string	Especifica el nombre de este grupo de miembros del vendedor. Obligatorio activado: `POST`
`description`	string	Especifica una descripción para este grupo de miembros del vendedor. Obligatorio activado: `POST`
`display_order`	Entero	Especifica el orden en el que debe aparecer este grupo de miembros del vendedor. El valor predeterminado es `5`.
`member_count`	Entero	Especifica el número de miembros que hay actualmente en este grupo de miembros vendedores.
`hidden`	Booleano	Indica si este grupo de miembros del vendedor debe estar oculto o no. `0`: (Valor predeterminado) El grupo de miembros del vendedor no se ocultará en. `1`: el grupo de miembros del vendedor se ocultará.

Ejemplos

Ver todos los grupos de miembros del vendedor

$ curl -b cookies 'https://api.appnexus.com/seller-member-group'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "seller-member-groups": [
            {
                "id": 1,
                "name": " supply",
                "description": "Xandr seller member group",
                "display_order": 1,
                "hidden": false,
                "last_modified": "2016-03-08 15:30:02",
                "member_count": 103
            }
        ],
        "dbg_info": {
            "instance": "56.bm-hbapi.prod.lax1",
            "s1ave_hit": false,
            "db": "master",
            "user::reads": 3,
            "user::read_limit": 10000,
            "user::read_limit_seconds": 60,
            "user::writes": 0,
            "user::write_limit": 10000,
            "user::write_limit_seconds": 60,
            "reads": 0,
            "read_limit": 10000,
            "read_limit_seconds": 60,
            "writes": 0,
            "write_limit": 10000,
            "write_limit_seconds": 60,
            "awesomesauce_cache_used": false,
            "count_cache_used": false,
            "warnings": [],
            "time": 702.83794403076,
            "start_microtime": 1457486117.8624,
            "version": "1.16.479",
            "s1ave_miss": "no_s1aves_found",
            "s1ave_lag": 7,
            "member_last_modified_age": 1457486117,
            "output_term": "seller-member-groups"
        }
    }
}

Agregar un grupo de miembros del vendedor (solo administradores)

$ cat seller-member-group
{
    "seller-member-group": {
        "name": "My SMG",
        "description": "New seller member group",
        "display_order": 9
    }
}
$ curl -b cookies -X POST -d @seller-member-group 'https://api.appnexus.com/seller-member-group'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 4,
        "start_element": 0,
        "num_elements": 100,
        "seller-member-group": {
            "id": 17,
            "name": "Test SMG",
            "description": "New seller member group",
            "display_order": 9,
            "hidden": false,
            "last_modified": "2016-02-26 23:38:38",
            "member_count": 0
        }
    }
}

Compartir a través de