google-adwords-api 0.9.0 → 0.9.1

data/ChangeLog

@@ -1,3 +1,6 @@
+0.9.1:
+  - Support and examples for AdGroupBidModifierService.
+
 0.9.0:
   - Shared set support and examples (beta feature).
   - Updated feed services auto-generated code.

data/examples/v201302/advanced_operations/add_ad_group_bid_modifier.rb

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2013, 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 illustrates how to add an ad group level mobile bid modifier
+# override for a campaign.
+#
+# Tags: AdGroupBidModifierService.mutate
+
+require 'adwords_api'
+
+def add_ad_group_bid_modifier(ad_group_id, bid_modifier)
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
+  bid_modifier_srv = adwords.service(:AdGroupBidModifierService, API_VERSION)
+
+  # Mobile criterion ID.
+  criterion_id = 30001
+
+  # Prepare to add an ad group level override.
+  operation = {
+    # Use 'ADD' to add a new modifier and 'SET' to update an existing one. A
+    # modifier can be removed with the 'REMOVE' operator.
+    :operator => 'ADD',
+    :operand => {
+      :ad_group_id => adgroup_id,
+      :criterion => {
+        :xsi_type => 'Platform',
+        :id => criterion_id
+      },
+      :bid_modifier => bid_modifier
+    }
+  }
+
+  # Add ad group level mobile bid modifier.
+  response = bid_modifier_srv.mutate([operation])
+  if response and response[:value]
+    modifier = response[:value].first
+    value = modifier[:bid_modifier] || 'unset'
+    puts ('Campaign ID %d, AdGroup ID %d, Criterion ID %d was updated with ' +
+        'ad group level modifier: %s') %
+           [modifier[:campaign_id], modifier[:ad_group_id],
+            modifier[:criterion][:id], value]
+  else
+    puts 'No modifiers were added.'
+  end
+end
+
+if __FILE__ == $0
+  API_VERSION = :v201302
+
+  begin
+    # ID of an ad group to add an override for.
+    ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
+    # Bid modifier to override with.
+    bid_modifier = 1.5
+
+    add_ad_group_bid_modifier(ad_group_id, bid_modifier)
+
+  # HTTP errors.
+  rescue AdsCommon::Errors::HttpError => e
+    puts "HTTP Error: %s" % e
+
+  # API errors.
+  rescue AdwordsApi::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/examples/v201302/advanced_operations/get_ad_group_bid_modifiers.rb

@@ -0,0 +1,98 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2013, 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 illustrates how to retrieve ad group level bid modifiers for a
+# campaign.
+#
+# Tags: AdGroupBidModifierService.get
+
+require 'adwords_api'
+
+def get_ad_group_bid_modifiers(campaign_id)
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
+  bid_modifier_srv = adwords.service(:AdGroupBidModifierService, API_VERSION)
+
+  # Get all ad group bid modifiers for the campaign.
+  selector = {
+    :fields => ['CampaignId', 'AdGroupId', 'Id', 'BidModifier'],
+    :predicates => [
+      {:field => 'CampaignId', :operator => 'EQUALS', :values => [campaign_id]}
+    ],
+    :paging => {
+      :start_index => 0,
+      :number_results => PAGE_SIZE
+    }
+  }
+
+  # Set initial values.
+  offset, page = 0, {}
+
+  begin
+    page = bid_modifier_srv.get(selector)
+    if page[:entries]
+      page[:entries].each do |modifier|
+        value = modifier[:bid_modifier] || 'unset'
+        puts ('Campaign ID %d, AdGroup ID %d, Criterion ID %d has ad group ' +
+           'level modifier: %s') %
+           [modifier[:campaign_id], modifier[:ad_group_id],
+            modifier[:criterion][:id], value]
+      end
+      # Increment values to request the next page.
+      offset += PAGE_SIZE
+      selector[:paging][:start_index] = offset
+    else
+      puts 'No ad group level bid overrides returned.'
+    end
+  end while page[:total_num_entries] > offset
+end
+
+if __FILE__ == $0
+  API_VERSION = :v201302
+  PAGE_SIZE = 500
+
+  begin
+    # ID of a campaign to pull overrides for.
+    campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
+
+    get_ad_group_bid_modifiers(campaign_id)
+
+  # HTTP errors.
+  rescue AdsCommon::Errors::HttpError => e
+    puts "HTTP Error: %s" % e
+
+  # API errors.
+  rescue AdwordsApi::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/examples/v201302/migration/upgrade_legacy_sitelinks.rb

