Announcement: New async DELETE endpoint

async
analytics
announcements

#1

Today we are introducing the DELETE /1/stats/jobs/accounts/:account_id/:job_id endpoint. This will allow QUEUED or PROCESSING asynchronous analytics jobs to be cancelled.

Like our other DELETE endpoints, the entity ID is appended to the resource. We’ve also added a CANCELLED enum and an updated_at attribute to our asynchronous analytics response objects.

Twitter Ads API Team


Example request and response:

$ twurl -X DELETE -H ads-api.twitter.com "/1/stats/jobs/accounts/18ce54d4x5t/823634888955809793"
{
  "request": {
    "params": {
      "job_id": 823634888955809793,
      "account_id": "18ce54d4x5t"
    }
  },
  "data_type": "job",
  "data": {
    "start_time": "2016-10-25T07:00:00Z",
    "segmentation_type": "AGE",
    "url": null,
    "id_str": "823634888955809793",
    "entity_ids": [
      "6c62d"
    ],
    "end_time": "2016-12-05T08:00:00Z",
    "country": null,
    "placement": "ALL_ON_TWITTER",
    "id": 823634888955809793,
    "expires_at": null,
    "account_id": "18ce54d4x5t",
    "status": "CANCELLED",
    "granularity": "DAY",
    "entity": "LINE_ITEM",
    "created_at": "2017-01-23T20:53:54Z",
    "platform": null,
    "updated_at": "2017-01-23T20:53:54Z",
    "metric_groups": [
      "ENGAGEMENT"
    ]
  }
}

Twitter Ads API not cancelling jobs after an hour
Questions around async analytic timeouts
2017年3月:AdsAPI関連アップデートまとめ
#2

#3