ppc 0.3.0

data/lib/ppc/operation/creative.rb

@@ -0,0 +1,28 @@
+module PPC
+  module Operation
+    class Creative 
+      include ::PPC::Operation
+
+      def info()
+        ::PPC::API::Baidu::Creative::get( @auth, @id )
+      end
+
+      def update( keywordType )
+        ::PPC::API::Baidu::Keyword::update( @auth, keywordType )
+      end
+
+      def activate()
+        ::PPC::API::Baidu::Creative::activate( @auth, @id )
+      end
+
+      def status()
+        ::PPC::API::Baidu::Creative::status( @auth, @id )
+      end
+
+      def delete()
+        ::PPC::API::Baidu::Creative::delete( @auth, @id )
+      end
+
+    end
+  end
+end

data/lib/ppc/operation/group.rb

@@ -0,0 +1,59 @@
+module PPC
+  module Operation
+    class Group
+      include ::PPC::Operation
+      
+      def info()
+        call('group').get(@auth, @id)
+      end
+
+      def update( info )
+        info[:id] = @id unless info[:id]
+        call('group').update(@auth, info)
+      end
+
+      # =============================== #
+      def keywords()
+        call( 'keyword' ).search_by_group_id( @auth, @id )
+      end
+
+      def keyword_ids()
+        call( 'keyword' ).search_id_by_group_id( @auth, @id )
+      end
+
+      def creatives()
+        call( 'creative' ).search_by_group_id( @auth, @id )
+      end
+
+      def creative_ids()
+        call( 'creative' ).search_id_by_group_id( @auth, @id )
+      end
+
+      # keyword opeartion
+      include ::PPC::Operation::Keyword_operation
+
+      # creative opeartion
+      include ::PPC::Operation::Creative_operation
+
+      # Overwrite add method to provide more function
+      def add_keyword( keywords )
+        call('keyword').add( @auth, add_group_id( keywords ) )
+      end
+
+      def add_creative( creatives )
+        call('creative').add( @auth, add_group_id( creatives ) )
+      end
+      
+      # Auxilary function
+      private
+      def add_group_id( types )
+        types = [types] unless types.is_a? Array
+        types.each do |type|
+          type.merge!( {group_id:@id} )
+        end
+        return types
+      end
+
+    end # Group
+  end # Operation
+end # PPC

data/lib/ppc/operation/keyword.rb

@@ -0,0 +1,32 @@
+module PPC
+  module Operation
+    class Keyword
+      include ::PPC::Operation
+
+      def info()
+        ::PPC::API::Baidu::Keyword::get( @auth, @id )
+      end
+
+      def update( type )
+        ::PPC::API::Baidu::Keyword::update( @auth, type.merge( id:@id) )
+      end
+
+      def activate()
+        ::PPC::API::Baidu::Keyword::activate( @auth, @id )
+      end
+      
+      def status()
+        ::PPC::API::Baidu::Keyword::status( @auth, @id )
+      end
+
+      def quality()
+        ::PPC::API::Baidu::Keyword::quality( @auth, @id )
+      end
+
+      def delete()
+        ::PPC::API::Baidu::Keyword::delete( @auth, @id )
+      end
+
+    end
+  end
+end

data/lib/ppc/operation/plan.rb

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+module PPC
+  module Operation
+    class Plan
+      include ::PPC::Operation
+
+      def info
+        call('plan').get(@auth,@id)
+      end
+
+      def update( plan )
+        call('plan').update( @auth, plan.merge( id:@id ) )
+      end
+
+      def groups()
+        result = call('group').search_by_plan_id(@auth, @id)
+        result[:result] = result[:result][0][:groups]
+        return result
+      end
+
+      def group_ids()
+        result = call('group').search_id_by_plan_id(@auth, @id)
+        result[:result] = result[:result][0][:group_ids]
+        return result
+      end
+
+      # group opeartion
+      include ::PPC::Operation::Group_operation
+
+      # Overwirte add_group method to provide more function
+      def add_group( groups )
+        call('group').add( @auth, add_plan_id( groups ) )
+      end
+
+      # Auxilary function
+      private
+      def add_plan_id( types )
+        types = [types] unless types.is_a? Array
+        types.each do |type|
+          type.merge!({plan_id:@id})
+        end
+        return types
+      end
+
+    end # class plan
+  end # mudole Opeartion
+end # PPC

data/lib/ppc/operation/report.rb

@@ -0,0 +1,19 @@
+module PPC
+  module Operation
+    module Report
+
+      def query_report( param = nil, debug = false )
+        call('report').query_report( @auth, param, debug )
+      end
+
+      def creative_report( param = nil, debug = false )
+        call('report').creative_report( @auth, param, debug )
+      end
+
+      def keyword_report( param = nil, debug = false )
+        call('report').keyword_report( @auth, param, debug )
+      end
+
+    end
+  end
+end

