RubyGems - adwords4r - Versions diffs - 16.0.0 → 17.0.0 - Mend

adwords4r 16.0.0 → 17.0.0

Files changed (2373) hide show

data/doc/classes/AdWords/Generator.html ADDED Viewed

@@ -0,0 +1,246 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+    <title>AdWords::Generator</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <link rel="stylesheet" href="../../css/reset.css" type="text/css" media="screen" />
+    <link rel="stylesheet" href="../../css/main.css" type="text/css" media="screen" />
+    <script src="../../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
+    <script src="../../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
+    <script src="../../js/main.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+    <div class="banner">
+        <h1>
+            <span class="type">Module</span>
+            AdWords::Generator
+        </h1>
+        <ul class="files">
+            <li><a href="../../files/lib/adwords4r/generator_rb.html">lib/adwords4r/generator.rb</a></li>
+        </ul>
+    </div>
+    <div id="bodyContent">
+        <div id="content">
+    <div class="description">
+        <p>
+Contains helper methods for loading and managing the available services.
+</p>
+    </div>
+    <div class="sectiontitle">Methods</div>
+    <dl class="methods">
+        <dt>G</dt>
+        <dd>
+            <ul>
+                <li><a href="#M000072">generate_wrapper_class</a></li>
+            </ul>
+        </dd>
+    </dl>
+    <div class="sectiontitle">Constants</div>
+    <table border='0' cellpadding='5'>
+        <tr valign='top'>
+            <td class="attr-name">ARRAY_CLASSNAME</td>
+            <td>=</td>
+            <td class="attr-value">'SOAP::SOAPArray'</td>
+        </tr>
+    </table>
+            <div class="sectiontitle">Class Public methods</div>
+            <div class="method">
+                <div class="title" id="M000072">
+                    <a name="M000072"></a><b>generate_wrapper_class</b>(version, service)
+                </div>
+                <div class="description">
+                  <p>
+Generate the wrapper class for a given service. These classes make it
+easier to invoke the <a href="API.html">API</a> methods, by removing the
+need to instance a <MethodName> object, instead allowing passing of the
+call parameters directly. Here is an example of a generated wrapper class,
+with one <a href="API.html">API</a> method and one extension:
+</p>
+<pre>
+ class SampleServiceWrapper
+   attr_reader :api
+   def initialize(driver, api)
+     @driver = driver
+     @api = api
+   end
+   def getSomething(par1, par2)
+     begin
+       AdWords::Service.validate_param('par1', par1, SOAP::SOAPArray)
+       AdWords::Service.validate_param('par2', par2, SOAP::SOAPInt)
+       # Construct request object and make API call
+       obj = AdWords::V13::GetSomething.new(par1, par2)
+       return @driver.getSomething(obj)
+     rescue SOAP::FaultError =&gt; fault
+       raise(AdWords::Error::create_specific_api_error(fault),
+           &quot;getSomething Call Failed: &quot; + fault.faultstring.to_s, caller)
+     end
+   end
+   def doSomethingElseExtension(par1, par2)
+     return AdWords::Extensions.doSomethingElseExtension(self, par1, par2)
+   end
+ end
+</pre>
+<p>
+Args:
+</p>
+<ul>
+<li>version: the <a href="API.html">API</a> version (as an integer)
+</li>
+<li>service: the service name (as a string)
+</li>
+</ul>
+<p>
+Returns: The Ruby code for the class, as a string.
+</p>
+                </div>
+                <div class="sourcecode">
+                    <p class="source-link">
+                        Source: <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show</a>
+                    </p>
+                    <div id="M000072_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r/generator.rb, line 71</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">generate_wrapper_class</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>)
+      <span class="ruby-identifier">wrapper</span> = <span class="ruby-identifier">service</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;ServiceWrapper&quot;</span>
+      <span class="ruby-identifier">module_name</span> = <span class="ruby-constant">AdWords</span><span class="ruby-operator">::</span><span class="ruby-constant">Service</span>.<span class="ruby-identifier">get_module_name</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>)
+      <span class="ruby-identifier">driver</span> = <span class="ruby-constant">AdWords</span><span class="ruby-operator">::</span><span class="ruby-constant">Service</span>.<span class="ruby-identifier">get_interface_name</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>)
+      <span class="ruby-identifier">driver_class</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-identifier">driver</span>)
+      <span class="ruby-identifier">registry</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-node">&quot;#{module_name}::DefaultMappingRegistry::LiteralRegistry&quot;</span>)
+      <span class="ruby-identifier">class_def</span> = <span class="ruby-value str">&quot;# This file was automatically generated during the \&quot;rake generate\&quot; step of\n# library setup.\nrequire 'adwords4r/v\#{version}/\#{service}ServiceDriver.rb'\n\nmodule AdWords\nmodule V\#{version}\nmodule \#{service}Service\n\n# Wrapper class for the v\#{version.to_s} \#{service} service.\n# This class is automatically generated.\nclass \#{wrapper}\n\n# Holds the AdWords::API object to which the wrapper belongs.\nattr_reader :api\n\n# Holds a shortcut to the parent module.\n# Use this to avoid typing the full class name when creating classes\n# belonging to this service, e.g.\n#  service_object.module::ClassName\n# instead of\n#  AdWords::V\#{version.to_s}::\#{service}Service::ClassName\n# This will make it easier to migrate your code between API versions.\nattr_reader :module\n\npublic\n\n# Constructor for \#{wrapper}.\n#\n# Args:\n# - driver: SOAP::RPC::Driver object with the remote SOAP methods for\n#   this service\n# - api: the AdWords::API object to which the wrapper belongs\n#\ndef initialize(driver, api)\n@driver = driver\n@api = api\n@module = AdWords::V\#{version.to_s}::\#{service}Service\nend\n\n&quot;</span>
+      <span class="ruby-comment cmt"># Add service methods</span>
+      <span class="ruby-identifier">methods</span> = <span class="ruby-identifier">driver_class</span><span class="ruby-operator">::</span><span class="ruby-constant">Methods</span>
+      <span class="ruby-identifier">module_name</span> = <span class="ruby-constant">AdWords</span><span class="ruby-operator">::</span><span class="ruby-constant">Service</span>.<span class="ruby-identifier">get_module_name</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>)
+      <span class="ruby-identifier">methods</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">method</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">name</span> = <span class="ruby-identifier">method</span>[<span class="ruby-value">1</span>]
+        <span class="ruby-identifier">doc_link</span> = <span class="ruby-identifier">get_doc_link</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>, <span class="ruby-identifier">name</span>)
+        <span class="ruby-identifier">method_def</span> = <span class="ruby-value str">&quot;# Calls the {\#{name}}[\#{doc_link}] method of the \#{service} service.\n# Check {the online documentation for this method}[\#{doc_link}].\n&quot;</span>
+        <span class="ruby-identifier">method_class</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-node">&quot;#{module_name}::#{fix_case_up(name)}&quot;</span>)
+        <span class="ruby-identifier">arguments</span> = <span class="ruby-identifier">registry</span>.<span class="ruby-identifier">schema_definition_from_class</span>(<span class="ruby-identifier">method_class</span>).<span class="ruby-identifier">elements</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+          <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;#\n# Args:\n&quot;</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-comment cmt"># Add list of arguments to the RDoc comment</span>
+        <span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">elem</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">get_type</span>(<span class="ruby-identifier">elem</span>) <span class="ruby-operator">==</span> <span class="ruby-constant">ARRAY_CLASSNAME</span>
+            <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;# - \#{elem.varname}: \#{get_type(elem)} of \#{elem.mapped_class}\n&quot;</span>
+          <span class="ruby-keyword kw">else</span>
+            <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;# - \#{elem.varname}: \#{get_type(elem)}\n&quot;</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">response_class</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-node">&quot;#{module_name}::#{fix_case_up(name)}Response&quot;</span>)
+        <span class="ruby-identifier">returns</span> = <span class="ruby-identifier">registry</span>.<span class="ruby-identifier">schema_definition_from_class</span>(<span class="ruby-identifier">response_class</span>).<span class="ruby-identifier">elements</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">returns</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+          <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;#\n# Returns:\n&quot;</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-comment cmt"># Add list of returns to the RDoc comment</span>
+        <span class="ruby-identifier">returns</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">elem</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">get_type</span>(<span class="ruby-identifier">elem</span>) <span class="ruby-operator">==</span> <span class="ruby-constant">ARRAY_CLASSNAME</span>
+            <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;# - \#{elem.varname}: \#{get_type(elem)} of \#{elem.mapped_class}\n&quot;</span>
+          <span class="ruby-keyword kw">else</span>
+            <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;# - \#{elem.varname}: \#{get_type(elem)}\n&quot;</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">arg_names</span> = []
+        <span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">elem</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">arg_names</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">varname</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">arg_list</span> = <span class="ruby-identifier">arg_names</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">', '</span>)
+        <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;#\n# Raises:\n# Error::ApiError (or a subclass thereof) if a SOAP fault occurs.\n#\ndef \#{name}(\#{arg_list})\nbegin\n&quot;</span>
+        <span class="ruby-comment cmt"># Add validation for every argument</span>
+        <span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">elem</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;AdWords::Service.validate_param('\#{elem.varname}',\n\#{arg_names[index]}, \#{get_type(elem)})\n&quot;</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">method_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;# Construct request object and make API call\nobj = \#{module_name}::\#{fix_case_up(name)}.new(\#{arg_list})\nreturn @driver.\#{name}(obj)\nrescue SOAP::FaultError =&gt; fault\nraise(AdWords::Error::create_specific_api_error(fault),\n\&quot;\#{name} Call Failed: \&quot; + fault.faultstring.to_s, caller)\nend\nend\n\n&quot;</span>
+        <span class="ruby-identifier">class_def</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">method_def</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-comment cmt"># Add extension methods, if any</span>
+      <span class="ruby-identifier">extensions</span> = <span class="ruby-constant">AdWords</span><span class="ruby-operator">::</span><span class="ruby-constant">Extensions</span><span class="ruby-operator">::</span><span class="ruby-identifier">extensions</span>[[<span class="ruby-identifier">version</span>, <span class="ruby-identifier">service</span>]]
+      <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">extensions</span>.<span class="ruby-identifier">nil?</span>
+        <span class="ruby-identifier">extensions</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ext</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">params</span> = <span class="ruby-constant">AdWords</span><span class="ruby-operator">::</span><span class="ruby-constant">Extensions</span><span class="ruby-operator">::</span><span class="ruby-identifier">methods</span>[<span class="ruby-identifier">ext</span>].<span class="ruby-identifier">join</span>(<span class="ruby-value str">', '</span>)
+          <span class="ruby-identifier">arglist</span> = <span class="ruby-value str">'self'</span>
+          <span class="ruby-identifier">arglist</span> <span class="ruby-operator">+=</span> <span class="ruby-node">&quot;, #{params}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span> <span class="ruby-operator">!=</span> <span class="ruby-value str">''</span>
+          <span class="ruby-identifier">method_def</span> = <span class="ruby-value str">&quot;# &lt;i&gt;Extension method&lt;/i&gt; -- Calls the AdWords::Extensions.\#{ext} method\n# with +self+ as the first parameter.\ndef \#{ext}(\#{params})\nreturn AdWords::Extensions.\#{ext}(\#{arglist})\nend\n\n&quot;</span>
+          <span class="ruby-identifier">class_def</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">method_def</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">class_def</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;end\nend\nend\nend\n&quot;</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">class_def</span>
+    <span class="ruby-keyword kw">end</span></pre>
+                    </div>
+                </div>
+            </div>
+</div>
+    </div>
+  </body>
+</html>

