素材

草稿推文

在 Postman 中运行 ❯

GET accounts/:account_id/draft_tweets

检索与当前账号关联的部分或所有草稿推文的详细信息。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
count
可选

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

类型：int

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

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

类型：string

示例：c-jh1g0ryb
user_id
可选

指定检索其草稿推文的用户。未设置时，默认为账号的 FULL 可推广用户。

类型：long

示例：756201191646691328

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets?count=1

响应示例

{
  "request": {
    "params": {
      "count": 1
    }
  },
  "data": [
    {
      "id_str": "994791681219231744",
      "text": "hello, world",
      "user_id": "756201191646691328",
      "id": 994791681219231744,
      "nullcast": true,
      "created_at": "2018-05-11T04:09:53Z",
      "card_uri": null,
      "updated_at": "2018-05-11T04:09:53Z",
      "media_keys": []
    }
  ],
  "next_cursor": "c-jh1g0ryb"
}

GET accounts/:account_id/draft_tweets/:draft_tweet_id

检索与当前账号关联的特定草稿推文。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
draft_tweet_id
必需

请求中对正在操作的草稿推文的引用。

类型：long

示例：994788364334325760

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets/994788364334325760

响应示例

{
  "request": {
    "params": {
      "draft_tweet_id": 994788364334325760
    }
  },
  "data": {
    "id_str": "994788364334325760",
    "text": "#TwitterDev",
    "user_id": "756201191646691328",
    "id": 994788364334325760,
    "nullcast": true,
    "created_at": "2018-05-11T03:56:42Z",
    "card_uri": "card://958225772740714496",
    "updated_at": "2018-05-11T03:56:42Z",
    "media_keys": []
  }
}

POST accounts/:account_id/draft_tweets

为账号的可完全推广用户（默认）或 as_user_id 参数中指定的用户创建草稿推文。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
as_user_id
必需

要代表其发布推文的广告商用户 ID。广告商必须通过 ads.twitter.com，向你的用户名授予访问其广告账号的权限。此权限允许你使用自己用户名（而非广告商的用户名）的 OAuth 令牌调用该 API。

类型：long

示例：756201191646691328
text
有时为必需

状态更新文本。如未指定 media_keys 则为必需。

类型：string

示例：Just setting up my Twitter.
card_uri
可选

使用任何卡片响应中的 card_uri 值将卡片关联到推文（如可用）。

类型：string

示例：card://960880280705392541
media_keys
可选

通过指定以逗号分隔的标识符列表，将媒体关联到推文。最多可包含 4 个图像、1 个动画 GIF 或 1 个视频。

注意：媒体资源必须位于账号的媒体库中。

类型：string

示例：13_1153584529292270722
nullcast
可选

是否创建 cast 为空（或“仅推广”）的推文。

类型：boolean

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

请求示例

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets?as_user_id=756201191646691328&text=Just setting up my Twitter.

响应示例

{
  "request": {
    "params": {
      "text": "Just setting up my Twitter.",
      "as_user_id": 756201191646691328
    }
  },
  "data": {
    "id_str": "994747471329873920",
    "text": "Just setting up my Twitter.",
    "user_id": "756201191646691328",
    "id": 994747471329873920,
    "nullcast": true,
    "created_at": "2018-05-11T01:14:13Z",
    "card_uri": null,
    "updated_at": "2018-05-11T01:14:13Z",
    "media_keys": []
  }
}

PUT accounts/:account_id/draft_tweets/:draft_tweet_id

更新属于当前账号的指定草稿推文。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
draft_tweet_id
必需

请求中对正在操作的草稿推文的引用。

类型：long

示例：994747471329873920
card_uri
可选

使用任何卡片响应中的 card_uri 值将卡片关联到推文（如可用）。

注意：通过指定没有值的参数来取消设置（删除）。

类型：string

示例：card://970582057284129151
media_keys
可选

通过指定以逗号分隔的标识符列表，将媒体关联到推文。最多可包含 4 个图像、1 个动画 GIF 或 1 个视频。

注意：媒体资源必须位于账号的媒体库中。

注意：通过指定没有值的参数来取消设置（删除）。

类型：string

示例：13_1153584529292270722
nullcast
可选

是否创建 cast 为空（或“仅推广”）的推文。

类型：boolean

可能值：true、false
text
可选

状态更新文本。

类型：string

示例：just setting up my twttr

请求示例

PUT https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets/994747471329873920?text=just setting up my twttr

响应示例

{
  "request": {
    "params": {
      "draft_tweet_id": 994747471329873920,
      "text": "just setting up my twttr"
    }
  },
  "data": {
    "id_str": "994747471329873920",
    "text": "just setting up my twttr",
    "user_id": "756201191646691328",
    "id": 994747471329873920,
    "nullcast": true,
    "created_at": "2018-05-11T01:14:13Z",
    "card_uri": null,
    "updated_at": "2018-05-11T01:16:59Z",
    "media_keys": []
  }
}

DELETE accounts/:account_id/draft_tweets/:draft_tweet_id

永久删除属于当前账号的指定草稿推文。

注意：我们强烈建议使用其元数据创建推文或预排期推文后，立即删除草稿。

注意：此操作为硬删除。删除后，将无法恢复删除的草稿推文。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
draft_tweet_id
必需

请求中对正在操作的草稿推文的引用。

类型：long

示例：994787835663155200

请求示例

DELETE https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets/994787835663155200

响应示例

{
  "request": {
    "params": {
      "draft_tweet_id": 994787835663155200
    }
  },
  "data": {
    "id_str": "994787835663155200",
    "text": "hello, world",
    "user_id": "756201191646691328",
    "id": 994787835663155200,
    "nullcast": true,
    "status": "DELETED",
    "created_at": "2018-05-11T03:54:36Z",
    "card_uri": null,
    "updated_at": "2018-05-11T04:07:31Z",
    "media_keys": []
  }
}

POST accounts/:account_id/draft_tweets/preview/:draft_tweet_id

在移动设备上预览草稿推文。

请求成功时，将向已认证用户登录的每个设备发送通知。点击通知可打开时间线，用户可在其中查看草稿推文并与其交互，从而测试自动播放、音量、全屏、视频网站卡片对接和其他行为。

注意：设备上预览仅对收到通知的用户可见。

注意：通知仅发送至 Twitter 官方应用。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/draft_tweets/preview/:draft_tweet_id

参数

名称 说明
account_id
必需

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

类型：string

示例：18ce54d4x5t
draft_tweet_id
必需

请求中对正在操作的草稿推文的引用。

类型：long

示例：996132315829948416

请求示例

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/draft_tweets/preview/996132315829948416

响应示例

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "draft_tweet_id": "996132315829948416"
    }
  },
  "message": "See @apimctestface's notifications in the Twitter app to preview your Tweet."
}