如果权限设置正确，你可以向推广产品端点发出请求，直接引用你要推广的推文的推文 ID。你可以使用 POST accounts/:account_id/promoted-tweets 端点来对已发布推文进行推广，还可使用 POST accounts/:account_id/scheduled-promoted-tweets 端点对其他 Twitter 广告账号的预排期推文进行推广。

你不必转推定位推文。使用此方法推广推文时，返回的 tweet_id 将与提供的推文 ID 不同。在后台，该推文作为 cast 为空的推文被转推，然后进行推广。返回的 tweet_id 对应此新推文。

资源 URL¶

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

参数¶

名称	说明
account_id 必需	所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。类型：string 示例：`18ce54d4x5t`
count 可选	指定每个不同请求尝试检索的记录数量。类型：int 默认值：`200` 最小值、最大值：`1`、`1000`
cursor 可选	指定光标以获取下一页结果。参阅分页了解更多信息。类型：string 示例：`8x7v00oow`
promotable_user_ids 可选	通过指定以逗号分隔的标识符列表，将响应范围限定为所需的可推广用户。最多可提供 200 个 ID。类型：string 示例：`l310s`
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/promotable_users?promotable_user_ids=l310s

响应示例¶

{
  "request": {
    "params": {
      "promotable_user_ids": [
        "l310s"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "user_id": "756201191646691328",
      "id": "l310s",
      "created_at": "2016-07-21T22:42:09Z",
      "updated_at": "2016-07-21T22:42:09Z",
      "deleted": false,
      "promotable_user_type": "FULL"
    }
  ]
}

GET accounts/:account_id/promotable_users/:promotable_user_id¶

检索与当前账号关联的特定可推广用户的详细信息。

可推广用户类型为 FULL 或 RETWEETS_ONLY。这可以控制允许该账号推广的内容类型。

广告商必须获得许可才能推广其他用户的内容。如果权限设置正确，你可以向推广产品端点发出请求，直接引用你要推广的推文的推文 ID。

资源 URL¶

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

参数¶

名称说明

account_id
必需

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

类型：string

示例：18ce54d4x5t

promotable_user_id
可选

请求中对正在操作的可推广用户的引用

类型：string

示例：l310s

with_deleted
可选

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

类型：boolean

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

请求示例¶

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/promotable_users/l310s

响应示例¶

{
  "request": {
    "params": {
      "promotable_user_id": "l310s",
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "user_id": "2417045708",
    "id": "l310s",
    "created_at": "2017-03-10T17:51:24Z",
    "updated_at": "2017-03-10T17:51:24Z",
    "deleted": false,
    "promotable_user_type": "RETWEETS_ONLY"
  }
}