twitter-ads 4.0.1 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 960147733ff2dcaddd726fd01064152695055f88
-  data.tar.gz: 33c89c5efa732eaa1e98b7a3fde336b6672c0255
+  metadata.gz: 4483287f7e16d023a370c9352880877081d823a0
+  data.tar.gz: 3a37f0d133d886db3e41766b52f3364123e210d4
 SHA512:
-  metadata.gz: 2b33c9868bee1b43a954079be44eb43c9e581e815ea8d56612a94b1001498675dae0919518d612b6e39ef6571f411ebc87f55069d11e300298eab8b33ee132e4
-  data.tar.gz: 41221b6220ee792e99c56704480ccd4e3b2d16571d19c9fe0d378492ea2134798f934a724c40e10035dda50266e29967da3ea9f411e6661e0e4ec121750436ce
+  metadata.gz: 898ecdf5405dbb342ddf5b40d77904d854cdf9f0e284144142bcdcb594dbd4c01d7a0ed324c9f71bfcc3d6a6b55b73121076a2815314037d3f0a9c0464da57d0
+  data.tar.gz: 4a22e9b421c345b52e476a6d528454a3b790b46b462fa0017a389efbe36e45ec81cc30004cb8336af34158216d6d5f1a76b73fc76e10455ffef3773aad9c72fd

data/lib/twitter-ads/audiences/tailored_audience.rb

@@ -33,9 +33,9 @@ module TwitterAds
                            'accounts/%{account_id}/tailored_audience_changes'.freeze # @api private
     RESOURCE_MEMBERSHIPS = "/#{TwitterAds::API_VERSION}/" +
                            'tailored_audience_memberships'.freeze # @api private
-    RESOURCE_USERS       = "/#{TwitterAds::API_VERSION}/ \
-                           accounts/%{account_id}/tailored_audiences/ \
-                           %{id}/users".freeze # @api private
+    RESOURCE_USERS       = "/#{TwitterAds::API_VERSION}/" +
+                           'accounts/%{account_id}/tailored_audiences/' +
+                           '%{id}/users'.freeze # @api private
     # @api private
     GLOBAL_OPT_OUT = "/#{TwitterAds::API_VERSION}/" +
                      'accounts/%{account_id}/tailored_audiences/global_opt_out'.freeze

data/lib/twitter-ads/campaign/targeting_criteria.rb

@@ -45,7 +45,7 @@ module TwitterAds
       # Returns a Cursor instance for a given resource.
       #
       # @param account [Account] The Account object instance.
-      # @param line_item_id [String] The line item ID string.
+      # @param line_item_ids [String] A String or String array of Line Item IDs.
       # @param opts [Hash] An optional Hash of extended options.
       # @option opts [Boolean] :with_deleted Indicates if deleted items should be included.
       # @option opts [String] :sort_by The object param to sort the API response by.
@@ -55,8 +55,8 @@ module TwitterAds
       # @since 0.3.1
       # @see Cursor
       # @see https://dev.twitter.com/ads/basics/sorting Sorting
-      def all(account, line_item_id, opts = {})
-        params = { line_item_id: line_item_id }.merge!(opts)
+      def all(account, line_item_ids, opts = {})
+        params = { line_item_ids: Array(line_item_ids).join(',') }.merge!(opts)
         resource = RESOURCE_COLLECTION % { account_id: account.id }
         request = Request.new(account.client, :get, resource, params: params)
         Cursor.new(self, request, init_with: [account])

data/lib/twitter-ads/client.rb

@@ -3,7 +3,7 @@
 
 module TwitterAds
 
-  API_VERSION = '4'.freeze
+  API_VERSION = '5'.freeze
 
   # The Ads API Client class which functions as a
   # container for basic API consumer information.

data/lib/twitter-ads/creative/cards_fetch.rb

@@ -40,7 +40,6 @@ module TwitterAds
       property :iphone_app_id, read_only: true
       property :iphone_deep_link, read_only: true
       property :name, read_only: true
-      property :preview_url, read_only: true
       property :recipient_user_id, read_only: true
       property :second_choice, read_only: true
       property :second_cta, read_only: true
@@ -73,7 +72,7 @@ module TwitterAds
       property :id, read_only: true
 
       FETCH_URI = "/#{TwitterAds::API_VERSION}/" +
-                  'accounts/%{account_id}/cards'.freeze # @api private
+                  'accounts/%{account_id}/cards/all'.freeze # @api private
       FETCH_ID  = "/#{TwitterAds::API_VERSION}/" +
                   'accounts/%{account_id}/cards/all/%{id}'.freeze # @api private
 
@@ -82,26 +81,27 @@ module TwitterAds
           "'CardsFetch' object has no attribute 'all'")
       end
 
