google-dfp-api 0.2.4 → 0.2.5

data/ChangeLog

@@ -1,3 +1,7 @@
+0.2.5:
+  - Added postal code targeting examples.
+  - Require google-ads-common 0.5.4 or later from now on.
+
 0.2.4:
   - Support for proxies.
   - Require google-ads-common 0.5.1 or later from now on.

data/README

@@ -189,7 +189,7 @@ or via configuration file (see example).
 External dependencies should be pulled automatically on gem install. Here is the
 list though:
 
-  - Google Ads Common library (google-ads-common-0.5.1);
+  - Google Ads Common library (google-ads-common-0.5.4);
   - Savon 'the heavy metal Ruby SOAP client' (savon-0.9.6).
 
 

data/Rakefile

@@ -47,7 +47,7 @@ spec = Gem::Specification.new do |s|
   s.test_files = tests
   s.has_rdoc = true
   s.extra_rdoc_files = docs
-  s.add_dependency('google-ads-common', '~> 0.5.1')
+  s.add_dependency('google-ads-common', '~> 0.5.4')
   s.add_dependency('savon', '= 0.9.6')
 end
 
@@ -70,7 +70,7 @@ task :generate do
   api_config = DfpApi::ApiConfig
   versions = api_config.versions()
   versions.each do |version|
-    code_path = "lib/%s/%s" % [api_config.api_path, version]
+    code_path = "lib/%s/%s" % [api_config.api_name.to_s.snakecase, version]
     wsdls = DfpApi::ApiConfig.get_wsdls(version)
     wsdls.each do |service_name, wsdl_url|
       logger.info("Processing %s at [%s]..." % [service_name, wsdl_url])

data/examples/v201103/creative_service/copy_image_creatives.rb

@@ -73,8 +73,6 @@ def copy_image_creatives()
       image_url = new_creative.delete(:image_url)
       new_creative[:image_byte_array] =
           Base64.encode64(AdsCommon::Http.get(image_url))
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      new_creative[:xsi_type] = 'ImageCreative'
       new_creative
     end
 

data/examples/v201103/creative_service/update_creatives.rb

@@ -56,8 +56,6 @@ def update_creatives()
     # Update each local creative object by changing its destination URL.
     creatives.each do |creative|
       creative[:destination_url] = 'http://news.google.com'
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      creative[:xsi_type] = 'ImageCreative'
     end
 
     # Update the creatives on the server.

data/examples/v201103/line_item_service/update_line_items.rb

@@ -67,7 +67,6 @@ def update_line_items()
         line_item[:delivery_rate_type] = 'AS_FAST_AS_POSSIBLE'
         new_line_items << line_item
       end
-      # TODO: We also have to specify xsi_types here, issue #10.
       new_line_items
     end
 

data/examples/v201104/creative_service/copy_image_creatives.rb

@@ -73,8 +73,6 @@ def copy_image_creatives()
       image_url = new_creative.delete(:image_url)
       new_creative[:image_byte_array] =
           Base64.encode64(AdsCommon::Http.get(image_url))
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      new_creative[:xsi_type] = 'ImageCreative'
       new_creative
     end
 

data/examples/v201104/creative_service/update_creatives.rb

@@ -56,8 +56,6 @@ def update_creatives()
     # Update each local creative object by changing its destination URL.
     creatives.each do |creative|
       creative[:destination_url] = 'http://news.google.com'
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      creative[:xsi_type] = 'ImageCreative'
     end
 
     # Update the creatives on the server.

data/examples/v201104/line_item_service/update_line_items.rb

@@ -67,7 +67,6 @@ def update_line_items()
         line_item[:delivery_rate_type] = 'AS_FAST_AS_POSSIBLE'
         new_line_items << line_item
       end
-      # TODO: We also have to specify xsi_types here, issue #10.
       new_line_items
     end
 

data/examples/v201107/creative_service/copy_image_creatives.rb

