# This file was automatically generated during the "rake generate" step of
# library setup.
require 'adwords4r/v200906/CampaignCriterionServiceDriver.rb'

module AdWords
  module V200906
    module CampaignCriterionService

      # Wrapper class for the v200906 CampaignCriterion service.
      # This class is automatically generated.
      class CampaignCriterionServiceWrapper

        # Holds the AdWords::API object to which the wrapper belongs.
        attr_reader :api

        # Holds a shortcut to the parent module.
        # Use this to avoid typing the full class name when creating classes
        # belonging to this service, e.g.
        #  service_object.module::ClassName
        # instead of
        #  AdWords::V200906::CampaignCriterionService::ClassName
        # This will make it easier to migrate your code between API versions.
        attr_reader :module

        public

        # Constructor for CampaignCriterionServiceWrapper.
        #
        # Args:
        # - driver: SOAP::RPC::Driver object with the remote SOAP methods for
        #   this service
        # - api: the AdWords::API object to which the wrapper belongs
        #
        def initialize(driver, api)
          @driver = driver
          @api = api
          @module = AdWords::V200906::CampaignCriterionService
        end

        # Calls the {get}[http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCriterionService.html#get] method of the CampaignCriterion service.
        # Check {the online documentation for this method}[http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCriterionService.html#get].
        #
        # Args:
        # - selector: AdWords::V200906::CampaignCriterionService::CampaignCriterionSelector
        #
        # Returns:
        # - rval: AdWords::V200906::CampaignCriterionService::CampaignCriterionPage
        #
        # Raises:
        # Error::ApiError (or a subclass thereof) if a SOAP fault occurs.
        #
        def get(selector)
          begin
            AdWords::Service.validate_param('selector',
                selector, AdWords::V200906::CampaignCriterionService::CampaignCriterionSelector)
            # Construct request object and make API call
            obj = AdWords::V200906::CampaignCriterionService::Get.new(selector)
            return @driver.get(obj)
          rescue SOAP::FaultError => fault
            raise(AdWords::Error::create_specific_api_error(fault),
                "get Call Failed: " + fault.faultstring.to_s, caller)
          end
        end

        # Calls the {mutate}[http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCriterionService.html#mutate] method of the CampaignCriterion service.
        # Check {the online documentation for this method}[http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCriterionService.html#mutate].
        #
        # Args:
        # - operations: SOAP::SOAPArray of AdWords::V200906::CampaignCriterionService::CampaignCriterionOperation
        #
        # Returns:
        # - rval: AdWords::V200906::CampaignCriterionService::CampaignCriterionReturnValue
        #
        # Raises:
        # Error::ApiError (or a subclass thereof) if a SOAP fault occurs.
        #
        def mutate(operations)
          begin
            AdWords::Service.validate_param('operations',
                operations, SOAP::SOAPArray)
            # Construct request object and make API call
            obj = AdWords::V200906::CampaignCriterionService::Mutate.new(operations)
            return @driver.mutate(obj)
          rescue SOAP::FaultError => fault
            raise(AdWords::Error::create_specific_api_error(fault),
                "mutate Call Failed: " + fault.faultstring.to_s, caller)
          end
        end

      end
    end
  end
end