Partager via


SLD Use Subdomain service

Remarque

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

Le service d’utilisation du sous-domaine de second niveau (SLD) est un service administrateur uniquement qui permet aux utilisateurs d’ajouter des lignes à la api.sld_use_subdomain table. Cette table est utilisée par adserver pour lui indiquer pour quels domaines de second niveau ils doivent suivre les sous-domaines. Soyez prudent lorsque vous ajoutez ou mettez à jour des objets à l’aide de ce service.

Avertissement

#iq-engineering doit confirmer toutes les nouvelles entrées dans ce service. NE PUBLIEZ PAS de nouvelles entrées sans confirmation.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/sld-use-subdomain
(modèle JSON)
Ajoutez une nouvelle entrée à sld-use-subdomain.
PUT https://api.appnexus.com/sld-use-subdomain?id=SETTING_ID
(modèle JSON)

Remarque : SETTING_ID est une valeur générée automatiquement pour la table spécifique et peut être récupérée via GET.
Modifier une entrée dans sld-use-subdomain.
DELETE https://api.appnexus.com/sld-use-subdomain?id=SETTING_ID Supprimer une entrée dans sld-use-subdomain.
GET https://api.appnexus.com/sld-use-sudbomain?id=SETTING_ID Afficher une entrée spécifique dans sld-use-sudbomain.

Champs JSON

Champ Type (Longueur) Description
id int ID de l’enregistrement sld-use-subomain.

Valeur par défaut : nombre généré automatiquement.
Obligatoire Sur : PUT/DELETE, dans la chaîne de requête
secondary_level_domain string(100) Domaine pour lequel effectuer le suivi secondary_level_domainsde .

Par défaut : None
Obligatoire sur : POST
active valeur booléenne Indique si l’enregistrement est actif ou non.

Par défaut : true

Exemples

Afficher tout sld-use-subdomains

$ curl -b cookies -c cookies 'https://api.appnexus.com/sld-use-subdomain'
{
  "response": {
    "status": "OK",
    "count": 66,
    "start_element": 0,
    "num_elements": 100,
    "sld-use-subdomains": [
      {
        "id": 1,
        "secondary_level_domain": "co.uk",
        "active": true,
        "last_activity": "2010-07-27 20:40:17"
      },
      {
        "id": 2,
        "secondary_level_domain": "live.com",
        "active": true,
        "last_activity": "2011-02-04 14:59:47"
      },
      {
        "id": 3,
        "secondary_level_domain": "msn.com",
        "active": true,
        "last_activity": "2011-03-02 20:23:00"
      },
      {
        "id": 4,
        "secondary_level_domain": "mtv.com",
        "active": true,
        "last_activity": "2011-04-26 13:50:01"
      },
      {
        "id": 5,
        "secondary_level_domain": "live.ca",
        "active": true,
        "last_activity": "2011-06-09 18:17:22"
      },
        ...
        ]
}

Ajouter un nouveau sld-use-subdomain

$ cat sld-use-subdomain

{
    "sld-use-subdomain": {
        "secondary_level_domain": "newdomain.com",
        "active": true
    }
}
$ curl -b cookies -c cookies -X POST -d @sld-use-subdomain 'https://api.appnexus.com/sld-use-subdomain'
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 73,
    "start_element": 0,
    "num_elements": 100,
    "sld-use-subdomain": {
      "id": 73,
      "secondary_level_domain": "newdomain.com",
      "active": true,
      "last_activity": "2015-01-14 22:05:02"
    },
    "dbg_info": {
      "instance": "10.hbapi.sand-08.nym2",
      "s1ave_hit": false,
      "db": "master",
      "awesomesauce_cache_used": false,
      "count_cache_used": false,
      "warnings": [
      ],
      "time": 2493.2899475098,
      "start_microtime": 1421273101.3622,
      "version": "1.15.327",
      "s1ave_lag": 0,
      "member_last_modified_age": 1421273101,
      "output_term": "sld-use-subdomain"
    }
  }
}

Modifier un sld-use-subdomain

$ cat sld-use-subdomain
 
{
    "sld-use-subdomain": {
        "secondary_level_domain": "newdomain.com",
        "active": true
    }
}
$ curl -b cookies -c cookies -X PUT -d @template_update 'https://api.appnexus.com/template?id=73'
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 73,
    "start_element": 0,
    "num_elements": 100,
    "sld-use-subdomain": {
      "id": 73,
      "secondary_level_domain": "newdomain.com",
      "active": false,
      "last_activity": "2015-01-14 22:05:02"
    },
    "dbg_info": {
      "instance": "10.hbapi.sand-08.nym2",
      "s1ave_hit": false,
      "db": "master",
      "awesomesauce_cache_used": false,
      "count_cache_used": false,
      "warnings": [
      ],
      "time": 2493.2899475098,
      "start_microtime": 1421273101.3622,
      "version": "1.15.327",
      "s1ave_lag": 0,
      "member_last_modified_age": 1421273101,
      "output_term": "sld-use-subdomain"
    }
  }
}