教程
推广其他用户的推文
简介
要求
步骤
1.列出可推广用户
调用 GET accounts/:account_id/promotable_users 端点将返回其推文可由广告账号进行推广的一系列用户。可推广用户类型可以为 FULL 或 RETWEETS_ONLY。FULL 可推广用户是广告账号的所有者。(一个广告账号只能由一名用户所有。) 如果广告账号已被授权为其他用户推广推文,则可推广用户类型将为 RETWEETS_ONLY。
twurl -H ads-api.twitter.com "/5/accounts/abc123/promotable_users"
{
"request": {
"params": {
"account_id": "abc123"
}
},
"next_cursor": null,
"data": [
{
"user_id": "12345",
"id": "l310s",
"created_at": "2016-07-21T22:42:09Z",
"updated_at": "2016-07-21T22:42:09Z",
"deleted": false,
"promotable_user_type": "FULL"
},
{
"user_id": "56789",
"id": "ozor5",
"created_at": "2017-03-10T17:51:24Z",
"updated_at": "2019-07-02T08:06:44Z",
"deleted": false,
"promotable_user_type": "RETWEETS_ONLY"
}
]
}
2.验证凭据是否能够创建推广推文(可选)
若要代表其他用户创建推文,经过验证的用户必须具有 TWEET_COMPOSER 权限。这将仅允许他们创建无传播的(或“仅推广”)推文。使用 GET accounts/:account_id/authenticated_user_access 端点以确认经过验证的用户是否具有此权限。
选项 A:推广现有推文
3.获取用户的公开推文
使用 GET statuses/user_timeline 查找你可以推广的用户的推文。
$ twurl -H api.twitter.com "/1.1/statuses/user_timeline.json?user_id=2417045708"
[
{
"created_at": "Sat Jul 27 18:20:40 +0000 2019",
"id": 1143347463765426177,
"id_str": "1143347463765426177",
"text": "One year ago",
...
}
]
4.创建推广推文
调用推广推文端点,并包括可推广用户账号中已发布推文的推文 ID 以及要与推文关联的行项目 ID。
$ twurl -X POST -H ads-api.twitter.com "/5/accounts/18ce54d4x5t/promoted_tweets?line_item_id=6c62d&tweet_ids=1143347463765426177"
{
"request": {
"params": {
"tweet_ids": [
1143347463765426177
],
"line_item_id": "6c62d",
"account_id": "18ce54d4x5t"
}
},
"data": [
{
"line_item_id": "6c62d",
"id": "3jzjq6",
"entity_status": "ACTIVE",
"created_at": "2019-07-11T21:29:48Z",
"updated_at": "2019-07-11T21:29:48Z",
"approval_status": "ACCEPTED",
"tweet_id": "1149430614224855040",
"deleted": false
}
],
"total_count": 1
}
现在,在启动广告活动时,将推广此推文。
选项 B:为未来某个时候安排推广推文
3.获取预排期推文(未发布的推文)
你将需要 RETWEET_ONLY 用户的广告账号的预排期推文。以下请求演示了如何访问 18ce54aymz3 的预排期推文。
twurl -H ads-api.twitter.com "/5/accounts/18ce54aymz3/scheduled_tweets/1149433959404539904"
{
"request": {
"params": {
"scheduled_tweet_id": 1149433959404539904
}
},
"data": {
"completed_at": null,
"id_str": "1149433959404539904",
"text": "18ce54d4x5t will promote this in the future",
"user_id": "2417045708",
"scheduled_status": "SCHEDULED",
"id": 1149433959404539904,
"media_ids": [],
"nullcast": true,
"created_at": "2019-07-11T21:43:06Z",
"scheduled_at": "2019-11-01T00:00:00Z",
"card_uri": null,
"updated_at": "2019-07-11T21:43:05Z",
"tweet_id": null,
"media_keys": []
}
}
4.创建预排期推广推文
我们使用 RETWEET_ONLY 广告账号的预排期推文 id_str 在我们的广告账号 18ce54d4x5t 上创建一篇预排期推广推文。
twurl -X POST -H ads-api.twitter.com "/5/accounts/18ce54d4x5t/scheduled_promoted_tweets?line_item_id=6c62d&scheduled_tweet_id=1149433959404539904"
{
"data": { "line_item_id": "6c62d",
"id": "300dd",
"created_at": "2019-07-11T21:43:51Z",
"updated_at": "2019-07-11T21:43:51Z",
"scheduled_tweet_id": "1149433959404539904",
"tweet_id": null,
"deleted": false
},
"request": {
"params": {
"line_item_id": "6c62d",
"scheduled_tweet_id": 1149433959404539904,
"account_id": "18ce54d4x5t"
}
}
}
此预排期推广推文将于预排期推文的 scheduled_at 日期提供。
准备好构建你的解决方案了吗?