data/doc/classes/AdWords/{Pre200902HeaderHandler.html → Pre2009HeaderHandler.html} RENAMED Viewed

@@ -3,7 +3,7 @@
     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-    <title>AdWords::Pre200902HeaderHandler</title>
+    <title>AdWords::Pre2009HeaderHandler</title>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     <link rel="stylesheet" href="../../css/reset.css" type="text/css" media="screen" />
     <link rel="stylesheet" href="../../css/main.css" type="text/css" media="screen" />
@@ -16,7 +16,7 @@
     <div class="banner">
         <h1>
             <span class="type">Class</span>
-            AdWords::Pre200902HeaderHandler
+            AdWords::Pre2009HeaderHandler
                 <span class="parent">&lt;
@@ -56,7 +56,7 @@ Handles the headers used in <= v13 (both sandbox and production)
         <dd>
             <ul>
-                <li><a href="#M000006">new</a></li>
+                <li><a href="#M000011">new</a></li>
             </ul>
         </dd>
@@ -65,7 +65,7 @@ Handles the headers used in <= v13 (both sandbox and production)
         <dd>
             <ul>
-                <li><a href="#M000007">on_simple_outbound</a></li>
+                <li><a href="#M000012">on_simple_outbound</a></li>
             </ul>
         </dd>
