twitter_ads 0.0.4 → 0.0.5

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZjE0ZmFmYWFmMmJiYzc5MzFjY2E5YmI5M2FjZjlmN2ViM2ZkZTQwYQ==
+    YWU0OWMyZGY5MWFhMzIzNDhkZDM1OTNjOTI2OWZjMGY4MjFhMTY3ZA==
   data.tar.gz: !binary |-
-    OWU0OGJmM2VmMGFjMWFkMDIyMjA0Zjk4NjU5NjFmYmY4NDZlYzA1NQ==
+    OTUyYTM2MjdhMmYxZmI5YWFkOTA3YTY0OGQ0NjlmNGJkNGE2N2RjMg==
 SHA512:
   metadata.gz: !binary |-
-    MTcwMDE4MjgwYTY3ZDgyM2Y0YWZiZWMyNjkyM2U5NmU1ZWJhNGVlNGU5ZWQy
-    ODUzZjIwYzk1Zjk0ZmFkZDBkZDJkNmNmMTYzZGZiZTc5Zjc0YzBlNGE2OGYx
-    NGYyNTg0MjFhMjM4MDJjNTMxZGFkYjRlYzQxMTk1ZTdlMmUyZTQ=
+    YjAzNGQxYzYxODUxOWEyZWQwOTNiN2VmYmI2MzRjYTJmM2UzMjVhNGQ3NDE0
+    NTFmNDZiMDRkYWZkZDc2MGIwZDRlNmVkZTRkNmYzODBjYWJlMWNkMGYzZjEz
+    NTVlY2Y0ZDE4NjUxMTQ0MGM4ZGQ3ODMyOTAzMDFlNjUzODMxZWM=
   data.tar.gz: !binary |-
-    MWRlNDg0NzA2NGNjNmI4Mjg2MzM0ODgwYmQ0MjdmM2E5YmM5MThiZWZhY2Yw
-    YmEyODIzZjg2NGYwMjAyNzEyZTI5NzZkY2EwNzE4NTk4M2VmOWY1N2RmNTE0
-    MzRhMDc2YjcwZTU2MTM4NTYwMjhmMWViYTJkYTRkYmEyYzE1ZjE=
+    ODI3ZjljNDU0Yzk2OTczNmVlMThiMjBiNGQ3MGFiZTA2YzlkZDhiMDZmZDdi
+    ZWQ3NzQxM2UwNGU2YjI0NTYzMzJhNjdiMzk2M2MyYWEwYzRjZmVhZGExYjQ2
+    MDZkMDk3NzZlODUzMzA3OWMxNDI0Y2M4MThiOGNhZmFhZTEwOWM=

data/lib/twitter_ads/account.rb

@@ -0,0 +1,43 @@
+#
+# @ Seevibes 2015
+# Author Thomas Landspurg
+#
+# thomas@seevibes.com
+#
+#
+
+
+module TwitterAds
+
+
+  class Account < RestResource
+
+    attr_reader
+
+    def initialize(client, account)
+      @client = client
+      @attributes = account
+      init
+      @prefix = "accounts/#{@id}/"
+      @ops = {
+        :get => [
+          :promoted_accounts, :promoted_tweets, :tailored_audience_changes,
+          :targeting_criteria, :app_lists, :campaigns, :funding_instruments,
+          :line_items, :promoted_accounts, :promotable_users, :reach_estimate,
+          :targeting_suggestions,:tailored_audiences
+        ],
+        :post => [:tailored_audiences, :tailored_audience_changes, :campaigns],
+        :put => [:campaigns, :promoted_tweets, :targeting_criteria, 'tailored_audiences__global_opt_out'],
+        :delete => [:tailored_audiences, :campaigns, :promoted_tweets, :targeting_criteria]
+      }
+    end
+    def tailored_audiences
+    	get('tailored_audiences').map{ |ta| TailoredAudience.new(self, ta)}
+    end
+
+    def tailored_audience tailored_audience_id
+      TwitterAds::TailoredAudience.new(self, {'id' => tailored_audience_id})
+    end
+  end
+
+end

data/lib/twitter_ads/client.rb

