ツイート

GET accounts/:account_id/tweets

アカウントの完全にプロモーション可能なユーザー(デフォルト)またはuser_idパラメーターで指定されたユーザーのツイート詳細を取得します。これはアカウント下のプロモーション可能なユーザーのいずれかになります。

リソースURL

https://ads-api.x.com/10/accounts/:account_id/tweets

パラメーター

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

tweet_type
必須

指定されたtweet_idsのツイートのタイプ。

タイプ: 列挙

使用可能な値: DRAFTPUBLISHEDSCHEDULED

count
任意

個別のリクエストごとに試行および取得するレコード数を指定します。

タイプ: 整数

デフォルト: 200
最小、最大: 11000
cursor
任意

結果の次のページを取得するためのカーソルを指定します。詳細については、「ページネーション」を参照してください。

タイプ: 文字列

例: AAAAAFhLRpQLNF-sGBSgAA

include_mentions_and_replies
任意

フィルターを使って利用可能なツイートのリストからメンションとリプライを除外するかどうか。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse
timeline_type
任意

ヌルキャストツイート(すなわち「プロモーション専用」)とオーガニックツイートのいずれか、またはその両方を返すかどうか。

タイプ: 列挙

デフォルト: NULLCAST
使用可能な値: ALLNULLCASTORGANIC
trim_user
任意

ツイート応答でユーザーオブジェクトを除外するかどうか。有効にすると、返されるユーザーオブジェクトの一部のみがツイート作成者のユーザーIDになります。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse
tweet_ids
任意

カンマ区切りのIDリスト。最大200件のIDを指定できます。

: IDは指定されたtweet_typeと対応している必要があります。たとえば、予約投稿ツイートのIDが渡された場合、そのツイートが応答として返されるにはtweet_type SCHEDULEDである必要があります。

タイプ: 長整数型

例: 1122911801354510336,1102836745790316550

user_id
任意

ツイート範囲を設定するユーザーを指定します。設定しない場合は、アカウントのFULLプロモーション可能なユーザーがデフォルト値になります。

タイプ: 長整数型

例: 756201191646691328

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/tweets?tweet_ids=1166476031668015104&tweet_type=PUBLISHED&trim_user=true

応答の例

{
  "request": {
    "params": {
      "tweet_ids": [
        "1166476031668015104"
      ],
      "tweet_type": "PUBLISHED",
      "trim_user": true,
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "coordinates": null,
      "retweeted": false,
      "source": "<a href="https://ads-api.x.com" rel="nofollow">Ads API Internal Test App</a>",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "user_mentions": [],
        "urls": []
      },
      "display_text_range": [
        0,
        9
      ],
      "favorite_count": 0,
      "in_reply_to_status_id_str": null,
      "geo": null,
      "id_str": "1166476031668015104",
      "scopes": {
        "followers": false
      },
      "in_reply_to_user_id": null,
      "truncated": false,
      "retweet_count": 0,
      "id": 1166476031668015104,
      "in_reply_to_status_id": null,
      "conversation_settings": "EVERYONE",
      "nullcast": true,
      "created_at": "Tue Aug 27 22:22:12 +0000 2019",
      "place": null,
      "scheduled_at": null,
      "tweet_type": "PUBLISHED",
      "favorited": false,
      "full_text": "hello, v6",
      "lang": "es",
      "contributors": [
        2417045708
      ],
      "in_reply_to_screen_name": null,
      "in_reply_to_user_id_str": null,
      "user": {
        "id": 756201191646691328,
        "id_str": "756201191646691328"
      },
      "tweet_id": "1166476031668015104"
    }
  ]
}

POST accounts/:account_id/tweet

アカウントの完全にプロモーション可能なユーザー(デフォルト)またはas_user_idパラメーターで指定されたユーザーのツイートを作成します。ヌルキャストツイート(デフォルト)とオーガニックツイートの作成がサポートされています。ヌルキャストツイートはパブリックタイムラインには表示されず、フォロワーに配信されません。どちらのタイプもキャンペーンで使うことができます。