@@ -97,7 +97,7 @@ Handles the headers used in <= v13 (both sandbox and production)
             <td class='attr-rw'>
                 [W]
             </td>
-            <td class='attr-name'>value</td>
+            <td class='attr-name'>credentials</td>
             <td class='attr-desc'></td>
         </tr>
@@ -108,16 +108,16 @@ Handles the headers used in <= v13 (both sandbox and production)
             <div class="sectiontitle">Class Public methods</div>
             <div class="method">
-                <div class="title" id="M000006">
+                <div class="title" id="M000011">
-                    <a name="M000006"></a><b>new</b>(tag, value)
+                    <a name="M000011"></a><b>new</b>(tag, credentials)
                 </div>
                 <div class="description">
                   <p>
 Constructor for <a
-href="Pre200902HeaderHandler.html">Pre200902HeaderHandler</a>.
+href="Pre2009HeaderHandler.html">Pre2009HeaderHandler</a>.
 </p>
 <p>
 Args:
@@ -138,15 +138,15 @@ Args:
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000006_source')" id="l_M000006_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000011_source')" id="l_M000011_source">show</a>
                     </p>
-                    <div id="M000006_source" class="dyn-source">
-                        <pre><span class="ruby-comment cmt"># File lib/adwords4r/credentials.rb, line 62</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">tag</span>, <span class="ruby-identifier">value</span>)
+                    <div id="M000011_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r/credentials.rb, line 98</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">tag</span>, <span class="ruby-identifier">credentials</span>)
       <span class="ruby-keyword kw">super</span>(<span class="ruby-constant">XSD</span><span class="ruby-operator">::</span><span class="ruby-constant">QName</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">tag</span>))
       <span class="ruby-ivar">@tag</span> = <span class="ruby-identifier">tag</span>
-      <span class="ruby-ivar">@value</span> = <span class="ruby-identifier">value</span>
+      <span class="ruby-ivar">@credentials</span> = <span class="ruby-identifier">credentials</span>
     <span class="ruby-keyword kw">end</span></pre>
                     </div>
                 </div>
@@ -156,9 +156,9 @@ Args:
             <div class="sectiontitle">Instance Public methods</div>
             <div class="method">
-                <div class="title" id="M000007">
+                <div class="title" id="M000012">
-                    <a name="M000007"></a><b>on_simple_outbound</b>()
+                    <a name="M000012"></a><b>on_simple_outbound</b>()
                 </div>
@@ -174,13 +174,19 @@ Handles callback.
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000007_source')" id="l_M000007_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000012_source')" id="l_M000012_source">show</a>
                     </p>
