Merge pull request #56 from twitterdev/image-upload

[minor] adding support for manual image media uploads, adding example

Author: brandonblack

examples/media_upload.py

@@ -0,0 +1,27 @@
+# Copyright (C) 2015 Twitter, Inc.
+
+from twitter_ads.client import Client
+from twitter_ads.http import Request
+
+CONSUMER_KEY = 'your consumer key'
+CONSUMER_SECRET = 'your consumer secret'
+ACCESS_TOKEN = 'user access token'
+ACCESS_TOKEN_SECRET = 'user access token secret'
+ADS_ACCOUNT = 'ads account id'
+
+# initialize the twitter ads api client
+client = Client(CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN, ACCESS_TOKEN_SECRET)
+
+# using the Request object you can manually call any twitter API resource including media uploads.
+
+# note: video uploads a bit more specialized and should be done using the
+# twitter_ads.http.MediaUpload class.
+
+# upload an image to POST media/upload
+resource = '/1.1/media/upload.json'
+domain = 'https://upload.twitter.com'
+files = {'media': (None, open('/path/to/file.jpg', 'rb'))}
+response = Request(client, 'post', resource, files=files, domain=domain).perform()
+
+# extract the media_id value from the response
+media_id = response.body['media_id']

twitter_ads/__init__.py

@@ -1,6 +1,6 @@
 # Copyright (C) 2015 Twitter, Inc.
 
-VERSION = (0, 2, 0)
+VERSION = (0, 2, 1)
 
 from twitter_ads.utils import get_version
 

twitter_ads/campaign.py

@@ -196,9 +196,16 @@ def preview(klass, account, **kwargs):
         """
         Returns an HTML preview of a tweet, either new or existing.
         """
-        resource = klass.TWEET_ID_PREVIEW if kwargs.get('id') else klass.TWEET_PREVIEW
-        resource = resource.format(account_id=account.id, id=kwargs.get('id'))
-        response = Request(account.client, 'get', resource, params=kwargs).perform()
+        params = {}
+        params.update(kwargs)
+
+        # handles array to string conversion for media IDs
+        if 'media_ids' in params and isinstance(params['media_ids'], list):
+            params['media_ids'] = ','.join(map(params['media_ids']))
+
+        resource = klass.TWEET_ID_PREVIEW if params.get('id') else klass.TWEET_PREVIEW
+        resource = resource.format(account_id=account.id, id=params.get('id'))
+        response = Request(account.client, 'get', resource, params=params).perform()
         return response.body['data']
 
     @classmethod
@@ -208,6 +215,11 @@ def create(klass, account, status, **kwargs):
         """
         params = {'status': status}
         params.update(kwargs)
+
+        # handles array to string conversion for media IDs
+        if 'media_ids' in params and isinstance(params['media_ids'], list):
+            params['media_ids'] = ','.join(map(params['media_ids']))
+
         resource = klass.TWEET_CREATE.format(account_id=account.id)
         response = Request(account.client, 'post', resource, params=params).perform()
         return response.body['data']

twitter_ads/error.py

@@ -95,10 +95,6 @@ def __init__(self, response, **kwargs):
         super(self, response, **kwargs)
         self._retry_after = response.headers.get('retry-after', None)
 
-    @property
-    def reset_at(self):
-        return self._reset_at
-
     @property
     def retry_after(self):
         return self._retry_after

twitter_ads/http.py

@@ -81,6 +81,7 @@ def __oauth_request(self):
 
         params = self.options.get('params', None)
         data = self.options.get('body', None)
+        files = self.options.get('files', None)
 
         consumer = OAuth1Session(
             self._client.consumer_key,
@@ -90,7 +91,7 @@ def __oauth_request(self):
 
         url = self.__domain() + self._resource
         method = getattr(consumer, self._method)
-        response = method(url, headers=headers, data=data, params=params)
+        response = method(url, headers=headers, data=data, params=params, files=files)
 
         return Response(response.status_code, response.headers,
                         body=response.raw, raw_body=response.text)