ツイート

GET accounts/:account_id/tweets

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

リソースURL

https://ads-api.twitter.com/8/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.twitter.com/8/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.twitter.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,
      "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.twitter.com/8/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

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.twitter.com/8/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.twitter.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"
    }
  }
}

Was this document helpful?

ありがとうございます

ご協力ありがとうございました。お役に立てて幸いです。

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.