-                    <div id="M000007_source" class="dyn-source">
-                        <pre><span class="ruby-comment cmt"># File lib/adwords4r/credentials.rb, line 69</span>
+                    <div id="M000012_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r/credentials.rb, line 105</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">on_simple_outbound</span>
-      <span class="ruby-ivar">@value</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@tag</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'clientEmail'</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@credentials</span>.<span class="ruby-identifier">client_email</span>
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@tag</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'clientCustomerId'</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@credentials</span>.<span class="ruby-identifier">client_customer_id</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-ivar">@credentials</span>.<span class="ruby-identifier">credentials</span>[<span class="ruby-ivar">@tag</span>]
+      <span class="ruby-keyword kw">end</span>
     <span class="ruby-keyword kw">end</span></pre>
                     </div>
                 </div>

data/doc/classes/AdWords/ResponseHandler.html CHANGED Viewed

@@ -57,7 +57,7 @@ unit usage and statistics information.
         <dd>
             <ul>
-                <li><a href="#M000019">new</a></li>
+                <li><a href="#M000026">new</a></li>
             </ul>
         </dd>
@@ -66,7 +66,7 @@ unit usage and statistics information.
         <dd>
             <ul>
-                <li><a href="#M000020">on_callback</a></li>
+                <li><a href="#M000028">on_callback</a></li>
             </ul>
         </dd>
