クリエイティブ
予約投稿ツイート
GET accounts/:account_id/scheduled_tweets¶
現在のアカウントに関連付けられている一部またはすべての予約投稿ツイートの詳細を取得します。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
count 任意 |
個別のリクエストごとに試行および取得するレコード数を指定します。 タイプ: 整数 デフォルト: 100最小、最大: 1、200 |
cursor 任意 |
結果の次のページを取得するためのカーソルを指定します。詳細については、「ページネーション」を参照してください。 タイプ: 文字列 例: |
user_id 任意 |
予約投稿ツイートを取得するユーザーを指定します。設定しない場合は、アカウントの タイプ: 長整数型 例: |
リクエストの例¶
GET https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets?count=1
応答の例¶
{
"request": {
"params": {
"count": 1
}
},
"data": [
{
"completed_at": "2017-06-18T22:00:05Z",
"id_str": "875828692081037312",
"text": "where you want to be",
"user_id": "756201191646691328",
"scheduled_status": "SUCCESS",
"id": 875828692081037312,
"media_ids": [
"875828691770548224"
],
"nullcast": true,
"created_at": "2017-06-16T21:33:27Z",
"scheduled_at": "2017-06-18T22:00:00Z",
"card_uri": null,
"updated_at": "2017-06-19T18:02:20Z",
"tweet_id": "876560168963645440",
"media_keys": []
}
],
"next_cursor": "c-j41uw400"
}
GET accounts/:account_id/scheduled_tweets/:scheduled_tweet_id¶
現在のアカウントに関連付けられている特定の予約投稿ツイートを取得します。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets/:scheduled_tweet_id
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
scheduled_tweet_id 必須 |
リクエスト内で操作する予約投稿ツイートへの参照。 タイプ: 長整数型 例: |
リクエストの例¶
GET https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets/917438609065623552
応答の例¶
{
"request": {
"params": {
"scheduled_tweet_id": 917438609065623552
}
},
"data": {
"completed_at": null,
"id_str": "917438609065623552",
"text": "",
"user_id": "756201191646691328",
"scheduled_status": "SCHEDULED",
"id": 917438609065623552,
"media_ids": [
"917438348871983104"
],
"nullcast": true,
"created_at": "2017-10-09T17:16:24Z",
"scheduled_at": "2018-01-01T00:00:00Z",
"card_uri": null,
"updated_at": "2017-10-09T17:16:24Z",
"tweet_id": null,
"media_keys": [
"3_917438348871983104"
]
}
}
POST accounts/:account_id/scheduled_tweets¶
アカウントの完全にプロモーション可能なユーザー（デフォルト）またはas_user_idパラメータで指定されたユーザーの予約投稿ツイートを作成します。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
scheduled_at 必須 |
ツイートの投稿（ライブ放送）時間。ISO 8601で表します。 注: ツイートを予約投稿できるのは1年先までです。 注: また、予約投稿は分単位でのみ設定できます。秒は無視されます。 タイプ: 文字列 例: |
text 必須の場合あり |
ステータス更新のテキスト。 タイプ: 文字列 例: |
as_user_id 任意 |
ツイートの投稿者を代表する広告主のユーザーID。広告主はads.twitter.comで広告アカウントへのアクセスをユーザー名に付与する必要があります。このアクセス許可により、広告主のユーザー名ではなく御社のユーザー名のOAuthトークンを使ってAPIを呼び出すことができます。 タイプ: 長整数型 例: |
card_uri 任意 |
可能であれば、カード応答からの タイプ: 文字列 例: |
media_ids 任意 |
IDのカンマ区切りリストを指定して、メディアをツイートに関連付けます。最大で4つの画像、1つのアニメーションGIF、または1つの動画を含めることができます。メディアのアップロードに関するその他の詳細については、「メディアのアップロード」を参照してください。 タイプ: 長整数型 例: |
nullcast 任意 |
ヌルキャスト（または「プロモーション専用」）ツイートを作成するかどうか。 タイプ: ブール値 デフォルト: true使用可能な値: true、false |
リクエストの例¶
POST https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets?as_user_id=756201191646691328&media_ids=917438348871983104&scheduled_at=2018-01-01
応答の例¶
{
"request": {
"params": {
"media_ids": [
917438348871983104
],
"scheduled_at": "2018-01-01T00:00:00Z",
"as_user_id": 756201191646691328
}
},
"data": {
"completed_at": null,
"id_str": "917438609065623552",
"text": "",
"user_id": "756201191646691328",
"scheduled_status": "SCHEDULED",
"id": 917438609065623552,
"media_ids": [
"917438348871983104"
],
"nullcast": true,
"created_at": "2017-10-09T17:16:24Z",
"scheduled_at": "2018-01-01T00:00:00Z",
"card_uri": null,
"updated_at": "2017-10-09T17:16:24Z",
"tweet_id": null,
"media_keys": [
"3_917438348871983104"
]
}
}
PUT accounts/:account_id/scheduled_tweets/:scheduled_tweet_id¶
現在のアカウントに属する、指定した予約投稿ツイートを更新します。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets/:scheduled_tweet_id
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
scheduled_tweet_id 必須 |
リクエスト内で操作する予約投稿ツイートへの参照。 タイプ: 長整数型 例: |
card_uri 任意 |
可能であれば、カード応答からの 注: 値を含めずにパラメータを指定すると設定が解除（削除）されます。 タイプ: 文字列 例: |
media_ids 任意 |
IDのカンマ区切りリストを指定して、メディアをツイートに関連付けます。最大で4つの画像、1つのアニメーションGIF、または1つの動画を含めることができます。メディアのアップロードに関するその他の詳細については、「メディアのアップロード」を参照してください。 注: 値を含めずにパラメータを指定すると設定が解除（削除）されます。 タイプ: 長整数型 例: |
nullcast 任意 |
ヌルキャスト（または「プロモーション専用」）ツイートを作成するかどうか。 タイプ: ブール値 使用可能な値: |
scheduled_at 任意 |
ツイートの投稿（ライブ放送）時間。ISO 8601で表します。 タイプ: 文字列 例: |
text 任意 |
ステータス更新のテキスト。 タイプ: 文字列 例: |
リクエストの例¶
PUT https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets/875057751231037440?text=winter solstice
応答の例¶
{
"request": {
"params": {
"scheduled_tweet_id": 875057751231037440,
"text": "winter solstice"
}
},
"data": {
"completed_at": null,
"id_str": "875057751231037440",
"scheduled_status": "SCHEDULED",
"text": "winter solstice",
"user_id": "756201191646691328",
"id": 875057751231037440,
"media_ids": null,
"nullcast": true,
"created_at": "2017-06-14T18:30:00Z",
"scheduled_at": "2017-12-21T00:00:00Z",
"card_uri": null,
"updated_at": "2017-06-14T18:30:00Z",
"tweet_id": null,
"media_keys": []
}
}
DELETE accounts/:account_id/scheduled_tweets/:scheduled_tweet_id¶
現在のアカウントに属する、指定した予約投稿ツイートを完全に削除します。
注: これは物理的な削除です。このため、削除した予約投稿ツイートを取得することはできません。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets/:scheduled_tweet_id
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
scheduled_tweet_id 必須 |
リクエスト内で操作する予約投稿ツイートへの参照。 タイプ: 長整数型 例: |
リクエストの例¶
DELETE https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets/875064008595787776
応答の例¶
{
"request": {
"params": {
"scheduled_tweet_id": 875064008595787776
}
},
"data": {
"completed_at": null,
"id_str": "875064008595787776",
"scheduled_status": "DELETED",
"text": "hello, world",
"user_id": "756201191646691328",
"id": 875064008595787776,
"media_ids": null,
"nullcast": true,
"created_at": "2017-06-14T18:54:52Z",
"scheduled_at": "2017-06-15T00:00:00Z",
"card_uri": null,
"updated_at": "2017-06-14T19:01:16Z",
"tweet_id": null,
"media_keys": []
}
}
GET accounts/:account_id/scheduled_tweets/preview/:scheduled_tweet_id¶
予約投稿ツイートは、さまざまなプラットフォーム（Android、iPhone、ウェブ）で表示されるため、プレビューします。
JSON応答にはプレビューHTMLが含まれています。これは、ブラウザーでのプレビューの表示に使用できる、完全に機能するHTMLドキュメントです。関連するCSSと画像はTwitterを経由して直接配信されます。
注: プレビューはおおよそのものです。
リソースURL¶
https://ads-api.twitter.com/5/accounts/:account_id/scheduled_tweets/preview/:scheduled_tweet_id
パラメータ¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
scheduled_tweet_id 必須 |
リクエスト内で操作する予約投稿ツイートへの参照。 タイプ: 長整数型 例: |
リクエストの例¶
GET https://ads-api.twitter.com/5/accounts/18ce54d4x5t/scheduled_tweets/preview/919331596020285440
応答の例¶
{
"request": {
"params": {
"scheduled_tweet_id": 919331596020285440
}
},
"data": [
{
"platform": "web",
"preview": "<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <link href="https://ton.twimg.com/macaw-campaigns/css/tweet_preview.bundle.cb572b35a753a67c4416.css" rel="stylesheet" /> </head> <body> <div class="Tweet--timeline Tweet Tweet--web " data-tweet-id="919331596020285440"> <img class="Tweet-avatar" src="https://pbs.twimg.com/profile_images/756348317458509825/DTKcRCpS_normal.jpg" width="48" height="48" alt=""/> <div class="Tweet-body"> <div class="Tweet-header"> <div class="Tweet-userData"> <a href="https://twitter.com/apimctestface" target="_blank" class="Tweet-userLink"> <span class="Tweet-name">API McTestface</span> <span class="Tweet-screenName">@apimctestface</span> </a> </div> <span class="Tweet-timeLabel"> <span class="Tweet-timestamp"> <span class="Icon Icon--clock"></span> Oct 31 </span> </span> </div> <div class="Tweet-text " dir="">video w/o</div> <div class="CardContainer CardContainer--timeline CardContainer--web " > <div class="VideoCard"> <div class="Card-video"> <iframe class="Card-videoIframe" src="https://twitter.com/i/videos/static?json_rpc=1&square_corners=1&image_src=https%3A%2F%2Fpbs%2Etwimg%2Ecom%2Famplify_video_thumb%2F887777498917777408%2Fimg%2FcwavyNV2brPoEOlK%2Ejpg&video_url=https%3A%2F%2Fvideo%2Etwimg%2Ecom%2Famplify_video%2F887777498917777408%2Fvid%2F1280x720%2F35qJ3AUkmYIWfLGT%2Emp4"></iframe> <button class="Card-videoPosterImageContainer"> <img alt="" class="Card-videoPosterImage" src="https://pbs.twimg.com/amplify_video_thumb/887777498917777408/img/cwavyNV2brPoEOlK.jpg" /> <span class="Card-videoPosterImagePlayButton Icon Icon--playButton"></span> </button> </div> </div> </div> </div> <div class="Tweet-footer"> <div class="Tweet-actions "> <button class="Tweet-action Tweet-action--reply" type="button"> <span class="Icon Icon--reply"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--retweet" type="button"> <span class="Icon Icon--retweet"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--favorite Tweet-action--like" type="button"> <span class="Icon Icon--heart"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--dm" type="button"> <span class="Icon Icon--dm"></span> </button> </div> <div class="Tweet-context Tweet-context--promotion"> <div class="Tweet-badge Tweet-badge--promotedBy"> <span class="Icon Icon--promoted"></span> <span class="Tweet-badgeText">Promoted</span> </div> </div> </div> </div> </body> </html> "
},
{
"platform": "android",
"preview": "<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <link href="https://ton.twimg.com/macaw-campaigns/css/tweet_preview.bundle.cb572b35a753a67c4416.css" rel="stylesheet" /> </head> <body> <div class="Tweet--timeline Tweet Tweet--android " data-tweet-id="919331596020285440"> <img class="Tweet-avatar" src="https://pbs.twimg.com/profile_images/756348317458509825/DTKcRCpS_normal.jpg" width="48" height="48" alt=""/> <div class="Tweet-body"> <div class="Tweet-header"> <div class="Tweet-userData"> <a href="https://twitter.com/apimctestface" target="_blank" class="Tweet-userLink"> <span class="Tweet-name">API McTestface</span> <span class="Tweet-screenName">@apimctestface</span> </a> </div> <span class="Tweet-timeLabel"> <span class="Tweet-timestamp"> <span class="Icon Icon--clock"></span> Oct 31 </span> </span> </div> <div class="Tweet-text " dir="">video w/o</div> <div class="CardContainer CardContainer--timeline CardContainer--android " > <div class="VideoCard"> <div class="Card-video"> <iframe class="Card-videoIframe" src="https://twitter.com/i/videos/static?json_rpc=1&square_corners=1&image_src=https%3A%2F%2Fpbs%2Etwimg%2Ecom%2Famplify_video_thumb%2F887777498917777408%2Fimg%2FcwavyNV2brPoEOlK%2Ejpg&video_url=https%3A%2F%2Fvideo%2Etwimg%2Ecom%2Famplify_video%2F887777498917777408%2Fvid%2F1280x720%2F35qJ3AUkmYIWfLGT%2Emp4"></iframe> <button class="Card-videoPosterImageContainer"> <img alt="" class="Card-videoPosterImage" src="https://pbs.twimg.com/amplify_video_thumb/887777498917777408/img/cwavyNV2brPoEOlK.jpg" /> <span class="Card-videoPosterImagePlayButton Icon Icon--playButton"></span> </button> </div> </div> </div> </div> <div class="Tweet-footer"> <div class="Tweet-actions "> <button class="Tweet-action Tweet-action--reply" type="button"> <span class="Icon Icon--reply"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--retweet" type="button"> <span class="Icon Icon--retweet"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--favorite Tweet-action--like" type="button"> <span class="Icon Icon--heart"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--dm" type="button"> <span class="Icon Icon--dm"></span> </button> </div> <div class="Tweet-context Tweet-context--promotion"> <div class="Tweet-badge Tweet-badge--promotedBy"> <span class="Icon Icon--promoted"></span> <span class="Tweet-badgeText">Promoted</span> </div> </div> </div> </div> </body> </html> "
},
{
"platform": "iphone",
"preview": "<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <link href="https://ton.twimg.com/macaw-campaigns/css/tweet_preview.bundle.cb572b35a753a67c4416.css" rel="stylesheet" /> </head> <body> <div class="Tweet--timeline Tweet Tweet--iphone " data-tweet-id="919331596020285440"> <img class="Tweet-avatar" src="https://pbs.twimg.com/profile_images/756348317458509825/DTKcRCpS_normal.jpg" width="48" height="48" alt=""/> <div class="Tweet-body"> <div class="Tweet-header"> <div class="Tweet-userData"> <a href="https://twitter.com/apimctestface" target="_blank" class="Tweet-userLink"> <span class="Tweet-name">API McTestface</span> <span class="Tweet-screenName">@apimctestface</span> </a> </div> <span class="Tweet-timeLabel"> <span class="Tweet-timestamp"> <span class="Icon Icon--clock"></span> Oct 31 </span> </span> </div> <div class="Tweet-text " dir="">video w/o</div> <div class="CardContainer CardContainer--timeline CardContainer--iphone " > <div class="VideoCard"> <div class="Card-video"> <iframe class="Card-videoIframe" src="https://twitter.com/i/videos/static?json_rpc=1&square_corners=1&image_src=https%3A%2F%2Fpbs%2Etwimg%2Ecom%2Famplify_video_thumb%2F887777498917777408%2Fimg%2FcwavyNV2brPoEOlK%2Ejpg&video_url=https%3A%2F%2Fvideo%2Etwimg%2Ecom%2Famplify_video%2F887777498917777408%2Fvid%2F1280x720%2F35qJ3AUkmYIWfLGT%2Emp4"></iframe> <button class="Card-videoPosterImageContainer"> <img alt="" class="Card-videoPosterImage" src="https://pbs.twimg.com/amplify_video_thumb/887777498917777408/img/cwavyNV2brPoEOlK.jpg" /> <span class="Card-videoPosterImagePlayButton Icon Icon--playButton"></span> </button> </div> </div> </div> </div> <div class="Tweet-footer"> <div class="Tweet-actions "> <button class="Tweet-action Tweet-action--reply" type="button"> <span class="Icon Icon--reply"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--retweet" type="button"> <span class="Icon Icon--retweet"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--favorite Tweet-action--like" type="button"> <span class="Icon Icon--heart"></span> <span class="Tweet-actionCount">##</span> </button> <button class="Tweet-action Tweet-action--dm" type="button"> <span class="Icon Icon--dm"></span> </button> </div> <div class="Tweet-context Tweet-context--promotion"> <div class="Tweet-badge Tweet-badge--promotedBy"> <span class="Icon Icon--promoted"></span> <span class="Tweet-badgeText">Promoted</span> </div> </div> </div> </div> </body> </html> "
}
]
}
