Measurement

应用列表

在 Postman 中运行 ❯

GET accounts/:account_id/app_lists

检索与当前账号关联的部分或所有应用列表的详细信息。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/app_lists

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t
app_list_ids
可选

通过指定以逗号分隔的标识符列表，将响应范围限定为所需的应用列表。最多可提供 200 个 ID。

类型：string

示例：wm7x
count
可选

指定每个不同请求尝试检索的记录数量。

类型：int

默认值：200
最小值、最大值：1、1000
cursor
可选

指定光标以获取下一页结果。参阅分页了解更多信息。

类型：string

示例：8x7v00oow
sort_by
可选

根据支持的属性，按升序或降序排序。参阅排序了解更多信息。

类型：string

示例：created_at-asc
with_deleted
可选

在请求中包含已删除的结果。

类型：boolean

默认值：false
可能值：true、false
with_total_count
可选

包含 total_count 响应属性。

注意：不包含此参数和 cursor。

注意：包含 total_count 的请求速率限制较低，目前设置为每 15 分钟 200 次。

类型：boolean

默认值：false
可能值：true、false

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_lists?app_list_ids=wm7x

响应示例

{
  "request": {
    "params": {
      "app_list_ids": [
        "wm7x"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "id": "wm7x",
      "name": "foo @ 14026528192426843"
    }
  ]
}

GET accounts/:account_id/app_lists/:app_list_id

检索与当前账号关联的具体应用列表。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/app_lists/:app_list_id

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t
app_list_id
必需

请求中对正在操作的应用列表的引用。

类型：string

示例：28ukf
with_deleted
可选

在请求中包含已删除的结果。

类型：boolean

默认值：false
可能值：true、false

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_lists/28ukf

响应示例

{
  "data": {
    "name": "twitter @ 262689209670784",
    "id": "28ukf",
    "created_at": "2017-08-17T17:07:42Z",
    "updated_at": "2017-08-17T17:07:42Z",
    "deleted": false,
    "apps": [
      {
        "app_store_identifier": "com.twitter.android",
        "os_type": "Android"
      }
    ]
  },
  "request": {
    "params": {
      "app_list_id": "28ukf",
      "account_id": "18ce54d4x5t"
    }
  }
}

POST accounts/:account_id/app_lists

创建与当前账号关联的 app_list。

目前，每 account_id 的对象限制是 100 个 app_list 对象，每 app_list 的应用限制是 500 个应用。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/app_lists

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t
app_store_identifiers
必需

将加入到 app_list 中的应用商店标识符

类型：string

示例：com.twitter.android
name
必需

将分配给 app_list 的名称

类型：string

示例：My First App List

请求示例

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_lists?name=app list&app_store_identifiers=com.twitter.android

响应示例

{
  "data": {
    "name": "app list",
    "id": "2a4um",
    "created_at": "2017-09-06T07:17:26Z",
    "updated_at": "2017-09-06T07:17:26Z",
    "deleted": false,
    "apps": [
      {
        "app_store_identifier": "com.twitter.android",
        "os_type": "Android"
      }
    ]
  },
  "request": {
    "params": {
      "app_store_identifiers": [
        "com.twitter.android"
      ],
      "name": "app list",
      "account_id": "18ce54d4x5t"
    }
  }
}

DELETE accounts/:account_id/app_lists/:app_list_id

删除与当前账号关联的指定应用列表。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/app_lists/:app_list_id

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t
app_list_id
必需

请求中对正在操作的应用列表的引用。

类型：string

示例：28ukf

请求示例

DELETE https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_lists/28ukf

响应示例

{
  "data": {
    "name": "twitter @ 262689209670784",
    "id": "28ukf",
    "created_at": "2017-08-17T17:07:42Z",
    "updated_at": "2017-09-12T22:20:33Z",
    "deleted": true,
    "apps": [
      {
        "app_store_identifier": "com.twitter.android",
        "os_type": "Android"
      }
    ]
  },
  "request": {
    "params": {
      "app_list_id": "28ukf",
      "account_id": "18ce54d4x5t"
    }
  }
}