@@ -75,7 +75,7 @@ unit usage and statistics information.
         <dd>
             <ul>
-                <li><a href="#M000021">parse_header</a></li>
+                <li><a href="#M000029">parse_header</a></li>
             </ul>
         </dd>
@@ -97,9 +97,9 @@ unit usage and statistics information.
             <div class="sectiontitle">Class Public methods</div>
             <div class="method">
-                <div class="title" id="M000019">
+                <div class="title" id="M000026">
-                    <a name="M000019"></a><b>new</b>(parent)
+                    <a name="M000026"></a><b>new</b>(parent)
                 </div>
@@ -124,11 +124,11 @@ href="ResponseHandler.html">ResponseHandler</a> should be tied
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000019_source')" id="l_M000019_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000026_source')" id="l_M000026_source">show</a>
                     </p>
-                    <div id="M000019_source" class="dyn-source">
-                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 320</span>
+                    <div id="M000026_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 437</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">parent</span>)
       <span class="ruby-ivar">@parent</span> = <span class="ruby-identifier">parent</span>
     <span class="ruby-keyword kw">end</span></pre>
@@ -140,9 +140,9 @@ href="ResponseHandler.html">ResponseHandler</a> should be tied
             <div class="sectiontitle">Instance Public methods</div>
             <div class="method">
-                <div class="title" id="M000020">
+                <div class="title" id="M000028">
-                    <a name="M000020"></a><b>on_callback</b>(method_name, endpoint, envelope)
+                    <a name="M000028"></a><b>on_callback</b>(method_name, endpoint, envelope, params)
                 </div>
@@ -162,6 +162,9 @@ Args:
 </li>
 <li>envelope: the envelope for the SOAP response that was received
+</li>
+<li>params: the parameters that were passed to the method
 </li>
 </ul>
@@ -172,16 +175,47 @@ Args:
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000020_source')" id="l_M000020_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000028_source')" id="l_M000028_source">show</a>
                     </p>
-                    <div id="M000020_source" class="dyn-source">
-                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 332</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">on_callback</span>(<span class="ruby-identifier">method_name</span>, <span class="ruby-identifier">endpoint</span>, <span class="ruby-identifier">envelope</span>)
+                    <div id="M000028_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 450</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">on_callback</span>(<span class="ruby-identifier">method_name</span>, <span class="ruby-identifier">endpoint</span>, <span class="ruby-identifier">envelope</span>, <span class="ruby-identifier">params</span>)
       <span class="ruby-identifier">units</span> = <span class="ruby-keyword kw">nil</span>
       <span class="ruby-identifier">operations</span> = <span class="ruby-keyword kw">nil</span>
       <span class="ruby-identifier">response_time</span> = <span class="ruby-keyword kw">nil</span>
       <span class="ruby-identifier">request_id</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">operators</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">operator_count</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>] <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/.*::Mutate/</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>) <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">1</span>