認証済みユーザーがこのアカウントのFULLプロモーション可能なユーザーでない場合に、GET accounts/:account_id/authenticated_user_accessエンドポイントにリクエストを行ってこのユーザーの代わりにツイートする権限があるかどうかを判断します。TWEET_COMPOSERの権限は、そのユーザーがこのエンドポイントを使って、FULL プロモーション可能なユーザーの代わりにヌルキャストツイートを作成できることを示します。

メディアにupload.twitter.comエンドポイントを使う場合、このエンドポイントに渡すas_user_id値と同じuser_id値をadditional_ownersパラメーターに渡します。

リソースURL

https://ads-api.x.com/10/accounts/:account_id/tweet

パラメーター

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

as_user_id
必須

ツイートの投稿者を代表する広告主のユーザーID。広告主はads.twitter.comで広告アカウントへのアクセスをユーザー名に付与する必要があります。このアクセス許可により、広告主のユーザー名ではなく御社のユーザー名のOAuthトークンを使ってAPIを呼び出すことができます。

タイプ: 長整数型

例: 756201191646691328

text
必須の場合あり

ステータス更新のテキスト。media_keysが指定されていない場合は必須です。

タイプ: 文字列

例: hello, world

card_uri
任意

可能であれば、カード応答からのcard_uri値を使って、カードをツイートに関連付けます。

タイプ: 文字列

例: card://853503245793641682

conversation_settings
任意

このツイートに返信できるユーザーを選択します。@ツイートされたユーザーなら誰でも常に返信できます。

: このフィールドはPOSTリクエストの応答では返されませんが、GETリクエストを行う際に返されます。

: このパラメーターは広告API v8以降でしか機能しません。

タイプ: 列挙

デフォルト: EVERYONE
使用可能な値: EVERYONEFOLLOWINGMENTIONED_USERS
media_keys
任意

IDのカンマ区切りリストを指定して、メディアをツイートに関連付けます。最大で4つの画像、1つのアニメーションGIF、または1つの動画を含めることができます。

タイプ: 文字列

例: 13_1153584529292270722

nullcast
任意

ヌルキャスト(または「プロモーション専用」)ツイートを作成するかどうか。

: プロモーションされていないオーガニックツイート(nullcast=false)は認証済みユーザーに対してのみ作成できます。

タイプ: ブール値

デフォルト: true
使用可能な値: truefalse
trim_user
任意

ツイート応答でユーザーオブジェクトを除外するかどうか。有効にすると、返されるユーザーオブジェクトの一部のみがツイート作成者のユーザーIDになります。

タイプ: ブール値

デフォルト: false
使用可能な値: truefalse
tweet_mode
任意

応答を互換モードにするか、拡張モードにするか。その他の情報については、こちらを参照してください。

タイプ: 文字列

使用可能な値: compatextended

video_cta
任意

動画のCTA。

タイプ: 列挙

使用可能な値: VISIT_SITEWATCH_NOW

video_cta_value
任意

動画の対応するCTAの値。

タイプ: 文字列

例: https://dev.twitter.com

video_description
任意

動画の下に表示される説明。最大長: 200文字。

タイプ: 文字列

例: Integrate with the Twitter advertising platform

video_title
任意

動画の下に表示されるタイトル(見出し)。最大長: 70文字。

タイプ: 文字列

例: Twitter Ads API

リクエストの例

POST https://ads-api.x.com/10/accounts/18ce54d4x5t/tweet?text=hello, world&as_user_id=756201191646691328&trim_user=true

応答の例

{
  "data": {
    "created_at": "Sat Jun 24 05:08:30 +0000 2017",
    "id": 878479925472251906,
    "id_str": "878479925472251906",
    "text": "hello, world",
    "truncated": false,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "user_mentions": [],
      "urls": []
    },
    "source": "<a href='"https://ads-api.x.com"' rel='"nofollow"'>Ads API Internal Test App</a>",
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 756201191646691328,
      "id_str": "756201191646691328"
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "retweet_count": 0,
    "favorite_count": 0,
    "favorited": false,
    "retweeted": false,
    "scopes": {
      "followers": false
    },
    "lang": "en"
  },
  "request": {
    "params": {
      "text": "hello, world",
      "trim_user": true,
      "as_user_id": 756201191646691328,
      "account_id": "18ce54d4x5t"
    }
  }
}