メディアライブラリ

GET accounts/:account_id/media_library¶

現在のアカウントに関連付けられている一部またはすべてのメディアライブラリオブジェクトの詳細を取得します。

リソースURL¶

https://ads-api.twitter.com/10/accounts/:account_id/media_library

パラメーター¶

リクエストの例¶

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/media_library?count=1

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "count": 1
    }
  },
  "data": [
    {
      "tweeted": true,
      "name": null,
      "file_name": "coffee https://t.co/4tcPU9XUon",
      "media_url": "https://pbs.twimg.com/media/DJvnJf_UEAAXnzC.jpg",
      "media_category": "TWEET_IMAGE",
      "media_key": "3_908573900237180928",
      "created_at": "2017-09-15T06:11:12Z",
      "media_status": "TRANSCODE_COMPLETED",
      "media_type": "IMAGE",
      "updated_at": "2017-11-16T06:00:01Z",
      "deleted": false
    }
  ],
  "next_cursor": "c-1"
}

GET accounts/:account_id/media_library/:media_key¶

現在のアカウントに関連付けられている特定のメディアライブラリオブジェクトを取得します。

リソースURL¶

https://ads-api.twitter.com/10/accounts/:account_id/media_library/:media_key

パラメーター¶

リクエストの例¶

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/media_library/13_909110614026444802

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "media_key": "13_909110614026444802"
    }
  },
  "data": {
    "tweeted": true,
    "duration": 39973,
    "name": null,
    "file_name": "buildings https://t.co/xFdzrHM5QG",
    "description": null,
    "media_url": "https://video.twimg.com/amplify_video/909110614026444802/vid/1280x720/mfahmfkKVjjk1nGm.mp4",
    "media_category": "AMPLIFY_VIDEO",
    "poster_media_url": "https://pbs.twimg.com/amplify_video_thumb/909110614026444802/img/QZUNoaiCia0UFNrw.jpg",
    "poster_media_key": "3_909110614026444802",
    "media_key": "13_909110614026444802",
    "created_at": "2017-09-16T17:43:55Z",
    "media_status": "TRANSCODE_COMPLETED",
    "title": "buildings",
    "media_type": "VIDEO",
    "aspect_ratio": "16:9",
    "updated_at": "2017-09-27T13:04:00Z",
    "deleted": false
  }
}

POST accounts/:account_id/media_library¶

メディアオブジェクトを現在のアカウントに関連付けます。その他の詳細については、「メディアライブラリガイド」を参照してください。

注: 動画をAMPLIFY_VIDEOメディアカテゴリーでメディアライブラリに追加すると、PREROLL account_mediaアセットとして自動的に利用可能になります。

リソースURL¶

https://ads-api.twitter.com/10/accounts/:account_id/media_library

パラメーター¶

リクエストの例¶

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/media_library?media_key=3_931236738554519552

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "media_key": "3_931236738554519552"
    }
  },
  "data": {
    "tweeted": false,
    "name": null,
    "file_name": null,
    "media_url": "https://pbs.twimg.com/media/DOxq4TtV4AAlvh_.jpg",
    "media_category": "TWEET_IMAGE",
    "media_key": "3_931236738554519552",
    "created_at": "2017-11-16T19:05:14Z",
    "media_status": "TRANSCODE_COMPLETED",
    "media_type": "IMAGE",
    "updated_at": "2017-11-16T19:05:23Z",
    "deleted": false
  }
}

PUT accounts/:account_id/media_library/:media_key¶

現在のアカウントに属する、指定したメディアライブラリオブジェクトを更新します。

リソースURL¶

https://ads-api.twitter.com/10/accounts/:account_id/media_library/:media_key

パラメーター¶

リクエストの例¶

PUT https://ads-api.twitter.com/10/accounts/18ce54d4x5t/media_library/16_844800354743074820?title=cat GIF&description=in space

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "media_key": "16_844800354743074820",
      "title": "cat GIF",
      "description": "in space"
    }
  },
  "data": {
    "tweeted": true,
    "duration": null,
    "name": null,
    "file_name": null,
    "description": "in space",
    "media_url": "https://video.twimg.com/tweet_video/C7lVclqVwAQqTCZ.mp4",
    "media_category": "TWEET_GIF",
    "poster_media_url": "https://pbs.twimg.com/tweet_video_thumb/C7lVclqVwAQqTCZ.jpg",
    "poster_media_key": "3_844800354743074820",
    "media_key": "16_844800354743074820",
    "created_at": "2017-10-20T09:51:54Z",
    "media_status": "TRANSCODE_COMPLETED",
    "title": "cat GIF",
    "media_type": "GIF",
    "aspect_ratio": "125:79",
    "updated_at": "2017-10-23T06:37:56Z",
    "deleted": false
  }
}

DELETE accounts/:account_id/media_library/:media_key¶

現在のアカウントに属する、指定したメディアライブラリオブジェクトを削除します。

リソースURL¶

https://ads-api.twitter.com/10/accounts/:account_id/media_library/:media_key

パラメーター¶

リクエストの例¶

DELETE https://ads-api.twitter.com/10/accounts/18ce54d4x5t/media_library/7_860318603387600896

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "media_key": "7_860318603387600896"
    }
  },
  "data": {
    "tweeted": true,
    "duration": 14330,
    "name": "mountains-on-ads.twitter.com",
    "file_name": "mountains.mp4",
    "description": "",
    "media_url": "https://video.twimg.com/ext_tw_video/860318603387600896/pu/vid/1280x720/xI3DbvWKxdvICsFW.mp4",
    "media_category": "TWEET_VIDEO",
    "poster_media_url": "https://pbs.twimg.com/media/C_B3bTRVYAAFBFt.jpg",
    "poster_media_key": "3_860318839740915712",
    "media_key": "7_860318603387600896",
    "created_at": "2017-05-05T02:21:53Z",
    "media_status": "TRANSCODE_COMPLETED",
    "title": "uploaded on ads.twitter.com",
    "media_type": "VIDEO",
    "aspect_ratio": "16:9",
    "updated_at": "2017-05-05T02:26:58Z",
    "deleted": true
  }
}