+          <span class="ruby-identifier">operators</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value">0</span>)
+          <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">operation</span><span class="ruby-operator">|</span>
+            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">operation</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">operation</span>[<span class="ruby-identifier">:operator</span>]
+              <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">operation</span>[<span class="ruby-identifier">:operator</span>].<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+            <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">operation</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">operation</span>[<span class="ruby-value str">'operator'</span>]
+              <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">operation</span>[<span class="ruby-value str">'operator'</span>].<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+            <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">operation</span>.<span class="ruby-identifier">respond_to?</span> <span class="ruby-value str">'operator'</span>
+              <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">operation</span>.<span class="ruby-identifier">operator</span>.<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+            <span class="ruby-keyword kw">else</span>
+              <span class="ruby-identifier">operators</span>[<span class="ruby-value str">'?'</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+            <span class="ruby-keyword kw">end</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">:operator</span>]
+            <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">:operator</span>].<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>][<span class="ruby-value str">'operator'</span>]
+            <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>][<span class="ruby-value str">'operator'</span>].<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">respond_to?</span> <span class="ruby-value str">'operator'</span>
+            <span class="ruby-identifier">operators</span>[<span class="ruby-identifier">params</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">operator</span>.<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">operators</span>
+        <span class="ruby-identifier">operator_count</span> = <span class="ruby-identifier">operators</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">op</span>, <span class="ruby-identifier">num</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;#{op}: #{num}&quot;</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">', '</span>)
+      <span class="ruby-keyword kw">end</span>
       <span class="ruby-identifier">header</span> = <span class="ruby-identifier">envelope</span>.<span class="ruby-identifier">header</span>
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">header</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-value str">'ResponseHeader'</span>)
@@ -203,8 +237,11 @@ Args:
       <span class="ruby-identifier">host</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">endpoint</span>).<span class="ruby-identifier">host</span>
       <span class="ruby-identifier">data</span> = <span class="ruby-node">&quot;host=#{host} method=#{method_name} &quot;</span> <span class="ruby-operator">+</span>
-        <span class="ruby-node">&quot;responseTime=#{response_time} operations=#{operations} &quot;</span> <span class="ruby-operator">+</span>
-        <span class="ruby-node">&quot;units=#{units} requestId=#{request_id}&quot;</span>
+        <span class="ruby-node">&quot;responseTime=#{response_time} operations=#{operations} &quot;</span>
+      <span class="ruby-identifier">data</span> <span class="ruby-operator">+=</span> <span class="ruby-node">&quot;operators={#{operator_count}} &quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">operator_count</span>
+      <span class="ruby-identifier">data</span> <span class="ruby-operator">+=</span> <span class="ruby-node">&quot;units=#{units} requestId=#{request_id}&quot;</span>
       <span class="ruby-ivar">@parent</span>.<span class="ruby-identifier">unit_logger</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">data</span>
     <span class="ruby-keyword kw">end</span></pre>
@@ -214,9 +251,9 @@ Args:
             </div>
             <div class="method">
-                <div class="title" id="M000021">
+                <div class="title" id="M000029">
-                    <a name="M000021"></a><b>parse_header</b>(header)
+                    <a name="M000029"></a><b>parse_header</b>(header)
                 </div>
@@ -244,11 +281,11 @@ header is nil
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000029_source')" id="l_M000029_source">show</a>
                     </p>
-                    <div id="M000021_source" class="dyn-source">
-                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 372</span>
+                    <div id="M000029_source" class="dyn-source">
+                        <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 524</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse_header</span>(<span class="ruby-identifier">header</span>)
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">header</span>.<span class="ruby-identifier">nil?</span>
         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>