data/ppc.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+# require ppc for version
+require 'ppc'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ppc"
+  spec.version       = PPC::VERSION
+  spec.authors       = ["Chienli Ma, 刘梦晨， 刘明"]
+  spec.email         = ["maqianlie@gmail.com, liuyu_tc@163.com, seoaqua@qq.com"]
+  spec.summary       = %q{ppc api for  baidu qihu sogou}
+  spec.description   = %q{ppc api for  baidu qihu sogou}
+  spec.homepage      = "http://github.com/elong/ppc"
+  spec.license       = "GNU"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'httparty', '~> 0.13', '>= 0.13.0'
+  spec.add_dependency 'savon',  '~> 3.0', '>= 3.0.0'
+
+end

data/spec/baidu/api_baidu_account_spec.rb

@@ -0,0 +1,15 @@
+describe ::PPC::API::Baidu::Account do
+  auth = $baidu_auth
+  
+  it 'can get account info' do
+      result = ::PPC::API::Baidu::Account::info( auth )
+      is_success( result )
+  end
+
+  it 'can update account' do
+    update = {budget:2990}
+    result =  ::PPC::API::Baidu::Account::update( auth, update )
+    is_success( result )
+  end
+
+end

data/spec/baidu/api_baidu_creative_spec.rb

@@ -0,0 +1,67 @@
+# -*- coding:utf-8 -*-
+describe ::PPC::API::Baidu::Creative do
+  auth = $baidu_auth
+
+  test_group_id = ::PPC::API::Baidu::Group::ids( auth )[:result][0][:group_ids][0]
+  test_plan_id = ::PPC::API::Baidu::Plan::all( auth )[:result][0][:plan_id]
+  test_creative_id = []
+
+ it 'can add creative' do
+    creative = { group_id: test_group_id, 
+                        title: 'TestCreative', preference:1, 
+                        description1:'this is rest',
+                        description2:'also is a test',
+                        pc_destination:$baidu_domain,
+                        pc_display:$baidu_domain }
+    response = ::PPC::API::Baidu::Creative::add( auth, creative )
+    is_success( response )
+    test_creative_id << response[:result][0][:id]
+  end
+
+  it 'can update creative' do
+    update = { id:test_creative_id[0], 
+                       title:'ElongUpdateTest',
+                       description1:'test for update',
+                        mobile_destination:$baidu_domain,
+                        pc_destination:$baidu_domain,
+                       pause:true} 
+    response = ::PPC::API::Baidu::Creative::update( auth, update )
+    is_success( response )
+  end
+
+  it 'can activate creative' do
+    response = ::PPC::API::Baidu::Creative::activate( auth, test_creative_id )
+    is_success( response )
+  end
+
+  # 连续测试的系统返回system_failured
+  # it 'can get status' do
+  #   response1 = ::PPC::API::Baidu::Creative::status( auth, test_group_id, 'group' )
+  #   response2 = ::PPC::API::Baidu::Creative::status( auth, test_creative_id, 'creative' )
+  #   response3 = ::PPC::API::Baidu::Creative::status( auth, test_plan_id, 'plan' )
+  #   is_success( response1 ) 
+  #   is_success( response2 ) 
+  #   is_success( response3 ) 
+  # end
+
+  it 'can search id by group id' do
+    response = ::PPC::API::Baidu::Creative::search_id_by_group_id( auth, test_group_id, 0 )
+    is_success( response )
+  end
+
+  it 'can search creative by group id' do
+    response = ::PPC::API::Baidu::Creative::search_by_group_id( auth, test_group_id, 0 )
+    is_success( response )
+  end
+
+  it 'can search creative by creative id' do
+    response = ::PPC::API::Baidu::Creative::get( auth, test_creative_id, 0 )
+    is_success( response )
+  end
+
+  it 'can delete creative' do 
+    response = ::PPC::API::Baidu::Creative::delete( auth, test_creative_id )
+    is_success( response )
+  end
+
+end

data/spec/baidu/api_baidu_group_spec.rb

@@ -0,0 +1,45 @@
+describe ::PPC::API::Baidu::Group do
+  auth = $baidu_auth
+
+  test_plan_id = ::PPC::API::Baidu::Plan.ids(auth)[:result][0]
+  test_group_id = []
+
+  it 'can get all group' do 
+    response = ::PPC::API::Baidu::Group::ids( auth )
+    is_success( response ) 
+  end
+
+  it 'can add group' do 
+    group = { name: 'test_group', plan_id:test_plan_id, price:500 }
+    response = ::PPC::API::Baidu::Group::add( auth, group )
+    is_success( response )
+    test_group_id << response[:result][0][:id]
+  end
+  
+  it 'can update group' do 
+    group = { id: test_group_id[0], price:600 }
+    response = ::PPC::API::Baidu::Group::update( auth, group )
+    is_success( response )
+  end
+
+  it 'can search group by group id' do
+    response = ::PPC::API::Baidu::Group::get( auth, test_group_id )
+    is_success( response )
+  end
+  
+  it 'can search group id by plan id' do
+    response = ::PPC::API::Baidu::Group::search_id_by_plan_id( auth, test_plan_id )
+    is_success( response )
+  end
+
+  it 'search by plan id' do 
+    response = ::PPC::API::Baidu::Group::search_by_plan_id( auth, test_plan_id )
+    is_success( response )
+  end  
+
+  it 'can delete group' do 
+    response = ::PPC::API::Baidu::Group::delete( auth, test_group_id )
+    is_success( response )
+  end
+  
+end