@@ -0,0 +1,39 @@
+#
+# @ Seevibes 2015
+# Author Thomas Landspurg
+#
+# thomas@seevibes.com
+#
+#
+
+module TwitterAds
+
+
+  class Client < RestResource
+    attr_reader :config, :access_token, :ops
+
+    def initialize(params)
+      @config = params
+      @ops = { get: [:bidding_rules, :iab_categories] }
+      @attributes={}
+      consumer = OAuth::Consumer.new(params[:consumer_key], params[:consumer_secret], site: "https://#{ADS_API_ENDPOINT}")
+      consumer.http.use_ssl = true
+      consumer.http.set_debug_output(STDERR)
+      consumer.http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      @client = self # To manage rest resource
+      @access_token = OAuth::AccessToken.new(consumer, params[:access_token], params[:access_secret])
+    end
+
+    # return the list of available accounts
+    def accounts
+      @cached_accounts = get('accounts').map { |account| Account.new(self, account) } unless @cached_accounts
+      @cached_accounts
+    end
+
+    # Create an account based on his id
+    def account(account_id)
+      TwitterAds::Account.new(self, {'id' => account_id})
+    end
+  end
+
+end

data/lib/twitter_ads/rest_ressource.rb

@@ -0,0 +1,109 @@
+#
+# @ Seevibes 2015
+# Author Thomas Landspurg
+#
+# thomas@seevibes.com
+#
+#
+
+
+module TwitterAds
+
+
+
+  # Common class to manage access to recourse
+  # Need access to client, prefix, and ops available on this ressource
+  #
+  # provide operation oauth autenthificated operation (get/post/put/delete)
+  # as well as dynamically discovered opertions, using the ops instance variable
+  #
+  class RestResource
+    @prefix = ''
+    attr :access_token, :prefix, :client, :attributes, :id, :name
+
+    def init
+    	@id = @attributes['id']
+      @name = @attributes['name']
+    end
+
+    # Utility funciton to do a get on the RES API
+    def get(action = '', params = nil)
+      do_request :get, action, params
+    end
+
+    def post(action, params = nil)
+      do_request :post, action, params
+    end
+
+    def put(action, params = nil)
+      do_request :put, action, params
+    end
+
+    def delete(action = '', params = nil)
+      do_request :delete, action, params
+    end
+
+    def do_request(verb, action, params)
+      url = "https://#{ADS_API_ENDPOINT}/0/#{prefix}#{action}"
+      url = url[0..-2] if url[-1] == '/'
+
+      # TODO: add a logger
+      puts "Doing request:#{verb} #{prefix} #{action} #{params} URL:#{url}" if TRACE
+      res = ::MultiJson.load(@client.access_token.request(verb, url, params).body)
+
+      # TODO: pretty format the errors
+      raise AdsError, res['errors'].first['code'] if res['errors']
+      res['data']
+    end
+
+
+    # Dynamic check of methods
+    # tab_ops contain the list of allowed method and verbs
+    # prefix the prefix to add to the method
+    #
+    def check_method(tab_ops, prefix, method_sym, do_call, *arguments, &block)
+      method_sym = method_sym.id2name
+      verb = :get
+      [:post, :get, :delete, :put].each do |averb|
+        if method_sym.start_with? averb.id2name
+          verb = averb
+          method_sym[averb.id2name + '_'] = ''
+          break
+        end
+      end
+      if tab_ops[verb].include? method_sym.to_sym
+        if do_call
+          params = arguments.first
+          method = prefix + method_sym
+          method += "/#{params.shift}"  if params.first && params.first.class != Hash
+          return do_request verb, method, params.shift
+        else
+          return nil
+        end
+      end
+      nil
+    end
+
+    def method_missing(method_sym, *arguments, &block)
+      # the first argument is a Symbol, so you need to_s it if you want to pattern match
+      check_method(@ops, '', method_sym, true, arguments, block) || super
+    end
+
+    def respond_to?(method_sym)
+      if check_method(@ops, '', method_sym.to_sym, false, '', nil)
+        return true
+      end
+      super
+    end
+
+    def as_json
+      @attributes
+    end
+
+    def refresh
+      @attributes = get('')
+      init
+    end
+  end
+
+end

data/lib/twitter_ads/tailored_audience.rb

@@ -0,0 +1,27 @@
+#
+# @ Seevibes 2015
+# Author Thomas Landspurg
+#
+# thomas@seevibes.com
+#
+#
+
+module TwitterAds
+
+  class TailoredAudience < RestResource
+
+    attr_reader :account
+
+    def initialize(account,tailored_audience_hash)
+      @account = account
+      @client = account.client
+      @attributes = tailored_audience_hash
+      init
+      @prefix = "accounts/#{account.id}/tailored_audiences/#{@id}"
+      puts "Prefix: #{@prefix}"
+      @ops = {
+      }
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: twitter_ads
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Thomas Landspurg
@@ -31,6 +31,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/twitter_ads.rb
+- lib/twitter_ads/account.rb
+- lib/twitter_ads/client.rb
+- lib/twitter_ads/rest_ressource.rb
+- lib/twitter_ads/tailored_audience.rb
 homepage: https://github.com/seevibes/twitter_ads
 licenses:
 - MIT