Deprecation August, 2019 (#222)

* remvoe Audience Intelligence

* remove old preview endpoints

Author: smaeda-ks

examples/audience_intelligence.py

@@ -40,11 +40,6 @@
 print(draft_tweet.id_str)
 print(draft_tweet.text)
 
-# preview draft tweet of current instance (send notification)
-draft_tweet.preview()
-# or, specify any draft_tweet_id
-# draft_tweet.preview(draft_tweet_id='1142020720651673600')
-
 # create a nullcasted tweet using draft tweet metadata
 tweet = Tweet.create(account, text=draft_tweet.text)
 print(tweet)

examples/draft_tweet.py

@@ -22,9 +22,6 @@
 scheduled_tweet.scheduled_at = datetime.utcnow() + timedelta(days=2)
 scheduled_tweet.save()
 
-# preview
-scheduled_tweet.preview()
-
 # associate with a line item
 account.line_items().next().id
 scheduled_promoted_tweet = ScheduledPromotedTweet(account)

examples/scheduled_tweet.py

@@ -8,7 +8,6 @@
 from twitter_ads.error import BadRequest
 from twitter_ads.cursor import Cursor
 from twitter_ads import API_VERSION
-from twitter_ads.utils import Deprecated
 
 import json
 
@@ -150,71 +149,3 @@ def delete(self):
 resource_property(TailoredAudiencePermission, 'tailored_audience_id')
 resource_property(TailoredAudiencePermission, 'granted_account_id')
 resource_property(TailoredAudiencePermission, 'permission_level')
-
-
-class AudienceIntelligence(Resource):
-
-    PROPERTIES = {}
-
-    RESOURCE_BASE = '/' + API_VERSION + '/accounts/{account_id}/audience_intelligence/'
-    RESOURCE_CONVERSATIONS = RESOURCE_BASE + 'conversations'
-    RESOURCE_DEMOGRAPHICS = RESOURCE_BASE + 'demographics'
-    METHOD = 'post'
-    HEADERS = {'Content-Type': 'application/json'}
-
-    @classmethod
-    def __get(klass, account, client, params):
-        """
-        Helper function to get the conversation data
-        Returns a Cursor instance
-        """
-        resource = klass.RESOURCE_CONVERSATIONS.format(account_id=account.id)
-
-        request = Request(
-            account.client, klass.METHOD,
-            resource, headers=klass.HEADERS, body=params)
-        return Cursor(klass, request, init_with=[account])
-
-    @Deprecated('This endpoint has been deprecated and will no longer be available '
-                'as of 2019-08-28')
-    def conversations(self):
-        """
-        Get the conversation topics for an input targeting criteria
-        """
-        body = {
-            "conversation_type": self.conversation_type,
-            "audience_definition": self.audience_definition,
-            "targeting_inputs": self.targeting_inputs
-        }
-        return self.__get(account=self.account, client=self.account.client, params=json.dumps(body))
-
-    @Deprecated('This endpoint has been deprecated and will no longer be available '
-                'as of 2019-08-28')
-    def demographics(self):
-        """
-        Get the demographic breakdown for an input targeting criteria
-        """
-        body = {
-            "audience_definition": self.audience_definition,
-            "targeting_inputs": self.targeting_inputs
-        }
-        resource = self.RESOURCE_DEMOGRAPHICS.format(account_id=self.account.id)
-        response = Request(
-            self.account.client, self.METHOD,
-            resource, headers=self.HEADERS, body=json.dumps(body)).perform()
-        return response.body['data']
-
-
-# tailored audience permission properties
-# read-only
-resource_property(AudienceIntelligence, 'operator_type', readonly=True)
-resource_property(AudienceIntelligence, 'targeting_type', readonly=True)
-resource_property(AudienceIntelligence, 'targeting_value', readonly=True)
-resource_property(AudienceIntelligence, 'localized', readonly=True)
-# writable
-resource_property(AudienceIntelligence, 'conversation_type')
-resource_property(AudienceIntelligence, 'targeting_inputs')
-resource_property(AudienceIntelligence, 'audience_definition')
-# demographics only
-resource_property(AudienceIntelligence, 'start_time', transform=TRANSFORM.TIME)
-resource_property(AudienceIntelligence, 'end_time', transform=TRANSFORM.TIME)

examples/tweet_preview.py

@@ -7,7 +7,6 @@
 from twitter_ads.http import Request
 from twitter_ads.cursor import Cursor
 from twitter_ads import API_VERSION
-from twitter_ads.utils import Deprecated
 
 
 class TargetingCriteria(Resource, Persistence, Batch):
@@ -335,33 +334,12 @@ class ScheduledPromotedTweet(Resource, Persistence):
 
 class Tweet(object):
 
-    TWEET_PREVIEW = '/' + API_VERSION + '/accounts/{account_id}/tweet/preview'
-    TWEET_ID_PREVIEW = '/' + API_VERSION + '/accounts/{account_id}/tweet/preview/{id}'
     TWEET_CREATE = '/' + API_VERSION + '/accounts/{account_id}/tweet'
 
     def __init__(self):
         raise NotImplementedError(
             'Error! {name} cannot be instantiated.'.format(name=self.__class__.__name__))
 
-    @classmethod
-    @Deprecated('This endpoint has been deprecated and will no longer be available '
-                'as of 2019-08-20')
-    def preview(klass, account, **kwargs):
-        """
-        Returns an HTML preview of a tweet, either new or existing.
-        """
-        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(str, 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
     def create(klass, account, **kwargs):
         """

twitter_ads/audience.py

@@ -337,19 +337,6 @@ class ScheduledTweet(Resource, Persistence):
 
     RESOURCE_COLLECTION = '/' + API_VERSION + '/accounts/{account_id}/scheduled_tweets'
     RESOURCE = '/' + API_VERSION + '/accounts/{account_id}/scheduled_tweets/{id}'
-    PREVIEW = '/' + API_VERSION + '/accounts/{account_id}/scheduled_tweets/preview/{id}'
-
-    @Deprecated('This endpoint has been deprecated and will no longer be available '
-                'as of 2019-08-20')
-    def preview(self):
-        """
-        Returns an HTML preview for a Scheduled Tweet.
-        """
-        if self.id:
-            resource = self.PREVIEW
-            resource = resource.format(account_id=self.account.id, id=self.id)
-            response = Request(self.account.client, 'get', resource).perform()
-            return response.body['data']
 
 
 # scheduled tweet properties
@@ -378,23 +365,6 @@ class DraftTweet(Resource, Persistence):
 
     RESOURCE_COLLECTION = '/' + API_VERSION + '/accounts/{account_id}/draft_tweets'
     RESOURCE = '/' + API_VERSION + '/accounts/{account_id}/draft_tweets/{id}'
-    PREVIEW = '/' + API_VERSION + '/accounts/{account_id}/draft_tweets/preview/{id}'
-
-    @Deprecated('This endpoint has been deprecated and will no longer be available '
-                'as of 2019-08-20')
-    def preview(self, draft_tweet_id=None):
-        """
-        Preview a Draft Tweet on a mobile device.
-        """
-        if not (draft_tweet_id is None):
-            resource = self.PREVIEW.format(account_id=self.account.id, id=draft_tweet_id)
-        elif self.id:
-            resource = self.PREVIEW.format(account_id=self.account.id, id=self.id)
-        else:
-            raise AttributeError("object has no 'draft_tweet_id' to preview")
-
-        response = Request(self.account.client, 'post', resource).perform()
-        return response.body
 
 
 # draft tweet properties

twitter_ads/campaign.py

@@ -173,11 +173,6 @@ def enum(**enums):
     REPLACE='REPLACE'
 )
 
-AUDIENCE_DEFINITION = enum(
-    KEYWORD_AUDIENCE='KEYWORD_AUDIENCE',
-    TARGETING_CRITERIA='TARGETING_CRITERIA'
-)
-
 CONVERSATION_TYPE = enum(
     HASHTAG='HASHTAG',
     HANDLE='TARGETING_CRITERIA',