@@ -73,8 +73,6 @@ def copy_image_creatives()
       image_url = new_creative.delete(:image_url)
       new_creative[:image_byte_array] =
           Base64.encode64(AdsCommon::Http.get(image_url))
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      new_creative[:xsi_type] = 'ImageCreative'
       new_creative
     end
 

data/examples/v201107/creative_service/update_creatives.rb

@@ -56,8 +56,6 @@ def update_creatives()
     # Update each local creative object by changing its destination URL.
     creatives.each do |creative|
       creative[:destination_url] = 'http://news.google.com'
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      creative[:xsi_type] = 'ImageCreative'
     end
 
     # Update the creatives on the server.

data/examples/v201107/line_item_service/update_line_items.rb

@@ -67,7 +67,6 @@ def update_line_items()
         line_item[:delivery_rate_type] = 'AS_FAST_AS_POSSIBLE'
         new_line_items << line_item
       end
-      # TODO: We also have to specify xsi_types here, issue #10.
       new_line_items
     end
 

data/examples/v201108/creative_service/copy_image_creatives.rb

@@ -73,8 +73,6 @@ def copy_image_creatives()
       image_url = new_creative.delete(:image_url)
       new_creative[:image_byte_array] =
           Base64.encode64(AdsCommon::Http.get(image_url))
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      new_creative[:xsi_type] = 'ImageCreative'
       new_creative
     end
 

data/examples/v201108/creative_service/update_creatives.rb

@@ -56,8 +56,6 @@ def update_creatives()
     # Update each local creative object by changing its destination URL.
     creatives.each do |creative|
       creative[:destination_url] = 'http://news.google.com'
-      # Savon doesn't get us xsi_type back yet so we have to specify it.
-      creative[:xsi_type] = 'ImageCreative'
     end
 
     # Update the creatives on the server.

data/examples/v201108/line_item_service/create_line_items.rb

@@ -56,10 +56,17 @@ def create_line_items()
 
   # Create geographical targeting.
   geo_targeting = {
-      # Include the US and Quebec, Canada.
-      :targeted_locations => [{:id => 2840}, {:id => 20123}],
-      # Exclude Chicago and the New York metro area.
-      :excluded_locations => [{:id => 1016367}, {:id => 200501}]
+      # Include targets.
+      :targeted_locations => [
+          {:id => 2840},    # USA.
+          {:id => 20123},   # Quebec, Canada.
+          {:id => 9000093}  # Postal code B3P (Canada).
+      ],
+      # Exclude targets.
+      :excluded_locations => [
+          {:id => 1016367}, # Chicago.
+          {:id => 200501}   # New York.
+      ]
   }
 
   # Create user domain targeting. Exclude domains that are not under the
@@ -100,7 +107,7 @@ def create_line_items()
 
   # Create an array to store local line item objects.
   line_items = (1..ITEM_COUNT).map do |index|