data/spec/baidu/api_baidu_keyword_spec.rb

@@ -0,0 +1,61 @@
+# -*- coding:utf-8 -*-
+describe ::PPC::API::Baidu::Keyword do
+  auth = $baidu_auth
+
+  test_group_id = ::PPC::API::Baidu::Group::ids( auth )[:result][0][:group_ids][0]
+  test_plan_id = ::PPC::API::Baidu::Plan::all( auth )[:result][0][:plan_id]
+  test_keyword_id = []
+
+  it 'can search keyword by group id' do
+    response = ::PPC::API::Baidu::Keyword::search_by_group_id( auth, test_group_id )
+    is_success( response )
+  end
+
+  it 'can add keyword' do
+    keyword = { group_id: test_group_id, keyword: 'testkeywordid', match_type:'exact' }
+    response = ::PPC::API::Baidu::Keyword::add( auth, keyword )
+    is_success( response )
+    test_keyword_id << response[:result][0][:id]
+  end
+
+  it 'can update keyword' do
+    update = { id:test_keyword_id[0],  pc_destination: $baidu_domain, pause:true} 
+    response = ::PPC::API::Baidu::Keyword::update( auth, update )
+    is_success( response )
+  end
+
+  it 'can activate keyword' do
+    response = ::PPC::API::Baidu::Keyword::activate( auth, test_keyword_id )
+    is_success( response )
+  end
+
+  # 连续测试系统返回system failure
+  # it 'can get status' do
+  #   response1 = ::PPC::API::Baidu::Keyword::status( auth, test_group_id, 'group' )
+  #   response2 = ::PPC::API::Baidu::Keyword::status( auth, test_keyword_id, 'keyword' )
+  #   response3 = ::PPC::API::Baidu::Keyword::status( auth, test_plan_id, 'plan' )
+  #   is_success( response1 ) 
+  #   is_success( response2 ) 
+  #   is_success( response3 ) 
+  # end
+
+  # it 'can get quality' do
+  #   response1 = ::PPC::API::Baidu::Keyword::quality( auth, test_group_id, 'group', true )
+  #   response2 = ::PPC::API::Baidu::Keyword::quality( auth, test_keyword_id, 'keyword', true )
+  #   response3 = ::PPC::API::Baidu::Keyword::quality( auth, test_plan_id, 'plan', true )
+  #   is_successed( response1 ) 
+  #   is_successed( response2 ) 
+  #   is_successed( response3 ) 
+  # end
+
+  it 'can get 10-quality' do
+    response = ::PPC::API::Baidu::Keyword::quality( auth, test_keyword_id, 'keyword', 'pc' )
+    is_success( response )    
+  end
+
+  it 'can delete keyword' do
+    response = ::PPC::API::Baidu::Keyword::delete( auth, test_keyword_id )
+    is_success( response )
+  end
+
+end

data/spec/baidu/api_baidu_plan_spec.rb

@@ -0,0 +1,43 @@
+describe ::PPC::API::Baidu::Plan do
+  auth = $baidu_auth
+
+  test_plan_id = []
+
+  ::PPC::API::Baidu.debug_on
+
+  it "can get all plans" do
+    response = ::PPC::API::Baidu::Plan::all( auth )
+    is_success( response )
+  end
+
+  it "can get all plan id" do 
+    response = ::PPC::API::Baidu::Plan::ids( auth )
+    is_success( response )
+  end 
+
+  it "can add plan" do
+    test_plan = { name: "test_elong_e", negative: ["test"] }
+    response = ::PPC::API::Baidu::Plan::add( auth, test_plan )
+    is_success( response )
+    test_plan_id << response[:result][0][:id]
+  end
+
+  it "can get plan by id" do
+    response = ::PPC::API::Baidu::Plan::get( auth, test_plan_id )
+    is_success( response )
+  end
+
+  it 'can update plan' do
+    update = { id: test_plan_id[0], name:"test_plan_update", is_dynamic:false }
+    response = ::PPC::API::Baidu::Plan::update( auth, update )
+    # param isDynamicCreative should not be default value
+    expect( response[:result][0][:is_dynamic] ).to eq false
+    is_success( response )
+  end
+
+  it "can delete plan" do
+    response = ::PPC::API::Baidu::Plan::delete( auth, test_plan_id )
+    is_success( response )
+  end
+
+end