@@ -0,0 +1,305 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2013, 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 migrates legacy sitelinks to upgraded sitelinks for a given list
+# of campaigns. The campaigns must be upgraded to enhanced campaigns before you
+# can run this example. To upgrade a campaign to enhanced, run
+# set_campaign_enhanced.rb. To get all campaigns, run get_campaigns.rb.
+#
+# Tags: CampaignAdExtensionService.get, CampaignAdExtensionService.mutate
+# Tags: FeedService.mutate, FeedItemService.mutate, FeedMappingService.mutate
+# Tags: CampaignFeedService.mutate
+
+require 'adwords_api'
+
+def upgrade_legacy_sitelinks(campaign_ids)
+  # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
+  # when called without parameters.
+  adwords = AdwordsApi::Api.new
+
+  # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
+  # the configuration file or provide your own logger:
+  # adwords.logger = Logger.new('adwords_xml.log')
+
+  # Obtain the required services.
+  campaign_ad_extension_srv =
+      adwords.service(:CampaignAdExtensionService, API_VERSION)
+  feed_mapping_srv = adwords.service(:FeedMappingService, API_VERSION)
+  feed_srv = adwords.service(:FeedService, API_VERSION)
+  feed_item_srv = adwords.service(:FeedItemService, API_VERSION)
+  campaign_feed_srv = adwords.service(:CampaignFeedService, API_VERSION)
+
+  # Try to retrieve an existing feed that has been mapped for use with
+  # sitelinks. If multiple such feeds exist, the first matching feed is
+  # retrieved. You could modify this code example to retrieve all the feeds
+  # and pick the appropriate feed based on user input.
+  site_links_feed = get_existing_feed(feed_mapping_srv)
+  if site_links_feed.nil?
+    # Create a feed for storing sitelinks.
+    site_links_feed = create_site_links_feed(feed_srv)
+    # Map the feed for using with sitelinks.
+    create_site_links_feed_mapping(feed_mapping_srv, site_links_feed)
+  end
+
+  campaign_ids.each do |campaign_id|
+    # Get legacy extensions for the campaign.
+    legacy_extensions = get_legacy_extensions_for_campaign(
+        campaign_ad_extension_srv, campaign_id)
+    legacy_extensions.each do |extension|
+      # Get the sitelinks.
+      legacy_site_links = extension[:ad_extension][:sitelinks]
+
+      # Add the sitelinks to the feed.
+      site_link_feed_item_ids = create_site_link_feed_items(feed_item_srv,
+                                                            site_links_feed,
+                                                            legacy_site_links)
+
+      # Associate feeditems to the campaign.
+      associate_sitelink_feed_items_with_campaign(campaign_feed_srv,
+                                                  site_links_feed,
+                                                  site_link_feed_item_ids,
+                                                  campaign_id)
+
+      # Once the upgraded sitelinks are added to a campaign, the legacy
+      # sitelinks will stop serving. You can delete the legacy sitelinks
+      # once you have verified that the migration went fine. In case the
+      # migration didn't succeed, you can roll back the migration by deleting
+      # the campaign feed you created in the previous step.
+      campaign_ad_extension_srv.mutate([
+          {:operator => 'REMOVE', :operand => extension}
+      ])
+    end
+  end
+end
+
+# Create a feed for holding upgraded sitelinks.
+def create_site_links_feed(feed_srv)
+  # Create the feed.
+  site_links_feed = {
+    :name => 'Feed For Sitelinks',
+    :attributes => [
+      {:type => 'STRING', :name => 'Link Text'},
+      {:type => 'URL', :name => 'Link URL'}
+    ],
+    :origin => 'USER'
+  }
+
+  # Add the feed.
+  response = feed_srv.mutate([
+      {:operator => 'ADD', :operand => site_links_feed}
+  ])
+
+  saved_feed = response[:value].first
+  return {
+    :site_links_feed_id => saved_feed[:id],
+    :saved_attributes => saved_feed[:attributes],
+    :link_text_feed_attribute_id => saved_feed[:attributes][0][:id],
+    :link_url_feed_attribute_id => saved_feed[:attributes][1][:id]
+  }
+end
+
+# Map the feed for use with Sitelinks.
+def create_site_links_feed_mapping(feed_mapping_srv, site_links_feed)
+  # Map the feedAttributeIds to the fieldId constants.
+  link_text_field_mapping = {
+    :feed_attribute_id => site_links_feed[:link_text_feed_attribute_id],
+    :field_id => PLACEHOLDER_FIELD_SITELINK_TEXT
+  }
+  link_url_field_mapping = {
+    :feed_attribute_id => site_links_feed[:link_url_feed_attribute_id],
+    :field_id => PLACEHOLDER_FIELD_SITELINK_URL
+  }
+
+  # Create the field mapping.
+  feed_mapping = {
+    :placeholder_type => PLACEHOLDER_SITELINKS,
+    :feed_id => site_links_feed[:site_links_feed_id],
+    :attribute_field_mappings =>
+        [link_text_field_mapping, link_url_field_mapping]
+  }
+
+  # Save the field mapping.
+  feed_mapping_srv.mutate([{:operator => 'ADD', :operand => feed_mapping}])
+end
+
+# Retrieves an existing feed that is mapped to hold sitelinks. The first active
+# sitelinks feed is retrieved by this method.
+def get_existing_feed(feed_mapping_srv)
+  selector = {
+    :fields => ['FeedId', 'FeedMappingId', 'PlaceholderType', 'Status',
+        'AttributeFieldMappings'],
+    :predicates => [
+      {
+        :field => 'PlaceholderType',
+        :operator => 'EQUALS',
+        :values => [PLACEHOLDER_SITELINKS]
+      },
+      {:field => 'Status', :operator => 'EQUALS', :values => ['ACTIVE']}
+    ]
+  }
+
+  response = feed_mapping_srv.get(selector)
+  if response and response[:entries]
+    response[:entries].each do |feed_mapping|
+      feed_id = feed_mapping[:feed_id]
+      text_attribute_id = nil
+      url_attribute_id = nil
+      feed_mapping[:attribute_field_mappings].each do |attribute_mapping|
+        case attribute_mapping[:field_id].to_i
+          when PLACEHOLDER_FIELD_SITELINK_TEXT
+            text_attribute_id = attribute_mapping[:feed_attribute_id]
+          when PLACEHOLDER_FIELD_SITELINK_URL
+            url_attribute_id = attribute_mapping[:feed_attribute_id]
+        end
+      end
+      unless feed_id.nil? or text_attribute_id.nil? or url_attribute_id.nil?
+        return {
+          :site_links_feed_id => feed_id,
+          :link_text_feed_attribute_id => text_attribute_id,
+          :link_url_feed_attribute_id => url_attribute_id
+        }
+      end
+    end
+  end
+  return nil
+end
+
+# Gets legacy sitelink extensions for a campaign.
+def get_legacy_extensions_for_campaign(campaign_ad_extension_srv, campaign_id)
+  # Create the selector.
+  selector = {
+    :fields => ['CampaignId', 'AdExtensionId',
+                'Status', 'DisplayText', 'DestinationUrl'],
+    :predicates => [
+      # Filter the results for specified campaign id.
+      {:field => 'CampaignId', :operator => 'EQUALS', :values => [campaign_id]},
+      # Filter the results for active campaign ad extensions. You may add
+      # additional filtering conditions here as required.
+      {:field => 'Status', :operator => 'EQUALS', :values => ['ACTIVE']},
+      {
+        :field => 'AdExtensionType',
+        :operator => 'EQUALS',
+        :values => ['SITELINKS_EXTENSION']
+      }
+    ]
+  }
+  response = campaign_ad_extension_srv.get(selector)
+  return (response and response[:entries]) ? response[:entries] : []
+end
+
+# Adds legacy sitelinks to the sitelinks feed.
+def create_site_link_feed_items(feed_item_srv, site_links_feed, site_links)
+  # Create operation for adding each legacy sitelink to the sitelinks feed.
+  feed_item_operations = site_links.map do |site_link|
+    {
+      :operator => 'ADD',
+      :operand => {
+        :feed_id => site_links_feed[:site_links_feed_id],
+        :attribute_values => [
+          {
+            :feed_attribute_id => site_links_feed[:link_text_feed_attribute_id],
+            :string_value => site_link[:display_text]
+          },
+          {
+            :feed_attribute_id => site_links_feed[:link_url_feed_attribute_id],
+            :string_value => site_link[:destination_url]
+          }
+        ]
+      }
+    }
+  end
+
+  response = feed_item_srv.mutate(feed_item_operations);
+  # Retrieve the feed item ids.
+  site_link_feed_item_ids = response[:value].map {|item| item[:feed_item_id]}
+  return site_link_feed_item_ids
+end
+
+# Associates sitelink feed items with a campaign.
+def associate_sitelink_feed_items_with_campaign(campaign_feed_srv,
+    site_links_feed, site_link_feed_item_ids, campaign_id)
+  # Create a custom matching function that matches the given feed items to the
+  # campaign.
+  request_context_operand = {
+    :xsi_type => 'RequestContextOperand',
+    :context_type => 'FEED_ITEM_ID'
+  }
+
+  operands = site_link_feed_item_ids.map do |feed_item_id|
+    {
+      :xsi_type => 'ConstantOperand',
+      :long_value => feed_item_id,
+      :type => 'LONG'
+    }
+  end
+
+  function = {
+    :operator => 'IN',
+    :lhs_operand => [request_context_operand],
+    :rhs_operand => operands
+  }
+
+  # Create upgraded sitelinks for the campaign. Use the sitelinks feed we
+  # created, and restrict feed items by matching function.
+  campaign_feed = {
+    :feed_id => site_links_feed[:site_links_feed_id],
+    :campaign_id => campaign_id,
+    :matching_function => function,
+    :placeholder_types => [PLACEHOLDER_SITELINKS]
+  }
+
+  campaign_feed_srv.mutate([{:operator => 'ADD', :operand => campaign_feed}])
+end
+
+if __FILE__ == $0
+  API_VERSION = :v201302
+
+  # See the Placeholder reference page for a list of all the placeholder types
+  # and fields, see:
+  #     https://developers.google.com/adwords/api/docs/appendix/placeholders
+  PLACEHOLDER_SITELINKS = 1
+  PLACEHOLDER_FIELD_SITELINK_TEXT = 1
+  PLACEHOLDER_FIELD_SITELINK_URL = 2
+
+  begin
+    # IDs of campaigns to add upgrade legacy sitelinks for.
+    campaign_ids = [
+      'INSERT_CAMPAIGN_ID_HERE'.to_i,
+      'INSERT_CAMPAIGN_ID_HERE'.to_i
+    ]
+
+    upgrade_legacy_sitelinks(campaign_ids)
+
+  # HTTP errors.
+  rescue AdsCommon::Errors::HttpError => e
+    puts "HTTP Error: %s" % e
+
+  # API errors.
+  rescue AdwordsApi::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/adwords_api/api_config.rb

