Partager via

Administration Rapport personnalisé

Remarque

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

Les administrateurs Xandr peuvent utiliser ce rapport pour exécuter des requêtes personnalisées sur le cluster de rapports interne. Utilisez avec précaution, c’est-à-dire éviter d’exécuter des requêtes lourdes.

API REST

HTTP, méthode Endpoint Description
POST https://api.com/report

(rapport JSON)		 Récupérer le rapport

Remarque

Consultez l’exemple ci-dessous pour connaître la procédure complète.

Champs JSON

Champ Type Description
report_type enum Type de rapport. Valeur possible : "admin_backdoor".
Obligatoire sur : POST
sql string Requête sql. Spécifiez une clause where/plage de dates comme filtre, sélectionnez uniquement les champs nécessaires, etc. Consultez l’exemple ci-dessous.
Obligatoire sur : POST
hostname enum Nom de la base de données. Valeur possible : "vt_jayz_internal" (Vertica Jayz).
Obligatoire sur : POST

Exemple

  1. Create une demande de rapport au format JSON

    $ cat admin_custom_report
               {
               "report": {
               "report_type": "admin_backdoor",
               "sql": "select * from agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5",
               "hostname": "vt_jayz_internal"
               }
               }

  2. POST la demande au service de création de rapports

    $ curl -b cookies -c cookies -X POST -d @admin_custom_report 'https://api..com/report'
               {
               "response": {
               "status": "OK",
               "report_id": "f83b50a62b9c2ba2b204ab073b4b8efb",
               "dbg_info": {
               "instance": "16.hbapi.prod.nym1",
               "s1ave_hit": false,
               "db": "master",
               "reads": 0,
               "read_limit": 100,
               "read_limit_seconds": 60,
               "writes": 2,
               "write_limit": 60,
               "write_limit_seconds": 60,
               "time": 331.21299743652,
               "start_microtime": 1323192961.6681,
               "version": "1.10.28.2",
               "master_instance": "01.hbapi.sand-08.lax1",
               "proxy": true,
               "master_time": 128.6518573761
               }
               }
               }

  3. Utiliser l’ID de rapport pour récupérer les données du rapport

    La réponse standard inclut les données du rapport et une URL de téléchargement que vous pouvez nous permettre d’enregistrer les données dans un fichier. Si vous souhaitez obtenir uniquement l’URL de téléchargement sans les données du rapport, transmettez "without_data" la chaîne de requête.

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=f83b50a62b9c2ba2b204ab073b4b8efb'
               {
               "response": {
               "status": "OK",
               "report": {
               "name": null,
               "created_on": "2011-12-06 20:50:17",
               "cache_hit": false,
               "fact_cache_hit": false,
               "fact_cache_error": "empty used fields",
               "json_request": "{\"report\":{\"report_type\":\"admin_backdoor\",\"sql\":\"select * from
               agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5\",
               \"hostname\":\"vt_jayz_internal\"}}",
               "header_info": "Report type:,admin_backdoor\u000d\u000a,\u000d\u000aRun at:,2011-12-06 20:50:17
               \u000d\u000aStart date:,\u000d\u000aEnd date:,\u000d\u000aTimezone:,\u000d\u000aUser:,
               John Smith (9685)\u000d\u000a",
               "data": "/mnt/isilon/reports/20111206/a4a937b4-6151-4678-ac65-0ab1f3790ae3",
               "url": "report-download?id=f83b50a62b9c2ba2b204ab073b4b8efb"
               },
               "execution_status": "ready",
               "dbg_info": {
               "instance": "16.hbapi.prod.nym1",
               "s1ave_hit": false,
               "db": "master",
               "reads": 1,
               "read_limit": 100,
               "read_limit_seconds": 60,
               "writes": 0,
               "write_limit": 60,
               "write_limit_seconds": 60,
               "time": 95.331907272339,
               "start_microtime": 1323205122.5099,
               "version": "1.10.27"
               }
               }
               }

  4. Utiliser l’URL de téléchargement pour enregistrer les données du rapport dans un fichier

    Vous utilisez le "url" champ dans la réponse pour enregistrer les données du rapport dans un fichier. Effectuez simplement un autre GET appel et identifiez l’emplacement et le fichier dans lesquels vous souhaitez enregistrer. Veillez à utiliser le fichier l’extension du "format" que vous avez spécifié dans votre demande initiale POST .

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=495d03a7667bac467bb488043ae336e9' > /tmp/admin_report.csv
  • Last updated on