-    line_item = {:name => "Line item #%d" % index,
+    line_item = {:name => "Line item #%d-%d" % [Time.new.to_f * 1000, index],
                  :order_id => order_id,
                  :targeting => targeting,
                  :line_item_type => 'STANDARD',

data/examples/v201108/line_item_service/update_line_items.rb

@@ -67,7 +67,6 @@ def update_line_items()
         line_item[:delivery_rate_type] = 'AS_FAST_AS_POSSIBLE'
         new_line_items << line_item
       end
-      # TODO: We also have to specify xsi_types here, issue #10.
       new_line_items
     end
 

data/examples/v201108/publisher_query_language_service/get_all_postal_codes.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/ruby
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
+#
+# License:: Licensed under the Apache License, Version 2.0 (the "License");
+#           you may not use this file except in compliance with the License.
+#           You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#           Unless required by applicable law or agreed to in writing, software
+#           distributed under the License is distributed on an "AS IS" BASIS,
+#           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+#           implied.
+#           See the License for the specific language governing permissions and
+#           limitations under the License.
+#
+# This example gets all targetable postal codes.
+#
+# Tags: PublisherQueryLanguageService.select
+
+require 'rubygems'
+require 'dfp_api'
+
+API_VERSION = :v201108
+# A string to separate columns in output. Use "," to get CSV.
+COLUMN_SEPARATOR = "\t"
+
+def get_all_postal_codes()
+  # Get DfpApi instance and load configuration from ~/dfp_api.yml.
+  dfp = DfpApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # dfp.logger = Logger.new('dfp_xml.log')
+
+  # Get the PublisherQueryLanguageService.
+  pql_service = dfp.service(:PublisherQueryLanguageService, API_VERSION)
+
+  # Create statement to select all postal codes.
+  statement = {:query => 'SELECT * FROM Postal_Code WHERE targetable = true'}
+
+  # Get all postal codes.
+  result_set = pql_service.select(statement)
+
+  if result_set
+    # Print out columns header.
+    columns = result_set[:column_types].collect {|col| col[:label_name]}
+    puts columns.join(COLUMN_SEPARATOR)
+
+    # Print out every row.
+    result_set[:rows].each do |row_set|
+        row = row_set[:values].collect {|item| item[:value]}
+        puts row.join(COLUMN_SEPARATOR)
+    end
+  end
+
+  # Print a footer.
+  if result_set[:rows]
+    puts "Total number of rows found: %d" % result_set[:rows].size
+  end
+end
+
+if __FILE__ == $0
+  begin
+    get_all_postal_codes()
+
+  # HTTP errors.
+  rescue AdsCommon::Errors::HttpError => e
+    puts "HTTP Error: %s" % e
+
+  # API errors.
+  rescue DfpApi::Errors::ApiException => e
+    puts "Message: %s" % e.message
+    puts 'Errors:'
+    e.errors.each_with_index do |error, index|
+      puts "\tError [%d]:" % (index + 1)
+      error.each do |field, value|
+        puts "\t\t%s: %s" % [field, value]
+      end
+    end
+  end
+end

data/lib/dfp_api.rb

@@ -20,7 +20,7 @@
 # Contains the main classes for the client library. Takes care of all
 # dependencies.
 
-gem 'google-ads-common', '~>0.5.1'
+gem 'google-ads-common', '~>0.5.4'
 
 require 'ads_common/api'
 require 'ads_common/savon_service'

data/lib/dfp_api/api_config.rb

@@ -40,8 +40,7 @@ module DfpApi
 
     # Set other constants
     API_NAME = 'DfpApi'
-    API_PATH = 'dfp_api'
-    CLIENT_LIB_VERSION = '0.2.4'
+    CLIENT_LIB_VERSION = '0.2.5'
     DEFAULT_CONFIG_FILENAME = 'dfp_api.yml'
 
     # Configure the services available to each version
@@ -103,16 +102,6 @@ module DfpApi
 
     public
 
-    def self.do_require(version, service)
-      service_name = service.to_s.snakecase()
-      filename = "%s/%s/%s" % [api_path, version, service_name]
-      require filename
-    end
-
-    def self.interface_name(version, service)
-      return module_name(version, service) + "::" + service.to_s
-    end
-
     # Getters for constants and module variables.
     def self.default_version
       DEFAULT_VERSION
@@ -130,10 +119,6 @@ module DfpApi
       API_NAME
     end
 
-    def self.api_path
-      API_PATH
-    end
-
     def self.service_config
       @@service_config
     end

data/lib/dfp_api/v201103/company_service.rb

@@ -3,7 +3,7 @@
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 # License:: Licensed under the Apache License,Version 2.0 (the "License").
 #
-# Code generated by AdsCommon library 0.5.0 on 2011-08-02 15:34:05.
+# Code generated by AdsCommon library 0.5.3 on 2011-10-24 17:30:27.
 
 require 'ads_common/savon_service'
 require 'dfp_api/v201103/company_service_registry'
@@ -15,28 +15,28 @@ module DfpApi; module V201103; module CompanyService
       super(api, endpoint, namespace, :v201103)
     end
 
-    def update_companies(*args)
-      return execute_action('update_companies', args)
+    def update_company(*args, &block)
+      return execute_action('update_company', args, &block)
     end
 
-    def update_company(*args)
-      return execute_action('update_company', args)
+    def create_companies(*args, &block)
+      return execute_action('create_companies', args, &block)
     end
 
-    def create_companies(*args)
-      return execute_action('create_companies', args)
+    def create_company(*args, &block)
+      return execute_action('create_company', args, &block)
     end
 
-    def create_company(*args)
-      return execute_action('create_company', args)
+    def get_companies_by_statement(*args, &block)
+      return execute_action('get_companies_by_statement', args, &block)
     end
 
-    def get_companies_by_statement(*args)
-      return execute_action('get_companies_by_statement', args)
+    def get_company(*args, &block)
+      return execute_action('get_company', args, &block)
     end
 
-    def get_company(*args)
-      return execute_action('get_company', args)
+    def update_companies(*args, &block)
+      return execute_action('update_companies', args, &block)
     end
 
     private

data/lib/dfp_api/v201103/company_service_registry.rb

@@ -3,12 +3,14 @@
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 # License:: Licensed under the Apache License,Version 2.0 (the "License").
 #
-# Code generated by AdsCommon library 0.5.0 on 2011-08-02 15:34:05.
+# Code generated by AdsCommon library 0.5.3 on 2011-10-24 17:30:27.
+
+require 'dfp_api/errors'
 
 module DfpApi; module V201103; module CompanyService
   class CompanyServiceRegistry
-    COMPANYSERVICE_METHODS = {:update_companies=>{:input=>[{:type=>"Company", :min_occurs=>0, :name=>:companies, :max_occurs=>:unbounded}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :name=>:rval, :max_occurs=>:unbounded}], :name=>"update_companies_response"}}, :update_company=>{:input=>[{:type=>"Company", :min_occurs=>0, :name=>:company, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"update_company_response"}}, :create_companies=>{:input=>[{:type=>"Company", :min_occurs=>0, :name=>:companies, :max_occurs=>:unbounded}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :name=>:rval, :max_occurs=>:unbounded}], :name=>"create_companies_response"}}, :create_company=>{:input=>[{:type=>"Company", :min_occurs=>0, :name=>:company, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"create_company_response"}}, :get_companies_by_statement=>{:input=>[{:type=>"Statement", :min_occurs=>0, :name=>:filter_statement, :max_occurs=>1}], :output=>{:fields=>[{:type=>"CompanyPage", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"get_companies_by_statement_response"}}, :get_company=>{:input=>[{:type=>"long", :min_occurs=>0, :name=>:company_id, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"get_company_response"}}}
-    COMPANYSERVICE_TYPES = {:Statement=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:query, :max_occurs=>1}, {:type=>"String_ValueMapEntry", :min_occurs=>0, :name=>:values, :max_occurs=>:unbounded}]}, :Company=>{:fields=>[{:type=>"long", :min_occurs=>0, :name=>:id, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:name, :max_occurs=>1}, {:type=>"Company.Type", :min_occurs=>0, :name=>:type, :max_occurs=>1}]}, :OAuth=>{:base=>"Authentication", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:parameters, :max_occurs=>1}]}, :String_ValueMapEntry=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:key, :max_occurs=>1}, {:type=>"Value", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :CompanyPage=>{:fields=>[{:type=>"int", :min_occurs=>0, :name=>:total_result_set_size, :max_occurs=>1}, {:type=>"int", :min_occurs=>0, :name=>:start_index, :max_occurs=>1}, {:type=>"Company", :min_occurs=>0, :name=>:results, :max_occurs=>:unbounded}]}, :NumberValue=>{:base=>"Value", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :Authentication=>{:abstract=>true, :fields=>[{:type=>"string", :min_occurs=>0, :name=>:authentication_type, :max_occurs=>1}]}, :Value=>{:abstract=>true, :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value_type, :max_occurs=>1}]}, :SoapRequestHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:network_code, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:application_name, :max_occurs=>1}, {:type=>"Authentication", :min_occurs=>0, :name=>:authentication, :max_occurs=>1}]}, :ClientLogin=>{:base=>"Authentication", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:token, :max_occurs=>1}]}, :BooleanValue=>{:base=>"Value", :fields=>[{:type=>"boolean", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :TextValue=>{:base=>"Value", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :SoapResponseHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:request_id, :max_occurs=>1}, {:type=>"long", :min_occurs=>0, :name=>:response_time, :max_occurs=>1}]}}
+    COMPANYSERVICE_METHODS = {:update_company=>{:input=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>1, :name=>:company}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"update_company_response"}}, :create_companies=>{:input=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:companies}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:rval}], :name=>"create_companies_response"}}, :create_company=>{:input=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>1, :name=>:company}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"create_company_response"}}, :get_companies_by_statement=>{:input=>[{:type=>"Statement", :min_occurs=>0, :max_occurs=>1, :name=>:filter_statement}], :output=>{:fields=>[{:type=>"CompanyPage", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"get_companies_by_statement_response"}}, :get_company=>{:input=>[{:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:company_id}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"get_company_response"}}, :update_companies=>{:input=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:companies}], :output=>{:fields=>[{:type=>"Company", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:rval}], :name=>"update_companies_response"}}}
+    COMPANYSERVICE_TYPES = {:ClientLogin=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:token}], :base=>"Authentication"}, :String_ValueMapEntry=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:key}, {:type=>"Value", :min_occurs=>0, :max_occurs=>1, :name=>:value}]}, :Value=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value_type}], :abstract=>true}, :SoapRequestHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:network_code}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:application_name}, {:type=>"Authentication", :min_occurs=>0, :max_occurs=>1, :name=>:authentication}]}, :Company=>{:fields=>[{:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:id}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:name}, {:type=>"Company.Type", :min_occurs=>0, :max_occurs=>1, :name=>:type}]}, :Authentication=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:authentication_type}], :abstract=>true}, :SoapResponseHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:request_id}, {:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:response_time}]}, :TextValue=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}, :CompanyPage=>{:fields=>[{:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:total_result_set_size}, {:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:start_index}, {:type=>"Company", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:results}]}, :BooleanValue=>{:fields=>[{:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}, :Statement=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:query}, {:type=>"String_ValueMapEntry", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:values}]}, :OAuth=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:parameters}], :base=>"Authentication"}, :NumberValue=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}}
     COMPANYSERVICE_NAMESPACES = []
 
     def self.get_method_signature(method_name)