@@ -48,6 +48,7 @@ module AdwordsApi
       :v201209 => [
           :AdExtensionOverrideService,
           :AdGroupAdService,
+          :AdGroupBidModifierService,
           :AdGroupCriterionService,
           :AdGroupService,
           :AdParamService,
@@ -84,6 +85,7 @@ module AdwordsApi
       :v201302 => [
           :AdExtensionOverrideService,
           :AdGroupAdService,
+          :AdGroupBidModifierService,
           :AdGroupCriterionService,
           :AdGroupFeedService,
           :AdGroupService,
@@ -135,6 +137,7 @@ module AdwordsApi
       # v201209
       [:v201209, :AdExtensionOverrideService] => 'cm/',
       [:v201209, :AdGroupAdService] => 'cm/',
+      [:v201209, :AdGroupBidModifierService] => 'cm/',
       [:v201209, :AdGroupCriterionService] => 'cm/',
       [:v201209, :AdGroupService] => 'cm/',
       [:v201209, :AdParamService] => 'cm/',
@@ -170,6 +173,7 @@ module AdwordsApi
       # v201302
       [:v201302, :AdExtensionOverrideService] => 'cm/',
       [:v201302, :AdGroupAdService] => 'cm/',
+      [:v201302, :AdGroupBidModifierService] => 'cm/',
       [:v201302, :AdGroupCriterionService] => 'cm/',
       [:v201302, :AdGroupFeedService] => 'cm/',
       [:v201302, :AdGroupService] => 'cm/',

data/lib/adwords_api/v201209/ad_group_bid_modifier_service.rb

@@ -0,0 +1,38 @@
+# Encoding: utf-8
+#
+# This is auto-generated code, changes will be overwritten.
+#
+# Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
+# License:: Licensed under the Apache License, Version 2.0.
+#
+# Code generated by AdsCommon library 0.9.3 on 2013-05-06 15:27:10.
+
+require 'ads_common/savon_service'
+require 'adwords_api/v201209/ad_group_bid_modifier_service_registry'
+
+module AdwordsApi; module V201209; module AdGroupBidModifierService
+  class AdGroupBidModifierService < AdsCommon::SavonService
+    def initialize(config, endpoint)
+      namespace = 'https://adwords.google.com/api/adwords/cm/v201209'
+      super(config, endpoint, namespace, :v201209)
+    end
+
+    def get(*args, &block)
+      return execute_action('get', args, &block)
+    end
+
+    def mutate(*args, &block)
+      return execute_action('mutate', args, &block)
+    end
+
+    private
+
+    def get_service_registry()
+      return AdGroupBidModifierServiceRegistry
+    end
+
+    def get_module()
+      return AdwordsApi::V201209::AdGroupBidModifierService
+    end
+  end
+end; end; end

data/lib/adwords_api/v201209/ad_group_bid_modifier_service_registry.rb

@@ -0,0 +1,46 @@
+# Encoding: utf-8
+#
+# This is auto-generated code, changes will be overwritten.
+#
+# Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
+# License:: Licensed under the Apache License, Version 2.0.
+#
+# Code generated by AdsCommon library 0.9.3 on 2013-05-06 15:27:10.
+
+require 'adwords_api/errors'
+
+module AdwordsApi; module V201209; module AdGroupBidModifierService
+  class AdGroupBidModifierServiceRegistry
+    ADGROUPBIDMODIFIERSERVICE_METHODS = {:get=>{:input=>[{:name=>:selector, :type=>"Selector", :min_occurs=>0, :max_occurs=>1}], :output=>{:name=>"get_response", :fields=>[{:name=>:rval, :type=>"AdGroupBidModifierPage", :min_occurs=>0, :max_occurs=>1}]}}, :mutate=>{:input=>[{:name=>:operations, :type=>"AdGroupBidModifierOperation", :min_occurs=>0, :max_occurs=>:unbounded}], :output=>{:name=>"mutate_response", :fields=>[{:name=>:rval, :type=>"AdGroupBidModifierReturnValue", :min_occurs=>0, :max_occurs=>1}]}}}
+    ADGROUPBIDMODIFIERSERVICE_TYPES = {:AuthenticationError=>{:fields=>[{:name=>:reason, :type=>"AuthenticationError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :AuthorizationError=>{:fields=>[{:name=>:reason, :type=>"AuthorizationError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :ClientTermsError=>{:fields=>[{:name=>:reason, :type=>"ClientTermsError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :CriterionError=>{:fields=>[{:name=>:reason, :type=>"CriterionError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :DateRange=>{:fields=>[{:name=>:min, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:max, :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :EntityNotFound=>{:fields=>[{:name=>:reason, :type=>"EntityNotFound.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :InternalApiError=>{:fields=>[{:name=>:reason, :type=>"InternalApiError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :NotWhitelistedError=>{:fields=>[{:name=>:reason, :type=>"NotWhitelistedError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :OperatorError=>{:fields=>[{:name=>:reason, :type=>"OperatorError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :OrderBy=>{:fields=>[{:name=>:field, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:sort_order, :type=>"SortOrder", :min_occurs=>0, :max_occurs=>1}]}, :Paging=>{:fields=>[{:name=>:start_index, :type=>"int", :min_occurs=>0, :max_occurs=>1}, {:name=>:number_results, :type=>"int", :min_occurs=>0, :max_occurs=>1}]}, :Platform=>{:fields=>[{:name=>:platform_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}], :base=>"Criterion"}, :Predicate=>{:fields=>[{:name=>:field, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:operator, :type=>"Predicate.Operator", :min_occurs=>0, :max_occurs=>1}, {:name=>:values, :type=>"string", :min_occurs=>0, :max_occurs=>:unbounded}]}, :QuotaCheckError=>{:fields=>[{:name=>:reason, :type=>"QuotaCheckError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RateExceededError=>{:fields=>[{:name=>:reason, :type=>"RateExceededError.Reason", :min_occurs=>0, :max_occurs=>1}, {:name=>:rate_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:rate_scope, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:retry_after_seconds, :type=>"int", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RequestError=>{:fields=>[{:name=>:reason, :type=>"RequestError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SelectorError=>{:fields=>[{:name=>:reason, :type=>"SelectorError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SizeLimitError=>{:fields=>[{:name=>:reason, :type=>"SizeLimitError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SoapHeader=>{:fields=>[{:name=>:auth_token, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:client_customer_id, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:developer_token, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:user_agent, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:validate_only, :type=>"boolean", :min_occurs=>0, :max_occurs=>1}, {:name=>:partial_failure, :type=>"boolean", :min_occurs=>0, :max_occurs=>1}]}, :SoapResponseHeader=>{:fields=>[{:name=>:request_id, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:service_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:method_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:operations, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:response_time, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:units, :type=>"long", :min_occurs=>0, :max_occurs=>1}]}, :DatabaseError=>{:fields=>[{:name=>:reason, :type=>"DatabaseError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :ApiError=>{:fields=>[{:name=>:field_path, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:trigger, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:error_string, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:api_error_type, :original_name=>"ApiError.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :ApiException=>{:fields=>[{:name=>:errors, :type=>"ApiError", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"ApplicationException"}, :ApplicationException=>{:fields=>[{:name=>:message, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:application_exception_type, :original_name=>"ApplicationException.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :Selector=>{:fields=>[{:name=>:fields, :type=>"string", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:predicates, :type=>"Predicate", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:date_range, :type=>"DateRange", :min_occurs=>0, :max_occurs=>1}, {:name=>:ordering, :type=>"OrderBy", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:paging, :type=>"Paging", :min_occurs=>0, :max_occurs=>1}]}, :Criterion=>{:fields=>[{:name=>:id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:type, :type=>"Criterion.Type", :min_occurs=>0, :max_occurs=>1}, {:name=>:criterion_type, :original_name=>"Criterion.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :AdGroupBidModifier=>{:fields=>[{:name=>:campaign_id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:ad_group_id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:criterion, :type=>"Criterion", :min_occurs=>0, :max_occurs=>1}, {:name=>:bid_modifier, :type=>"double", :min_occurs=>0, :max_occurs=>1}, {:name=>:bid_modifier_source, :type=>"BidModifierSource", :min_occurs=>0, :max_occurs=>1}]}, :AdGroupBidModifierOperation=>{:fields=>[{:name=>:operand, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>1}], :base=>"Operation"}, :AdGroupBidModifierPage=>{:fields=>[{:name=>:entries, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"Page"}, :AdGroupBidModifierReturnValue=>{:fields=>[{:name=>:value, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:partial_failure_errors, :type=>"ApiError", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"ListReturnValue"}, :ListReturnValue=>{:fields=>[{:name=>:list_return_value_type, :original_name=>"ListReturnValue.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :Operation=>{:fields=>[{:name=>:operator, :type=>"Operator", :min_occurs=>0, :max_occurs=>1}, {:name=>:operation_type, :original_name=>"Operation.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :Page=>{:fields=>[{:name=>:total_num_entries, :type=>"int", :min_occurs=>0, :max_occurs=>1}, {:name=>:page_type, :original_name=>"Page.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :"AuthenticationError.Reason"=>{:fields=>[]}, :"AuthorizationError.Reason"=>{:fields=>[]}, :BidModifierSource=>{:fields=>[]}, :"ClientTermsError.Reason"=>{:fields=>[]}, :"Criterion.Type"=>{:fields=>[]}, :"CriterionError.Reason"=>{:fields=>[]}, :"DatabaseError.Reason"=>{:fields=>[]}, :"EntityNotFound.Reason"=>{:fields=>[]}, :"InternalApiError.Reason"=>{:fields=>[]}, :"NotWhitelistedError.Reason"=>{:fields=>[]}, :Operator=>{:fields=>[]}, :"OperatorError.Reason"=>{:fields=>[]}, :"Predicate.Operator"=>{:fields=>[]}, :"QuotaCheckError.Reason"=>{:fields=>[]}, :"RateExceededError.Reason"=>{:fields=>[]}, :"RequestError.Reason"=>{:fields=>[]}, :"SelectorError.Reason"=>{:fields=>[]}, :"SizeLimitError.Reason"=>{:fields=>[]}, :SortOrder=>{:fields=>[]}}
+    ADGROUPBIDMODIFIERSERVICE_NAMESPACES = []
+
+    def self.get_method_signature(method_name)
+      return ADGROUPBIDMODIFIERSERVICE_METHODS[method_name.to_sym]
+    end
+
+    def self.get_type_signature(type_name)
+      return ADGROUPBIDMODIFIERSERVICE_TYPES[type_name.to_sym]
+    end
+
+    def self.get_namespace(index)
+      return ADGROUPBIDMODIFIERSERVICE_NAMESPACES[index]
+    end
+  end
+
+  # Base class for exceptions.
+  class ApplicationException < AdwordsApi::Errors::ApiException
+    attr_reader :message  # string
+    attr_reader :application_exception_type  # string
+  end
+
+  # Exception class for holding a list of service errors.
+  class ApiException < ApplicationException
+    attr_reader :errors  # ApiError
+    def initialize(exception_fault)
+      @array_fields ||= []
+      @array_fields << 'errors'
+      super(exception_fault, AdGroupBidModifierServiceRegistry)
+    end
+  end
+end; end; end

data/lib/adwords_api/v201302/ad_group_bid_modifier_service.rb

@@ -0,0 +1,38 @@
+# Encoding: utf-8
+#
+# This is auto-generated code, changes will be overwritten.
+#
+# Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
+# License:: Licensed under the Apache License, Version 2.0.
+#
+# Code generated by AdsCommon library 0.9.3 on 2013-05-06 15:27:50.
+
+require 'ads_common/savon_service'
+require 'adwords_api/v201302/ad_group_bid_modifier_service_registry'
+
+module AdwordsApi; module V201302; module AdGroupBidModifierService
+  class AdGroupBidModifierService < AdsCommon::SavonService
+    def initialize(config, endpoint)
+      namespace = 'https://adwords.google.com/api/adwords/cm/v201302'
+      super(config, endpoint, namespace, :v201302)
+    end
+
+    def get(*args, &block)
+      return execute_action('get', args, &block)
+    end
+
+    def mutate(*args, &block)
+      return execute_action('mutate', args, &block)
+    end
+
+    private
+
+    def get_service_registry()
+      return AdGroupBidModifierServiceRegistry
+    end
+
+    def get_module()
+      return AdwordsApi::V201302::AdGroupBidModifierService
+    end
+  end
+end; end; end

data/lib/adwords_api/v201302/ad_group_bid_modifier_service_registry.rb

@@ -0,0 +1,46 @@
+# Encoding: utf-8
+#
+# This is auto-generated code, changes will be overwritten.
+#
+# Copyright:: Copyright 2013, Google Inc. All Rights Reserved.
+# License:: Licensed under the Apache License, Version 2.0.
+#
+# Code generated by AdsCommon library 0.9.3 on 2013-05-06 15:27:50.
+
+require 'adwords_api/errors'
+
+module AdwordsApi; module V201302; module AdGroupBidModifierService
+  class AdGroupBidModifierServiceRegistry
+    ADGROUPBIDMODIFIERSERVICE_METHODS = {:get=>{:input=>[{:name=>:selector, :type=>"Selector", :min_occurs=>0, :max_occurs=>1}], :output=>{:name=>"get_response", :fields=>[{:name=>:rval, :type=>"AdGroupBidModifierPage", :min_occurs=>0, :max_occurs=>1}]}}, :mutate=>{:input=>[{:name=>:operations, :type=>"AdGroupBidModifierOperation", :min_occurs=>0, :max_occurs=>:unbounded}], :output=>{:name=>"mutate_response", :fields=>[{:name=>:rval, :type=>"AdGroupBidModifierReturnValue", :min_occurs=>0, :max_occurs=>1}]}}}
+    ADGROUPBIDMODIFIERSERVICE_TYPES = {:AuthenticationError=>{:fields=>[{:name=>:reason, :type=>"AuthenticationError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :AuthorizationError=>{:fields=>[{:name=>:reason, :type=>"AuthorizationError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :ClientTermsError=>{:fields=>[{:name=>:reason, :type=>"ClientTermsError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :CriterionError=>{:fields=>[{:name=>:reason, :type=>"CriterionError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :DateRange=>{:fields=>[{:name=>:min, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:max, :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :DistinctError=>{:fields=>[{:name=>:reason, :type=>"DistinctError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :EntityNotFound=>{:fields=>[{:name=>:reason, :type=>"EntityNotFound.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :IdError=>{:fields=>[{:name=>:reason, :type=>"IdError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :InternalApiError=>{:fields=>[{:name=>:reason, :type=>"InternalApiError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :NotWhitelistedError=>{:fields=>[{:name=>:reason, :type=>"NotWhitelistedError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :OperatorError=>{:fields=>[{:name=>:reason, :type=>"OperatorError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :OrderBy=>{:fields=>[{:name=>:field, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:sort_order, :type=>"SortOrder", :min_occurs=>0, :max_occurs=>1}]}, :Paging=>{:fields=>[{:name=>:start_index, :type=>"int", :min_occurs=>0, :max_occurs=>1}, {:name=>:number_results, :type=>"int", :min_occurs=>0, :max_occurs=>1}]}, :Platform=>{:fields=>[{:name=>:platform_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}], :base=>"Criterion"}, :Predicate=>{:fields=>[{:name=>:field, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:operator, :type=>"Predicate.Operator", :min_occurs=>0, :max_occurs=>1}, {:name=>:values, :type=>"string", :min_occurs=>0, :max_occurs=>:unbounded}]}, :QuotaCheckError=>{:fields=>[{:name=>:reason, :type=>"QuotaCheckError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RangeError=>{:fields=>[{:name=>:reason, :type=>"RangeError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RateExceededError=>{:fields=>[{:name=>:reason, :type=>"RateExceededError.Reason", :min_occurs=>0, :max_occurs=>1}, {:name=>:rate_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:rate_scope, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:retry_after_seconds, :type=>"int", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :ReadOnlyError=>{:fields=>[{:name=>:reason, :type=>"ReadOnlyError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RequestError=>{:fields=>[{:name=>:reason, :type=>"RequestError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :RequiredError=>{:fields=>[{:name=>:reason, :type=>"RequiredError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SelectorError=>{:fields=>[{:name=>:reason, :type=>"SelectorError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SizeLimitError=>{:fields=>[{:name=>:reason, :type=>"SizeLimitError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :SoapHeader=>{:fields=>[{:name=>:auth_token, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:client_customer_id, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:developer_token, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:user_agent, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:validate_only, :type=>"boolean", :min_occurs=>0, :max_occurs=>1}, {:name=>:partial_failure, :type=>"boolean", :min_occurs=>0, :max_occurs=>1}]}, :SoapResponseHeader=>{:fields=>[{:name=>:request_id, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:service_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:method_name, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:operations, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:response_time, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:units, :type=>"long", :min_occurs=>0, :max_occurs=>1}]}, :StringLengthError=>{:fields=>[{:name=>:reason, :type=>"StringLengthError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :DatabaseError=>{:fields=>[{:name=>:reason, :type=>"DatabaseError.Reason", :min_occurs=>0, :max_occurs=>1}], :base=>"ApiError"}, :ApiError=>{:fields=>[{:name=>:field_path, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:trigger, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:error_string, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:api_error_type, :original_name=>"ApiError.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :ApiException=>{:fields=>[{:name=>:errors, :type=>"ApiError", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"ApplicationException"}, :ApplicationException=>{:fields=>[{:name=>:message, :type=>"string", :min_occurs=>0, :max_occurs=>1}, {:name=>:application_exception_type, :original_name=>"ApplicationException.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :Selector=>{:fields=>[{:name=>:fields, :type=>"string", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:predicates, :type=>"Predicate", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:date_range, :type=>"DateRange", :min_occurs=>0, :max_occurs=>1}, {:name=>:ordering, :type=>"OrderBy", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:paging, :type=>"Paging", :min_occurs=>0, :max_occurs=>1}]}, :Criterion=>{:fields=>[{:name=>:id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:type, :type=>"Criterion.Type", :min_occurs=>0, :max_occurs=>1}, {:name=>:criterion_type, :original_name=>"Criterion.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}]}, :AdGroupBidModifier=>{:fields=>[{:name=>:campaign_id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:ad_group_id, :type=>"long", :min_occurs=>0, :max_occurs=>1}, {:name=>:criterion, :type=>"Criterion", :min_occurs=>0, :max_occurs=>1}, {:name=>:bid_modifier, :type=>"double", :min_occurs=>0, :max_occurs=>1}, {:name=>:bid_modifier_source, :type=>"BidModifierSource", :min_occurs=>0, :max_occurs=>1}]}, :AdGroupBidModifierOperation=>{:fields=>[{:name=>:operand, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>1}], :base=>"Operation"}, :AdGroupBidModifierPage=>{:fields=>[{:name=>:entries, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"Page"}, :AdGroupBidModifierReturnValue=>{:fields=>[{:name=>:value, :type=>"AdGroupBidModifier", :min_occurs=>0, :max_occurs=>:unbounded}, {:name=>:partial_failure_errors, :type=>"ApiError", :min_occurs=>0, :max_occurs=>:unbounded}], :base=>"ListReturnValue"}, :ListReturnValue=>{:fields=>[{:name=>:list_return_value_type, :original_name=>"ListReturnValue.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :Operation=>{:fields=>[{:name=>:operator, :type=>"Operator", :min_occurs=>0, :max_occurs=>1}, {:name=>:operation_type, :original_name=>"Operation.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :Page=>{:fields=>[{:name=>:total_num_entries, :type=>"int", :min_occurs=>0, :max_occurs=>1}, {:name=>:page_type, :original_name=>"Page.Type", :type=>"string", :min_occurs=>0, :max_occurs=>1}], :abstract=>true}, :"AuthenticationError.Reason"=>{:fields=>[]}, :"AuthorizationError.Reason"=>{:fields=>[]}, :BidModifierSource=>{:fields=>[]}, :"ClientTermsError.Reason"=>{:fields=>[]}, :"Criterion.Type"=>{:fields=>[]}, :"CriterionError.Reason"=>{:fields=>[]}, :"DatabaseError.Reason"=>{:fields=>[]}, :"DistinctError.Reason"=>{:fields=>[]}, :"EntityNotFound.Reason"=>{:fields=>[]}, :"IdError.Reason"=>{:fields=>[]}, :"InternalApiError.Reason"=>{:fields=>[]}, :"NotWhitelistedError.Reason"=>{:fields=>[]}, :Operator=>{:fields=>[]}, :"OperatorError.Reason"=>{:fields=>[]}, :"Predicate.Operator"=>{:fields=>[]}, :"QuotaCheckError.Reason"=>{:fields=>[]}, :"RangeError.Reason"=>{:fields=>[]}, :"RateExceededError.Reason"=>{:fields=>[]}, :"ReadOnlyError.Reason"=>{:fields=>[]}, :"RequestError.Reason"=>{:fields=>[]}, :"RequiredError.Reason"=>{:fields=>[]}, :"SelectorError.Reason"=>{:fields=>[]}, :"SizeLimitError.Reason"=>{:fields=>[]}, :SortOrder=>{:fields=>[]}, :"StringLengthError.Reason"=>{:fields=>[]}}
+    ADGROUPBIDMODIFIERSERVICE_NAMESPACES = []
+
+    def self.get_method_signature(method_name)
+      return ADGROUPBIDMODIFIERSERVICE_METHODS[method_name.to_sym]
+    end
+
+    def self.get_type_signature(type_name)
+      return ADGROUPBIDMODIFIERSERVICE_TYPES[type_name.to_sym]
+    end
+
+    def self.get_namespace(index)
+      return ADGROUPBIDMODIFIERSERVICE_NAMESPACES[index]
+    end
+  end
+
+  # Base class for exceptions.
+  class ApplicationException < AdwordsApi::Errors::ApiException
+    attr_reader :message  # string
+    attr_reader :application_exception_type  # string
+  end
+
+  # Exception class for holding a list of service errors.
+  class ApiException < ApplicationException
+    attr_reader :errors  # ApiError
+    def initialize(exception_fault)
+      @array_fields ||= []
+      @array_fields << 'errors'
+      super(exception_fault, AdGroupBidModifierServiceRegistry)
+    end
+  end
+end; end; end

data/lib/adwords_api/version.rb

@@ -21,6 +21,6 @@
 
 module AdwordsApi
   module ApiConfig
-    CLIENT_LIB_VERSION = '0.9.0'
+    CLIENT_LIB_VERSION = '0.9.1'
   end
 end

data/test/examples/v201302/test_advanced_operations.rb

@@ -26,6 +26,8 @@ require 'advanced_operations/add_site_links'
 require 'advanced_operations/add_click_to_download_ad'
 require 'advanced_operations/create_and_attach_shared_keyword_set'
 require 'advanced_operations/find_and_remove_criteria_from_shared_set'
+require 'advanced_operations/add_ad_group_bid_modifier'
+require 'advanced_operations/get_ad_group_bid_modifiers'
 
 PLACEHOLDER_SITELINKS = 1
 PLACEHOLDER_FIELD_SITELINK_LINK_TEXT = 1
@@ -61,4 +63,19 @@ class TestAdvancedOperationsV201302 < Test::Unit::TestCase
     create_and_attach_shared_keyword_set(campaign[:id])
     find_and_remove_criteria_from_shared_set(campaign[:id])
   end
+
+  def test_get_ad_group_bid_modifiers()
+    campaign = @utils.get_campaign()
+    assert_not_nil(campaign)
+    assert_not_nil(campaign[:id])
+    get_ad_group_bid_modifiers(campaign[:id])
+  end
+
+  def test_add_ad_group_bid_modifier()
+    bid_modifier = 1.1
+    ad_group = @utils.get_ad_group()
+    assert_not_nil(ad_group)
+    assert_not_nil(ad_group[:id])
+    add_ad_group_bid_modifier(ad_group[:id], bid_modifier)
+  end
 end

data/test/examples/v201302/test_campaign_management.rb

@@ -30,7 +30,6 @@ require 'campaign_management/get_all_disapproved_ads'
 require 'campaign_management/get_all_disapproved_ads_with_awql'
 require 'campaign_management/promote_experiment'
 require 'campaign_management/set_ad_parameters'
-require 'campaign_management/set_campaign_enhanced'
 require 'campaign_management/set_criterion_bid_modifier'
 require 'campaign_management/validate_text_ad'
 
@@ -117,13 +116,6 @@ class TestCampaignManagementV201302 < Test::Unit::TestCase
     set_ad_parameters(ad_group[:id], criterion[:criterion][:id])
   end
 
-  def test_set_campaign_enhanced()
-    campaign = @utils.get_campaign()
-    assert_not_nil(campaign)
-    assert_not_nil(campaign[:id])
-    set_campaign_enhanced(campaign[:id])
-  end
-
   def test_set_criterion_bid_modifier()
     campaign = @utils.get_campaign()
     assert_not_nil(campaign)

data/test/examples/v201302/test_migration.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+# Encoding: utf-8
+#
+# Author:: api.dklimkin@gmail.com (Danial Klimkin)
+#
+# Copyright:: Copyright 2013, 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.
+#
+# Tests the migration examples.
+
+require 'test/unit'
+
+require 'migration/set_campaign_enhanced'
+
+class TestMigrationV201302 < Test::Unit::TestCase
+  def setup
+    @logger = Logger.new(STDOUT)
+    @logger.level = Logger::ERROR
+    @adwords = AdwordsApi::Api.new
+    @adwords.logger = @logger
+    @utils = UtilsV201302.new(@adwords)
+  end
+
+  def test_set_campaign_enhanced()
+    campaign = @utils.get_campaign()
+    assert_not_nil(campaign)
+    assert_not_nil(campaign[:id])
+    set_campaign_enhanced(campaign[:id])
+  end
+
+  def test_upgrade_legacy_sitelinks()
+    campaign = @utils.get_campaign()
+    assert_not_nil(campaign)
+    assert_not_nil(campaign[:id])
+    upgrade_legacy_sitelinks([campaign[:id]])
+  end
+end

data/test/templates/v201209/basic_operations_get_campaigns.def

@@ -22,7 +22,7 @@ def setup_mocks()
         {"env:Envelope"=>
           {"env:Header"=>
             {"wsdl:RequestHeader"=>
-              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.0, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
+              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.1, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
                "developerToken"=>"dev_token123",
                "clientCustomerId"=>"123-456-7890",
                "authToken"=>"abcAuthbcd",

data/test/templates/v201302/basic_operations_get_campaigns.def

@@ -22,7 +22,7 @@ def setup_mocks()
         {"env:Envelope"=>
           {"env:Header"=>
             {"wsdl:RequestHeader"=>
-              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.0, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
+              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.1, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
                "developerToken"=>"dev_token123",
                "clientCustomerId"=>"123-456-7890",
                "authToken"=>"abcAuthbcd",

data/test/templates/v201302/misc_use_oauth2_jwt.def

@@ -40,7 +40,7 @@ def setup_mocks()
         {"env:Envelope"=>
           {"env:Header"=>
             {"wsdl:RequestHeader"=>
-              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.0, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
+              {"userAgent"=>"ruby-tests (AwApi-Ruby/0.9.1, Common-Ruby/0.9.3, Savon/1.2.0, ruby/1.9.3, HTTPI/1.1.1, net_http)",
                "developerToken"=>"dev_token123",
                "clientCustomerId"=>"123-456-7890",
                "xmlns"=>"https://adwords.google.com/api/adwords/cm/v201302"}},

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-adwords-api
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-17 00:00:00.000000000 Z
+date: 2013-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-ads-common
@@ -66,6 +66,7 @@ files:
 - lib/adwords_api/v201302/geo_location_service.rb
 - lib/adwords_api/v201302/ad_group_criterion_service.rb
 - lib/adwords_api/v201302/managed_customer_service.rb
+- lib/adwords_api/v201302/ad_group_bid_modifier_service_registry.rb
 - lib/adwords_api/v201302/user_list_service_registry.rb
 - lib/adwords_api/v201302/constant_data_service_registry.rb
 - lib/adwords_api/v201302/ad_group_ad_service.rb
@@ -106,6 +107,7 @@ files:
 - lib/adwords_api/v201302/geo_location_service_registry.rb
 - lib/adwords_api/v201302/targeting_idea_service_registry.rb
 - lib/adwords_api/v201302/data_service.rb
+- lib/adwords_api/v201302/ad_group_bid_modifier_service.rb
 - lib/adwords_api/report_header_handler.rb
 - lib/adwords_api/api_config.rb
 - lib/adwords_api/errors.rb
@@ -137,6 +139,7 @@ files:
 - lib/adwords_api/v201209/ad_group_criterion_service.rb
 - lib/adwords_api/v201209/managed_customer_service.rb
 - lib/adwords_api/v201209/video_targeting_group_criterion_service_registry.rb
+- lib/adwords_api/v201209/ad_group_bid_modifier_service_registry.rb
 - lib/adwords_api/v201209/video_campaign_service.rb
 - lib/adwords_api/v201209/user_list_service_registry.rb
 - lib/adwords_api/v201209/video_service_registry.rb
@@ -176,6 +179,7 @@ files:
 - lib/adwords_api/v201209/geo_location_service_registry.rb
 - lib/adwords_api/v201209/targeting_idea_service_registry.rb
 - lib/adwords_api/v201209/data_service.rb
+- lib/adwords_api/v201209/ad_group_bid_modifier_service.rb
 - lib/adwords_api.rb
 - test/suite_integration.rb
 - test/examples/v201302/utils.rb
@@ -184,6 +188,7 @@ files:
 - test/examples/v201302/test_misc.rb
 - test/examples/v201302/test_remarketing.rb
 - test/examples/v201302/test_account_management.rb
+- test/examples/v201302/test_migration.rb
 - test/examples/v201302/test_optimization.rb
 - test/examples/v201302/test_reporting.rb
 - test/examples/v201302/test_basic_operations.rb
@@ -237,7 +242,6 @@ files:
 - examples/v201302/campaign_management/add_keywords_in_bulk.rb
 - examples/v201302/campaign_management/promote_experiment.rb
 - examples/v201302/campaign_management/get_all_disapproved_ads.rb
-- examples/v201302/campaign_management/set_campaign_enhanced.rb
 - examples/v201302/campaign_management/add_location_extension_override.rb
 - examples/v201302/account_management/get_account_hierarchy.rb
 - examples/v201302/account_management/get_account_changes.rb
@@ -268,10 +272,14 @@ files:
 - examples/v201302/misc/use_oauth2_jwt.rb
 - examples/v201302/misc/get_all_images_and_videos.rb
 - examples/v201302/misc/use_oauth2.rb
+- examples/v201302/migration/upgrade_legacy_sitelinks.rb
+- examples/v201302/migration/set_campaign_enhanced.rb
 - examples/v201302/remarketing/add_conversion_tracker.rb
 - examples/v201302/remarketing/add_audience.rb
 - examples/v201302/advanced_operations/add_site_links.rb
+- examples/v201302/advanced_operations/get_ad_group_bid_modifiers.rb
 - examples/v201302/advanced_operations/create_and_attach_shared_keyword_set.rb
+- examples/v201302/advanced_operations/add_ad_group_bid_modifier.rb
 - examples/v201302/advanced_operations/find_and_remove_criteria_from_shared_set.rb
 - examples/v201302/advanced_operations/add_click_to_download_ad.rb
 - examples/v201209/reporting/download_criteria_report.rb