ツイート

GET accounts/:account_id/tweets¶

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

リソースURL¶

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

パラメーター¶

リクエストの例¶

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

パラメーター¶

リクエストの例¶

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"
    }
  }
}