data/lib/dfp_api/v201103/creative_service.rb

@@ -3,7 +3,7 @@
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 # License:: Licensed under the Apache License,Version 2.0 (the "License").
 #
-# Code generated by AdsCommon library 0.5.0 on 2011-08-02 15:34:30.
+# Code generated by AdsCommon library 0.5.3 on 2011-10-24 17:31:02.
 
 require 'ads_common/savon_service'
 require 'dfp_api/v201103/creative_service_registry'
@@ -15,28 +15,28 @@ module DfpApi; module V201103; module CreativeService
       super(api, endpoint, namespace, :v201103)
     end
 
-    def update_creatives(*args)
-      return execute_action('update_creatives', args)
+    def get_creative(*args, &block)
+      return execute_action('get_creative', args, &block)
     end
 
-    def create_creative(*args)
-      return execute_action('create_creative', args)
+    def get_creatives_by_statement(*args, &block)
+      return execute_action('get_creatives_by_statement', args, &block)
     end
 
-    def create_creatives(*args)
-      return execute_action('create_creatives', args)
+    def update_creative(*args, &block)
+      return execute_action('update_creative', args, &block)
     end
 
-    def get_creative(*args)
-      return execute_action('get_creative', args)
+    def update_creatives(*args, &block)
+      return execute_action('update_creatives', args, &block)
     end
 