-      def load(account, card_uri = nil, card_id = nil, with_deleted = nil, opts = {})
-        if (card_uri && card_id) || (card_uri.nil? && card_id.nil?)
-          raise ArgumentError.new('card_uri and card_id are exclusive parameters. ' \
+      def load(account, card_uris = nil, card_id = nil, with_deleted = nil, opts = {})
+        if (card_uris && card_id) || (card_uris.nil? && card_id.nil?)
+          raise ArgumentError.new('card_uris and card_id are exclusive parameters. ' \
                              'Please supply one or the other, but not both.')
         end
 
-        if card_uri
-          params = { card_uri: card_uri }.merge!(opts)
-          resource = FETCH_URI % { account_id: account.id }
-        else
-          params = { card_id: card_id }.merge!(opts)
-          resource = FETCH_ID % { account_id: account.id, id: card_id }
-        end
-
         if with_deleted && TwitterAds::Utils.to_bool(with_deleted)
           params = { with_deleted: true }.merge!(opts)
         end
 
-        response = Request.new(account.client, :get, resource, params: params).perform
-        from_response(response.body[:data])
+        if card_uris
+          params = { card_uris: Array(card_uris).join(',') }.merge!(opts).merge!(params)
+          resource = FETCH_URI % { account_id: account.id }
+          request = Request.new(account.client, :get, resource, params: params)
+          return Cursor.new(self.class, request, init_with: [account])
+        else
+          params = { card_id: card_id }.merge!(opts).merge!(params)
+          resource = FETCH_ID % { account_id: account.id, id: card_id }
+          response = Request.new(account.client, :get, resource, params: params).perform
+          return from_response(response.body[:data])
+        end
       end
 
       def reload!

data/lib/twitter-ads/creative/image_app_download_card.rb

@@ -19,7 +19,6 @@ module TwitterAds
       property :id, read_only: true
       property :image_display_height, read_only: true
       property :image_display_width, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
       property :wide_app_image, read_only: true
 

data/lib/twitter-ads/creative/image_conversation_card.rb

@@ -18,7 +18,6 @@ module TwitterAds
       property :deleted, type: :bool, read_only: true
       property :id, read_only: true
       property :image, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
 
       property :cover_image_id

data/lib/twitter-ads/creative/poll_cards.rb

@@ -22,7 +22,6 @@ module TwitterAds
       property :image, read_only: true
       property :image_display_height, read_only: true
       property :image_display_width, read_only: true
-      property :preview_url, read_only: true
       property :start_time, type: :time, read_only: true
       property :updated_at, type: :time, read_only: true
       property :video_height, read_only: true

data/lib/twitter-ads/creative/video_app_download_card.rb

@@ -17,7 +17,6 @@ module TwitterAds
       property :created_at, type: :time, read_only: true
       property :deleted, type: :bool, read_only: true
       property :id, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
       property :video_content_id, read_only: true
       property :video_hls_url, read_only: true

data/lib/twitter-ads/creative/video_conversation_card.rb

@@ -17,7 +17,6 @@ module TwitterAds
       property :created_at, type: :time, read_only: true
       property :deleted, type: :bool, read_only: true
       property :id, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
       property :video_url, read_only: true
       property :video_poster_url, read_only: true

data/lib/twitter-ads/creative/video_website_card.rb

@@ -18,7 +18,6 @@ module TwitterAds
       property :created_at, type: :time, read_only: true
       property :deleted, type: :bool, read_only: true
       property :id, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
       property :video_content_id, read_only: true
       property :video_height, read_only: true

data/lib/twitter-ads/creative/website_card.rb

@@ -20,7 +20,6 @@ module TwitterAds
       property :image, read_only: true
       property :image_display_height, read_only: true
       property :image_display_width, read_only: true
-      property :preview_url, read_only: true
       property :updated_at, type: :time, read_only: true
       property :website_dest_url, read_only: true
       property :website_display_url, read_only: true

data/lib/twitter-ads/enum.rb

@@ -108,6 +108,7 @@ module TwitterAds
       LINE_ITEM          = 'LINE_ITEM'.freeze
       PROMOTED_TWEET     = 'PROMOTED_TWEET'.freeze
       ORGANIC_TWEET      = 'ORGANIC_TWEET'.freeze
+      MEDIA_CREATIVE     = 'MEDIA_CREATIVE'.freeze
     end
 
     module EntityStatus

data/lib/twitter-ads/version.rb

@@ -2,5 +2,5 @@
 # Copyright (C) 2015 Twitter, Inc.
 
 module TwitterAds
-  VERSION = '4.0.1'.freeze
+  VERSION = '5.0.0'.freeze
 end

data/spec/twitter-ads/creative/image_app_download_card_spec.rb

@@ -23,7 +23,7 @@ describe TwitterAds::Creative::ImageAppDownloadCard do
 
   # check model properties
   subject { described_class.new(account) }
-  read  = %w(id preview_url created_at updated_at deleted)
+  read  = %w(id created_at updated_at deleted)
 
   write = %w(
     name

data/spec/twitter-ads/creative/image_conversation_card_spec.rb

@@ -23,7 +23,7 @@ describe TwitterAds::Creative::ImageConversationCard do
 
   # check model properties
   subject { described_class.new(account) }
-  read  = %w(id preview_url image deleted created_at updated_at)
+  read  = %w(id image deleted created_at updated_at)
   write = %w(
     name
     title

data/spec/twitter-ads/creative/video_app_download_card_spec.rb

@@ -23,7 +23,7 @@ describe TwitterAds::Creative::VideoAppDownloadCard do
 
   # check model properties
   subject { described_class.new(account) }
-  read  = %w(id preview_url video_url video_poster_url deleted created_at updated_at)
+  read  = %w(id video_url video_poster_url deleted created_at updated_at)
   write = %w(
     name
     country_code

data/spec/twitter-ads/creative/video_conversation_card_spec.rb

@@ -26,7 +26,6 @@ describe TwitterAds::Creative::VideoConversationCard do
 
   read = %w(
     id
-    preview_url
     video_url
     video_poster_url
     deleted

data/spec/twitter-ads/creative/website_card_spec.rb

@@ -32,7 +32,6 @@ describe TwitterAds::Creative::WebsiteCard do
     image
     image_display_height
     image_display_width
-    preview_url
     website_dest_url
     website_display_url
     updated_at

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: twitter-ads
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 5.0.0
 platform: ruby
 authors:
 - Brandon Black
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-26 00:00:00.000000000 Z
+date: 2019-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json