sogou 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 34ca740ff610ccc11d870a62c19a27598d665774
+  data.tar.gz: 2c8c3d3e28e7243cfbf26fbbd7098c6ccca0614f
+SHA512:
+  metadata.gz: 7ce3c4afc5e97a99795a243c41e0719a3bad53b16c97d9334efaed7443e13cf8e3c81ad2f84cef3fba778b86211df8a4a6073bb0ea92e47984880521bf314130
+  data.tar.gz: 307392307a8daaa544c8ef86fbec772db420963058aed0c13383ff6749058b45876bc3bccf730be8100f16adbc72c14b2808e2a6ae6a73836801fcf65801fc96

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://ruby.taobao.org'
+
+# Specify your gem's dependencies in sogou.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 刘明
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,58 @@
+# Sogou
+
+Sogou SEM Services
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'sogou'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sogou
+
+## Knowledge
+camel命名法，用于request数据格式
+snake命名法，用于response数据格式
+
+## Rspec
+先修改spec/spec_helper.rb
+
+```ruby
+
+$username = ''
+$password = ''
+$token = ''
+
+```
+
+## Usage
+
+SEM
+
+```ruby
+require 'sogou'
+
+auth = Sogou::Auth.new
+auth.username = 'username'
+auth.password = 'password'
+auth.token = 'token'
+
+ss = Sogou::SEM::SearchService.new(auth)
+res = ss.getAccountInfo({})
+res = ss.getAccountInfo({},true) #debug=true
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/sogou/auth.rb

@@ -0,0 +1,5 @@
+module Sogou
+  class Auth
+    attr_accessor :username,:password,:token
+  end
+end

data/lib/sogou/ext.rb

@@ -0,0 +1,46 @@
+class String
+  def snake_case
+    self.gsub(/::/, '/').
+    gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+    gsub(/([a-z\d])([A-Z])/,'\1_\2').
+    tr("-", "_").
+    downcase
+  end
+end
+class Savon
+  class Response
+    def header
+      hash[:envelope][:header]
+    end
+    def res_header
+      header[:res_header]
+    end
+    def desc
+      res_header[:desc]
+    end
+    def quota
+      res_header[:quota]
+    end
+    def rquota
+      res_header[:rquota]
+    end
+    def oprs
+      res_header[:oprs]
+    end
+    def oprtime
+      res_header[:oprtime]
+    end
+    def failures
+      res_header[:failures]
+    end
+    def code
+      failures[:code] if failures
+    end
+    def message
+      failures[:message] if failures
+    end
+    def status
+      res_header[:status]
+    end
+  end
+end

data/lib/sogou/response.rb

@@ -0,0 +1,15 @@
+module Sogou
+  class Response
+    attr_accessor :header,:body,:rquota,:quota,:status,:desc,:oprs,:oprtime
+    def initialize(response,name_response_sym)
+      @header = response.header[:res_header]
+      @body = response.body[name_response_sym]
+      @rquota = @header[:rquota].to_i
+      @quota = @header[:quota].to_i
+      @status = @header[:status].to_i
+      @desc = @header[:desc]
+      @oprs = @header[:oprs]
+      @oprtime = @header[:oprtime]
+    end
+  end
+end

data/lib/sogou/sem/account.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class AccountService < Base
+    end
+  end
+end

data/lib/sogou/sem/adgroup.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class AdgroupService < Base
+    end
+  end
+end

data/lib/sogou/sem/base.rb

@@ -0,0 +1,100 @@
+module Sogou
+  module SEM
+    class Base
+      attr_accessor :username,:password,:token
+      attr_accessor :debug
+
+      def initialize(auth)
+        classname = self.class.name.split('::').last
+        @service_name =
+          case classname
+            when 'CampaignService'
+              'CpcPlanService'
+            when 'AccountService'
+              'AccountService'
+            when 'AdgroupService'
+              'CpcGrpService'
+            when 'KeywordService'
+              'CpcService'
+            when 'CreativeService'
+              'CpcIdeaService'
+            when 'ReportService'
+              'ReportService'
+            when 'DownloadService'
+              'AccountDownloadService'
+            when 'KRService'
+              'KRService'
+            end
+
+        @port_name = @service_name
+        @username = auth.username
+        @password = auth.password
+        @token = auth.token
+        @client = Savon.new("http://api.agent.sogou.com:8080/sem/sms/v1/#{@service_name}?wsdl")
+
+        # Savon.new(@base_uri+service_name+'?wsdl')
+      end
+      def method_missing(name, *args, &block)
+        options,debug = args[0],args[1]
+        options = {} if options.nil?
+        name = name.to_s
+        name_snake = name.snake_case
+        # p name
+
+
+        name_request_sym = (name +'Request').to_sym #if %w(getCampaignByCampaignId getAllCampaign addCampaign updateCampaign deleteCampaign).include?name
+        # puts name_request_sym
+        name_response_sym = (name+'Response').snake_case.to_sym
+        operation = make_operation(name)
+        operation.header = operation_header
+        operation.body = {
+          name_request_sym => options
+        }
+        ap operation.body if debug
+        puts operation.build if debug
+        response = operation.call
+        ap response if debug
+        # ap response.failures if debug
+        if response.failures
+          raise response.failures.to_s
+        else
+          Sogou::Response.new(response,name_response_sym)
+        end
+      end
+      def operations
+        @client.operations(@service_name,@port_name)
+      end
+
+      def make_operation(operation_name)
+        @client.operation(@service_name,@port_name,operation_name)
+      end
+
+      def operation_header
+       {
+          :AuthHeader=>
+          {
+            :username=>@username,
+            :password=>@password,
+            :token=>@token
+          }
+        }
+      end
+
+      def example(operation,with_header=false)
+        operation = make_operation(operation)
+        if with_header
+        {
+          :example_header => operation.example_header,
+          :example_body => operation.example_body
+        }
+        else
+          operation.example_body
+        end
+      end
+
+      # def invalid_options?(options,necessary_options)
+      #   return true if necessary_options.any?{|necessary_option|!options.has_key?necessary_option}
+      # end
+    end
+  end
+end

data/lib/sogou/sem/campaign.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class CampaignService < Base
+    end
+  end
+end

data/lib/sogou/sem/creative.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class CreativeService < Base
+    end
+  end
+end

data/lib/sogou/sem/enum.rb

@@ -0,0 +1,70 @@
+module Sogou
+  module SEM
+    module Format
+      CSV = 2
+    end
+
+    module ReportState
+      PENDING = 1 #等待中
+      DOING = 2 #处理中
+      DONE = 3 #处理成功
+    end
+
+
+    module PerformanceData
+      COST = 'cost' #消费
+      CPC = 'cpc' #每个点击的消费
+      CLICK = 'click' #点击数
+      IMPRESSION = 'impression' #展示量
+      CTR = 'ctr' #转化率
+      CPM = 'cpm' #?
+      POSITION = 'position' #？
+      CONVERSION = 'conversion' #?
+    end
+
+    module LevelOfDetails
+      PORTFOLIO = 2 #账户粒度
+      CAMPAIGN = 3 #计划粒度
+      ADGROUP = 5 #单元粒度
+      CREATIVE = 7 #创意粒度
+      KEYWORDID = 11 #关键词(keywordid)粒度
+      KEYWORD = 12 #关键词(keywordid)+创意粒度
+    end
+
+    module ReportType
+      PORTFOLIO = 2 #账户
+      CAMPAIGN = 10 #计划
+      ADGROUP = 11 #单元
+      KEYWORDID = 14 #关键词(keywordid)
+      CREATIVE = 12 #创意
+      PAIR = 15 #配对
+      REGION = 3 #地域
+      QUERY = 6 #搜索词
+      WORD = 9 #关键词(wordid)
+    end
+
+    module StatRange #注意:统计范围不能细于当前的统计 粒度,例如统计粒度为计划,则统计 范围不能细到单元
+      PORTFOLIO = 2 #账户范围
+      CAMPAIGN = 3 #计划范围
+      ADGROUP = 5 #单元范围
+      CREATIVE = 7 #创意范围
+      KEYWORDID = 11 #关键词(keywordid)范围
+      WORD = 6 #关键词(wordid)范围
+    end
+
+    module UnitOfTime
+      DAY = 5 #分日
+      WEEK = 4 #分周
+      MONTH = 3 #分月
+      YEAR = 1 #分年
+      HOUR = 7 #分小时
+      TIME = 8 #请求时间段汇总(endDate-StartDate)
+    end
+
+    module Device
+      ALL = 0 #全部搜索推广设备
+      PC = 1 #仅计算机
+      MOBILE = 2 #仅移动 
+    end
+  end
+end

data/lib/sogou/sem/keyword.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class KeywordService < Base
+    end
+  end
+end

data/lib/sogou/sem/report.rb

@@ -0,0 +1,6 @@
+module Sogou
+  module SEM
+    class ReportService < Base
+    end
+  end
+end

data/lib/sogou/sem.rb

@@ -0,0 +1,8 @@
+require 'sogou/sem/base'
+require 'sogou/sem/account'
+require 'sogou/sem/campaign'
+require 'sogou/sem/adgroup'
+require 'sogou/sem/keyword'
+require 'sogou/sem/creative'
+require 'sogou/sem/enum'
+require 'sogou/sem/report'

data/lib/sogou/version.rb

@@ -0,0 +1,3 @@
+module Sogou
+  VERSION = "0.0.1"
+end

data/lib/sogou.rb

@@ -0,0 +1,11 @@
+require "sogou/version"
+require "sogou/auth"
+require "sogou/sem"
+require "sogou/response"
+require "sogou/ext"
+require 'savon'
+require 'awesome_print'
+
+module Sogou
+  # Your code goes here...
+end

data/sogou.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sogou/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "sogou"
+  spec.version       = Sogou::VERSION
+  spec.authors       = ["seoaqua"]
+  spec.email         = ["seoaqua@me.com"]
+  spec.description   = %q{sogou web services}
+  spec.summary       = %q{sogou sem services}
+  spec.homepage      = "http://github.com/seoaqua/sogou"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "savon","~> 3.0"
+end

data/spec/sem_account_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe Sogou::SEM::AccountService do
+  subject{Sogou::SEM::AccountService.new($auth)}
+  let(:options){options = {}}
+  describe "#getAccountInfo" do
+    it "getAccountInfo" do
+      response = subject.getAccountInfo(options)
+      response.status.should == 0
+      response.desc.should == 'success'
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+    end
+  end
+end

data/spec/sem_adgroup_spec.rb

@@ -0,0 +1,120 @@
+require 'spec_helper'
+
+describe Sogou::SEM::AdgroupService do
+  subject{Sogou::SEM::AdgroupService.new($auth)}
+  describe '#getAllCpcGrpId' do
+    it "should return hash with correct format calling getAllCpcGrpId " do
+
+      response = subject.getAllCpcGrpId
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      # response.class.should == Hash
+      # response.should have_key :campaign_adgroup_ids
+      # response = response[:campaign_adgroup_ids]
+      # response.first.should have_key :campaign_id
+      # response.first.should have_key :adgroup_ids
+      # campaign_id = response.first[:campaign_id]
+      # campaign_id.to_i.to_s.should == campaign_id
+      # response.first[:adgroup_ids].class.should == Array
+      # adgroup_id = response.first[:adgroup_ids].first
+      # adgroup_id.to_i.to_s.should == adgroup_id
+    end
+  end
+
+  describe '#getCpcGrpByCpcGrpId' do
+    # subject{Sogou::SEM::AdgroupService.new($auth)}
+    it "should return hash with correct format calling getCpcGrpByCpcGrpId" do
+      response = subject.getCpcGrpByCpcGrpId({:cpcGrpIds=>[$adgroup_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+    end
+  end
+
+  describe '#getCpcGrpIdByCpcPlanId' do
+    # subject{Sogou::SEM::AdgroupService.new($auth)}
+    it "should return hash with correct format calling getCpcGrpIdByCpcPlanId" do
+      response = subject.getCpcGrpIdByCpcPlanId({:cpcPlanIds=>[$campaign_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      # response.class.should == Hash
+      # response.should have_key :campaign_adgroups
+    end
+  end
+
+  # describe '#getAdgroupByAdgroupId' do
+  #   # subject{Sogou::SEM::AdgroupService.new($auth)}
+  #   it "should return hash with correct format calling getAdgroupByAdgroupId" do
+  #     pending
+  #     response = subject.getAdgroupByAdgroupId({:adgroupIds => $adgroup_ids})
+  #     response.status.should == 0
+  #     response.desc.should == 'success'
+  #     response.quota.should == 2
+  #     response.rquota.should > 0
+  #     expect{ApiResponse.verify(response.body)}.not_to raise_error
+  #   end
+  # end
+
+  describe '#addCpcGrp #updateCpcGrp #getCpcGrpByCpcGrpId #deleteCpcGrp' do
+    # subject {Sogou::SEM::AdgroupService.new($aut)}
+    it "is not ready yet" do
+      #addCpcGrp
+      adgroupType_add = {:cpcPlanId=>$campaign_id,:cpcGrpName=>'adgroupName1',:maxPrice=>2}
+
+      response = subject.addCpcGrp({:cpcGrpTypes => [adgroupType_add]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # ap response.body
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+
+      #parse and verify adgroup_id
+      adgroup_id = response.body[:cpc_grp_types][:cpc_grp_id]
+      adgroup_id.to_i.to_s.should == adgroup_id
+
+      #updateCpcGrp
+      adgroupType_update = {:cpcGrpId => adgroup_id, :cpcGrpName => 'adgroupName2'}
+      # ap adgroupType
+      response = subject.updateCpcGrp({:cpcGrpTypes=>[adgroupType_update]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # ap response.body
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+
+      #getCpcGrpByCpcGrpId
+      response = subject.getCpcGrpByCpcGrpId({:cpcGrpIds=>[adgroup_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should >= 0
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      # response.body[:adgroup_types][:adgroup_name].should == 'adgroupName2'
+
+
+      #deleteCpcGrp
+      response = subject.deleteCpcGrp({:cpcGrpIds => [adgroup_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # ap response.body
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      # ap response.body
+      # it "is not implemented yet" do
+      #   pending("this is pending before we have testing-purpose account")
+      # end
+    end
+  end
+
+end

data/spec/sem_campaign_spec.rb

@@ -0,0 +1,94 @@
+require 'spec_helper'
+describe Sogou::SEM::CampaignService do
+  subject{Sogou::SEM::CampaignService.new($auth)}
+
+  describe '#addCampaign #updateCampaign #getCpcPlanByCpcPlanId #deleteCampaign' do
+    pending
+    it "should not raise errors when add, update, and delete a temp campaign" do
+      # ap subject.example('deleteCpcPlan')
+      # pending
+      #addCampaign
+      campaign_type_add = {
+        :cpcPlanName=> 'campaignName18',
+        :budget => '100',
+        :negativeWords => ['7day'],
+        :exactNegativeWords => ['7daysin']
+      }
+      options = {:cpcPlanTypes => [campaign_type_add]}
+      response = subject.addCpcPlan(options)
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 1
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      #parse and verify campaign_id
+      campaign_id = response.body[:cpc_plan_types][:cpc_plan_id]
+      campaign_id.to_i.to_s.should == campaign_id
+
+      #updateCpcPlan
+      campaign_type_update =
+      {
+        :cpcPlanId => campaign_id,
+        :cpcPlanName => 'campaignName19',
+        :budget => '101',
+        :negativeWords => ['8day'],
+        :exactNegativeWords => ['8daysin']
+      }
+      sleep 2
+      options = {:cpcPlanTypes => [campaign_type_update]}
+      response = subject.updateCpcPlan(options)
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 1
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      #check the result of updateCpcPlan by getCpcPlanByCpcPlanId
+      response = subject.getCpcPlanByCpcPlanId({:cpcPlanIds => [campaign_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 1
+      response.rquota.should > 0
+      sleep 2
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+      # ap response.body
+      response.body[:cpc_plan_types][:cpc_plan_name].should == 'campaignName19'
+      response.body[:cpc_plan_types][:budget].should == '101.0'
+      response.body[:cpc_plan_types][:negative_words].should == '8day'
+      response.body[:cpc_plan_types][:exact_negative_words].should == "8daysin"
+
+      #deleteCpcPlan
+      response = subject.deleteCpcPlan({:cpcPlanIds=>[campaign_id]})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 1
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+    end
+  end
+
+  # describe '#getCpcPlanByCpcPlanId' do
+  #   it "getCpcPlanByCpcPlanId" do
+  #     # puts '==============='
+  #     # puts subject.example('getAllCampaign')
+  #     # {:GetCampaignByCampaignIdRequest=>{:campaignIds=>["long"]}}
+  #     # puts '==============='
+  #     response = subject.getCpcPlanByCpcPlanId({:campaignIds=>[$campaign_id]})
+  #     response.status.should == 0
+  #     response.desc.should == 'success'
+  #     response.quota.should == 2
+  #     response.rquota.should > 0
+  #     expect{ApiResponse.verify(response.body)}.not_to raise_error
+  #   end
+  # end
+
+  describe '#getAllCpcPlan' do
+    it "getAllCpcPlan" do
+      response = subject.getAllCpcPlan({})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should > 0
+      response.rquota.should > 0
+      # expect{ApiResponse.verify(response.body)}.not_to raise_error
+    end
+  end
+end

data/spec/sem_creative_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+require 'uri'
+describe Sogou::SEM::CreativeService do
+  subject{Sogou::SEM::CreativeService.new($auth)}
+  let(:new_title){'新测试创意标题b'}
+  it '#addCpcIdea #updateCpcIdea #getCpcIdeaByCpcGrpId #deleteCreative' do
+    # ap subject.operations
+    # ap subject.example('deleteCpcIdea')
+    # pending
+    #addCpcIdea
+    creativeType = {
+      :cpcGrpId => $adgroup_id,
+      :title => '测试创意标题d',
+      :description1 => '测试创意首行测试创意首行测试创意首行',
+      :description2 => '测试创意次行测试创意次行测试创意次行',
+      :visitUrl => $pcDestinationUrl,
+      :showUrl=> URI($pcDestinationUrl).host,
+      :mobileVisitUrl => $mobileDestinationUrl,
+      :mobileShowUrl=> URI($mobileDestinationUrl).host
+    }
+    # {:creativeTypes=>[{
+    #   :creativeId=>"long",
+    #   :adgroupId=>"long",
+    #   :title=>"string",
+    #   :description1=>"string",
+    #   :description2=>"string",
+    #   :pcDestinationUrl=>"string",
+    #   :pcDisplayUrl=>"string",
+    #   :mobileDestinationUrl=>"string",
+    #   :mobileDisplayUrl=>"string",
+    #   :pause=>"boolean",
+    #   :status=>"int"}]
+    #   }
+    # }
+
+    # puts subject.example('addCpcIdea')
+    response = subject.addCpcIdea({:cpcIdeaTypes => [creativeType]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    # expect{ApiResponse.verify(response.body)}.not_to raise_error
+    creative_id = response.body[:cpc_idea_types][:cpc_idea_id]
+
+
+    # updateCpcIdea
+    sleep 3
+    creativeType = {
+      :cpcIdeaId=>creative_id,
+      :title => new_title,
+      :description1 => '艺龙酒店测试创意首行测试创意首行测试创意首行',
+      :description2 => '艺龙酒店测试创意首行测试创意首行测试创意次行',
+      :visitUrl => 'http://hotel.elong.com/beijing/'
+    }
+    response = subject.updateCpcIdea(:cpcIdeaTypes => [creativeType])
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    ap response.body
+    # expect{ApiResponse.verify(response.body)}.not_to raise_error
+
+    #getCpcIdeaByCpcGrpId
+    sleep 3
+    response = subject.getCpcIdeaByCpcGrpId(:cpcGrpIds => [creative_id])
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    ap response.body
+    response.body[:cpc_idea_types][:title].should == new_title
+    # expect{ApiResponse.verify(response.body)}.not_to raise_error
+
+    #deleteCpcIdea
+    response = subject.deleteCpcIdea({:cpcIdeaIds => [creative_id]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    # expect{ApiResponse.verify(response.body)}.not_to raise_error
+  end
+
+end

data/spec/sem_keyword_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+describe Sogou::SEM::KeywordService do
+  subject{Sogou::SEM::KeywordService.new($auth)}
+  let(:keyword_sample){'XJK测试关键词o'}
+  it "#addCpc #updateCpc #getCpcByCpcId #deleteCpc " do
+    # ap subject.example('updateCpc')
+# pending
+    #addCpc
+    # puts $adgroup_id
+    keywordType = {:cpcGrpId => $adgroup_id,:cpc=>keyword_sample,:matchType => 1,:price => 1}
+    response = subject.addCpc({:cpcTypes => [keywordType]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    keyword_id = response.body[:cpc_types][:cpc_id]
+
+    #updateCpc
+    keywordType = {:cpcId=> keyword_id,:price => 2}
+    response = subject.updateCpc({:cpcTypes=>[keywordType]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+
+    #getCpcByCpcId
+    sleep 3
+    response = subject.getCpcByCpcId({:cpcIds => [keyword_id]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    keyword = response.body[:cpc_types]
+    (keyword.is_a?Hash).should == true
+    keyword[:cpc_id].should == keyword_id
+    keyword[:cpc_grp_id].should == $adgroup_id
+    keyword[:cpc].should == keyword_sample
+    keyword[:price].should == "2.0"
+
+    #deleteCpc
+    sleep 3
+    response = subject.deleteCpc({:cpcIds => [keyword_id]})
+    response.status.should == 0
+    response.desc.should == 'success'
+    response.quota.should == 1
+    response.rquota.should > 0
+    # response.body[:result].should == '1'
+  end
+end

data/spec/sem_report_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+describe Sogou::SEM::ReportService do
+  subject{Sogou::SEM::ReportService.new($auth)}
+    it 'should not raise error on #getReportId #getReportState #getReportPath series test' do
+      pending('Report type and report range do not match')
+      #getReportId
+      options = {
+        :performanceData => [Sogou::SEM::PerformanceData::IMPRESSION, Sogou::SEM::PerformanceData::CLICK, Sogou::SEM::PerformanceData::CPC],
+        :startDate => (Time.now - 2*24*3600).utc.iso8601,
+        :endDate => (Time.now - 24*3600).utc.iso8601,
+        :statIds => [$campaign_id],
+        :idOnly => true
+        # :levelOfDetails => Sogou::SEM::LevelOfDetails::CAMPAIGN,
+        # :reportType => Sogou::SEM::ReportType::CAMPAIGN,
+        # :statRange => Sogou::SEM::StatRange::CAMPAIGN
+      }
+
+      response = subject.getReportId({:reportRequestType => options},true)
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 2
+      response.rquota.should > 0
+
+      #parse report_id
+      report_id = response.body[:report_id]
+
+      #getReportState
+      try_count = 0
+      loop do
+        response = subject.getReportState({:reportId => report_id})
+        response.status.should == 0
+        response.desc.should == 'success'
+        response.quota.should == 2
+        response.rquota.should > 0
+        #verify is_generated status
+        is_generated = response.body[:is_generated]
+        break if is_generated == '3' or try_count > 10
+        sleep 1
+        try_count +=1
+      end
+
+
+      #getReportPath
+      response = subject.getReportPath({:reportId => report_id})
+      response.status.should == 0
+      response.desc.should == 'success'
+      response.quota.should == 2
+      response.rquota.should > 0
+
+    end
+
+    it "处理过期/无效id,应返回false" do
+      expect{subject.getReportState({:reportId=>'7da8438bc705c9e6e747959fafce91f2'}).body}.to raise_error
+      expect{subject.getReportState({:reportId=>'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}).body}.to raise_error
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,26 @@
+require 'Sogou'
+require 'time'
+#请根据自己实际情况填写
+$username = '' #用户名
+$password = '' #密码
+$token = '' #token
+$auth = Sogou::Auth.new
+$auth.username = $username
+$auth.password = $password
+$auth.token = $token
+$startDate = (Time.now - 24*3600).utc.iso8601
+$endDate = Time.now.utc.iso8601
+$pcDestinationUrl = 'http://www.elong.com/'
+$mobileDestinationUrl = 'http://www.elong.com/'
+
+
+cs = Sogou::SEM::CampaignService.new($auth)
+campaigns = cs.getAllCpcPlan
+campaign = campaigns.body[:cpc_plan_types].first
+$campaign_id = campaign[:cpc_plan_id]
+$campaign_name = campaign[:cpc_plan_name]
+
+ac = Sogou::SEM::AdgroupService.new($auth)
+
+adgroups = ac.getCpcGrpByCpcPlanId({:cpcPlanIds=>[$campaign_id]})
+$adgroup_id = adgroups.body[:cpc_plan_grps][:cpc_grp_types].first[:cpc_grp_id]

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: sogou
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- seoaqua
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: sogou web services
+email:
+- seoaqua@me.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/sogou.rb
+- lib/sogou/auth.rb
+- lib/sogou/ext.rb
+- lib/sogou/response.rb
+- lib/sogou/sem.rb
+- lib/sogou/sem/account.rb
+- lib/sogou/sem/adgroup.rb
+- lib/sogou/sem/base.rb
+- lib/sogou/sem/campaign.rb
+- lib/sogou/sem/creative.rb
+- lib/sogou/sem/enum.rb
+- lib/sogou/sem/keyword.rb
+- lib/sogou/sem/report.rb
+- lib/sogou/version.rb
+- sogou.gemspec
+- spec/sem_account_spec.rb
+- spec/sem_adgroup_spec.rb
+- spec/sem_campaign_spec.rb
+- spec/sem_creative_spec.rb
+- spec/sem_keyword_spec.rb
+- spec/sem_report_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/seoaqua/sogou
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.5
+signing_key: 
+specification_version: 4
+summary: sogou sem services
+test_files:
+- spec/sem_account_spec.rb
+- spec/sem_adgroup_spec.rb
+- spec/sem_campaign_spec.rb
+- spec/sem_creative_spec.rb
+- spec/sem_keyword_spec.rb
+- spec/sem_report_spec.rb
+- spec/spec_helper.rb