-    def get_creatives_by_statement(*args)
-      return execute_action('get_creatives_by_statement', args)
+    def create_creative(*args, &block)
+      return execute_action('create_creative', args, &block)
     end
 
-    def update_creative(*args)
-      return execute_action('update_creative', args)
+    def create_creatives(*args, &block)
+      return execute_action('create_creatives', args, &block)
     end
 
     private

data/lib/dfp_api/v201103/creative_service_registry.rb

@@ -3,12 +3,14 @@
 # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
 # License:: Licensed under the Apache License,Version 2.0 (the "License").
 #
-# Code generated by AdsCommon library 0.5.0 on 2011-08-02 15:34:30.
+# Code generated by AdsCommon library 0.5.3 on 2011-10-24 17:31:02.
+
+require 'dfp_api/errors'
 
 module DfpApi; module V201103; module CreativeService
   class CreativeServiceRegistry
-    CREATIVESERVICE_METHODS = {:update_creatives=>{:input=>[{:type=>"Creative", :min_occurs=>0, :name=>:creatives, :max_occurs=>:unbounded}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :name=>:rval, :max_occurs=>:unbounded}], :name=>"update_creatives_response"}}, :create_creative=>{:input=>[{:type=>"Creative", :min_occurs=>0, :name=>:creative, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"create_creative_response"}}, :create_creatives=>{:input=>[{:type=>"Creative", :min_occurs=>0, :name=>:creatives, :max_occurs=>:unbounded}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :name=>:rval, :max_occurs=>:unbounded}], :name=>"create_creatives_response"}}, :get_creative=>{:input=>[{:type=>"long", :min_occurs=>0, :name=>:creative_id, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"get_creative_response"}}, :get_creatives_by_statement=>{:input=>[{:type=>"Statement", :min_occurs=>0, :name=>:filter_statement, :max_occurs=>1}], :output=>{:fields=>[{:type=>"CreativePage", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"get_creatives_by_statement_response"}}, :update_creative=>{:input=>[{:type=>"Creative", :min_occurs=>0, :name=>:creative, :max_occurs=>1}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :name=>:rval, :max_occurs=>1}], :name=>"update_creative_response"}}}
-    CREATIVESERVICE_TYPES = {:Size=>{:fields=>[{:type=>"int", :min_occurs=>0, :name=>:width, :max_occurs=>1}, {:type=>"int", :min_occurs=>0, :name=>:height, :max_occurs=>1}, {:type=>"boolean", :min_occurs=>0, :name=>:is_aspect_ratio, :max_occurs=>1}]}, :FlashRedirectCreative=>{:base=>"BaseFlashRedirectCreative", :fields=>[]}, :Statement=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:query, :max_occurs=>1}, {:type=>"String_ValueMapEntry", :min_occurs=>0, :name=>:values, :max_occurs=>:unbounded}]}, :BaseImageCreative=>{:abstract=>true, :base=>"HasDestinationUrlCreative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:image_name, :max_occurs=>1}, {:type=>"base64Binary", :min_occurs=>0, :name=>:image_byte_array, :max_occurs=>1}, {:type=>"boolean", :min_occurs=>0, :name=>:override_size, :max_occurs=>1}, {:type=>"Size", :min_occurs=>0, :name=>:asset_size, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:image_url, :max_occurs=>1}]}, :OAuth=>{:base=>"Authentication", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:parameters, :max_occurs=>1}]}, :HasDestinationUrlCreative=>{:abstract=>true, :base=>"Creative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:destination_url, :max_occurs=>1}]}, :String_ValueMapEntry=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:key, :max_occurs=>1}, {:type=>"Value", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :NumberValue=>{:base=>"Value", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :BaseImageRedirectCreative=>{:abstract=>true, :base=>"HasDestinationUrlCreative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:image_url, :max_occurs=>1}]}, :ImageCreative=>{:base=>"BaseImageCreative", :fields=>[]}, :Creative=>{:abstract=>true, :fields=>[{:type=>"long", :min_occurs=>0, :name=>:advertiser_id, :max_occurs=>1}, {:type=>"long", :min_occurs=>0, :name=>:id, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:name, :max_occurs=>1}, {:type=>"Size", :min_occurs=>0, :name=>:size, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:preview_url, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:creative_type, :max_occurs=>1}]}, :Value=>{:abstract=>true, :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value_type, :max_occurs=>1}]}, :ImageRedirectCreative=>{:base=>"BaseImageRedirectCreative", :fields=>[]}, :Authentication=>{:abstract=>true, :fields=>[{:type=>"string", :min_occurs=>0, :name=>:authentication_type, :max_occurs=>1}]}, :CreativePage=>{:fields=>[{:type=>"int", :min_occurs=>0, :name=>:total_result_set_size, :max_occurs=>1}, {:type=>"int", :min_occurs=>0, :name=>:start_index, :max_occurs=>1}, {:type=>"Creative", :min_occurs=>0, :name=>:results, :max_occurs=>:unbounded}]}, :ThirdPartyCreative=>{:base=>"Creative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:snippet, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:expanded_snippet, :max_occurs=>1}]}, :SoapRequestHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:network_code, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:application_name, :max_occurs=>1}, {:type=>"Authentication", :min_occurs=>0, :name=>:authentication, :max_occurs=>1}]}, :ClientLogin=>{:base=>"Authentication", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:token, :max_occurs=>1}]}, :BooleanValue=>{:base=>"Value", :fields=>[{:type=>"boolean", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :BaseFlashCreative=>{:abstract=>true, :base=>"HasDestinationUrlCreative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:flash_name, :max_occurs=>1}, {:type=>"base64Binary", :min_occurs=>0, :name=>:flash_byte_array, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:fallback_image_name, :max_occurs=>1}, {:type=>"base64Binary", :min_occurs=>0, :name=>:fallback_image_byte_array, :max_occurs=>1}, {:type=>"boolean", :min_occurs=>0, :name=>:override_size, :max_occurs=>1}, {:type=>"boolean", :min_occurs=>0, :name=>:click_tag_required, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:fallback_preview_url, :max_occurs=>1}, {:type=>"Size", :min_occurs=>0, :name=>:flash_asset_size, :max_occurs=>1}, {:type=>"Size", :min_occurs=>0, :name=>:fallback_asset_size, :max_occurs=>1}]}, :TextValue=>{:base=>"Value", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:value, :max_occurs=>1}]}, :FlashCreative=>{:base=>"BaseFlashCreative", :fields=>[]}, :SoapResponseHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :name=>:request_id, :max_occurs=>1}, {:type=>"long", :min_occurs=>0, :name=>:response_time, :max_occurs=>1}]}, :BaseFlashRedirectCreative=>{:abstract=>true, :base=>"HasDestinationUrlCreative", :fields=>[{:type=>"string", :min_occurs=>0, :name=>:flash_url, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:fallback_url, :max_occurs=>1}, {:type=>"string", :min_occurs=>0, :name=>:fallback_preview_url, :max_occurs=>1}]}}
+    CREATIVESERVICE_METHODS = {:get_creative=>{:input=>[{:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:creative_id}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"get_creative_response"}}, :get_creatives_by_statement=>{:input=>[{:type=>"Statement", :min_occurs=>0, :max_occurs=>1, :name=>:filter_statement}], :output=>{:fields=>[{:type=>"CreativePage", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"get_creatives_by_statement_response"}}, :update_creative=>{:input=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>1, :name=>:creative}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"update_creative_response"}}, :update_creatives=>{:input=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:creatives}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:rval}], :name=>"update_creatives_response"}}, :create_creative=>{:input=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>1, :name=>:creative}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>1, :name=>:rval}], :name=>"create_creative_response"}}, :create_creatives=>{:input=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:creatives}], :output=>{:fields=>[{:type=>"Creative", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:rval}], :name=>"create_creatives_response"}}}
+    CREATIVESERVICE_TYPES = {:ThirdPartyCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:snippet}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:expanded_snippet}], :base=>"Creative"}, :ClientLogin=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:token}], :base=>"Authentication"}, :String_ValueMapEntry=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:key}, {:type=>"Value", :min_occurs=>0, :max_occurs=>1, :name=>:value}]}, :FlashRedirectCreative=>{:fields=>[], :base=>"BaseFlashRedirectCreative"}, :HasDestinationUrlCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:destination_url}], :abstract=>true, :base=>"Creative"}, :BaseFlashCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:flash_name}, {:type=>"base64Binary", :min_occurs=>0, :max_occurs=>1, :name=>:flash_byte_array}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_image_name}, {:type=>"base64Binary", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_image_byte_array}, {:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:override_size}, {:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:click_tag_required}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_preview_url}, {:type=>"Size", :min_occurs=>0, :max_occurs=>1, :name=>:flash_asset_size}, {:type=>"Size", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_asset_size}], :abstract=>true, :base=>"HasDestinationUrlCreative"}, :Creative=>{:fields=>[{:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:advertiser_id}, {:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:id}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:name}, {:type=>"Size", :min_occurs=>0, :max_occurs=>1, :name=>:size}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:preview_url}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:creative_type}], :abstract=>true}, :Value=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value_type}], :abstract=>true}, :ImageCreative=>{:fields=>[], :base=>"BaseImageCreative"}, :BaseFlashRedirectCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:flash_url}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_url}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:fallback_preview_url}], :abstract=>true, :base=>"HasDestinationUrlCreative"}, :SoapRequestHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:network_code}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:application_name}, {:type=>"Authentication", :min_occurs=>0, :max_occurs=>1, :name=>:authentication}]}, :CreativePage=>{:fields=>[{:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:total_result_set_size}, {:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:start_index}, {:type=>"Creative", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:results}]}, :ImageRedirectCreative=>{:fields=>[], :base=>"BaseImageRedirectCreative"}, :BaseImageCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:image_name}, {:type=>"base64Binary", :min_occurs=>0, :max_occurs=>1, :name=>:image_byte_array}, {:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:override_size}, {:type=>"Size", :min_occurs=>0, :max_occurs=>1, :name=>:asset_size}, {:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:image_url}], :abstract=>true, :base=>"HasDestinationUrlCreative"}, :Authentication=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:authentication_type}], :abstract=>true}, :SoapResponseHeader=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:request_id}, {:type=>"long", :min_occurs=>0, :max_occurs=>1, :name=>:response_time}]}, :Size=>{:fields=>[{:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:width}, {:type=>"int", :min_occurs=>0, :max_occurs=>1, :name=>:height}, {:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:is_aspect_ratio}]}, :TextValue=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}, :BooleanValue=>{:fields=>[{:type=>"boolean", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}, :BaseImageRedirectCreative=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:image_url}], :abstract=>true, :base=>"HasDestinationUrlCreative"}, :Statement=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:query}, {:type=>"String_ValueMapEntry", :min_occurs=>0, :max_occurs=>:unbounded, :name=>:values}]}, :OAuth=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:parameters}], :base=>"Authentication"}, :NumberValue=>{:fields=>[{:type=>"string", :min_occurs=>0, :max_occurs=>1, :name=>:value}], :base=>"Value"}, :FlashCreative=>{:fields=>[], :base=>"BaseFlashCreative"}}
     CREATIVESERVICE_NAMESPACES = []
 
     def self.get_method_signature(method_name)