adwords4r 17.0.1 → 17.1.0

data/ChangeLog.txt

@@ -1,3 +1,8 @@
+17.1.0
+- Added support for AdParamService in v200909.
+- Improved request logging, by adding isFault and faultMessage.
+  isFault indicates whether the request was a fault, and faultMessage contains the error message, if any.
+
 17.0.1
 - Fixed unit tracking for failed requests.
   Issue 13, http://code.google.com/p/google-api-adwords-ruby/issues/detail?id=13

data/Rakefile

@@ -43,7 +43,7 @@ require 'adwords4r/apiextensions'
 require 'adwords4r/generator'
 
 # Configure some constants and built-in tasks
-CURRENT_VERSION = '17.0.1'
+CURRENT_VERSION = '17.1.0'
 PKG_VERSION = ENV['REL'] ? ENV['REL'] : CURRENT_VERSION
 
 WSDLDIR = 'wsdl'

data/doc/classes/AdWords.html

@@ -37,8 +37,6 @@
             
             <li><a href="../files/lib/adwords4r/generator_rb.html">lib/adwords4r/generator.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/services_back_rb.html">lib/adwords4r/services_back.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v13/AccountServiceWrapper_rb.html">lib/adwords4r/v13/AccountServiceWrapper.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v13/AdGroupServiceWrapper_rb.html">lib/adwords4r/v13/AdGroupServiceWrapper.rb</a></li>
@@ -71,10 +69,6 @@
             
             <li><a href="../files/lib/adwords4r/v200906/CampaignTargetServiceWrapper_rb.html">lib/adwords4r/v200906/CampaignTargetServiceWrapper.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200906/TargetingIdeaServiceWrapper_rb.html">lib/adwords4r/v200906/TargetingIdeaServiceWrapper.rb</a></li>
-            
-            <li><a href="../files/lib/adwords4r/v200906/InfoServiceWrapper_rb.html">lib/adwords4r/v200906/InfoServiceWrapper.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v200909/AdExtensionOverrideServiceWrapper_rb.html">lib/adwords4r/v200909/AdExtensionOverrideServiceWrapper.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v200909/AdGroupAdServiceWrapper_rb.html">lib/adwords4r/v200909/AdGroupAdServiceWrapper.rb</a></li>
@@ -99,14 +93,16 @@
             
             <li><a href="../files/lib/adwords4r/v200909/TargetingIdeaServiceWrapper_rb.html">lib/adwords4r/v200909/TargetingIdeaServiceWrapper.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v200909/AdParamServiceWrapper_rb.html">lib/adwords4r/v200909/AdParamServiceWrapper.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v13/AccountService_rb.html">lib/adwords4r/v13/AccountService.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v13/AdGroupService_rb.html">lib/adwords4r/v13/AdGroupService.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v13/CampaignService_rb.html">lib/adwords4r/v13/CampaignService.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v13/AdService_rb.html">lib/adwords4r/v13/AdService.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v13/CampaignService_rb.html">lib/adwords4r/v13/CampaignService.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v13/CriterionService_rb.html">lib/adwords4r/v13/CriterionService.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v13/InfoService_rb.html">lib/adwords4r/v13/InfoService.rb</a></li>
@@ -131,10 +127,6 @@
             
             <li><a href="../files/lib/adwords4r/v200906/CampaignTargetService_rb.html">lib/adwords4r/v200906/CampaignTargetService.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200906/TargetingIdeaService_rb.html">lib/adwords4r/v200906/TargetingIdeaService.rb</a></li>
-            
-            <li><a href="../files/lib/adwords4r/v200906/InfoService_rb.html">lib/adwords4r/v200906/InfoService.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v200909/AdExtensionOverrideService_rb.html">lib/adwords4r/v200909/AdExtensionOverrideService.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v200909/AdGroupAdService_rb.html">lib/adwords4r/v200909/AdGroupAdService.rb</a></li>
@@ -157,6 +149,8 @@
             
             <li><a href="../files/lib/adwords4r/v200909/InfoService_rb.html">lib/adwords4r/v200909/InfoService.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v200909/AdParamService_rb.html">lib/adwords4r/v200909/AdParamService.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v200909/TargetingIdeaService_rb.html">lib/adwords4r/v200909/TargetingIdeaService.rb</a></li>
             
         </ul>
@@ -181,35 +175,6 @@ Leavengood)
 you may not use this file except in compliance with the License. You may
 obtain a copy of the License at
 
-<p>
-<a
-href="http://www.apache.org/licenses/LICENSE-2.0">www.apache.org/licenses/LICENSE-2.0</a>
-</p>
-<p>
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an &#8220;AS IS&#8221;
-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.
-</p>
-</td></tr>
-</table>
-<p>
-Helper methods for loading and managing the available services.
-</p>
-<hr size="1"></hr><table>
-<tr><td valign="top">Authors:</td><td>sgomes@google.com (Sérgio Gomes) jeffy@google.com (Jeffrey Posnick)
-chanezon@google.com (Patrick Chanezon) leavengood@gmail.com (Ryan
-Leavengood)
-
-</td></tr>
-<tr><td valign="top">Copyright:</td><td>Copyright 2009, Google Inc. All Rights Reserved.
-
-</td></tr>
-<tr><td valign="top">License:</td><td>Licensed under the Apache License, Version 2.0 (the &#8220;License&#8221;);
-you may not use this file except in compliance with the License. You may
-obtain a copy of the License at
-
 <p>
 <a
 href="http://www.apache.org/licenses/LICENSE-2.0">www.apache.org/licenses/LICENSE-2.0</a>

data/doc/classes/AdWords/API.html

@@ -78,7 +78,7 @@ Holds all the services, as well as login credentials.
         <dd>
             <ul>
                 
-                <li><a href="#M000010">service</a></li>
+                <li><a href="#M000009">service</a></li>
                 
             </ul>
         </dd>
@@ -87,7 +87,7 @@ Holds all the services, as well as login credentials.
         <dd>
             <ul>
                 
-                <li><a href="#M000003">use_mcc</a>,</li>
+                <li><a href="#M000002">use_mcc</a>,</li>
                 
                 <li><a href="#M000004">use_mcc=</a></li>
                 
@@ -285,7 +285,7 @@ Returns:
                 <div class="aka">
                     This method is also aliased as
                     
-                    <a href="API.html#M000010">service</a>
+                    <a href="API.html#M000009">service</a>
                     
                 </div>
                 
@@ -338,9 +338,9 @@ Returns:
             </div>
             
             <div class="method">
-                <div class="title" id="M000010">
+                <div class="title" id="M000009">
                     
-                    <a name="M000010"></a><b>service</b>(name, version = nil)
+                    <a name="M000009"></a><b>service</b>(name, version = nil)
                     
                 </div>
                 
@@ -356,9 +356,9 @@ Alias for <a href="API.html#M000007">get_service</a>
             </div>
             
             <div class="method">
-                <div class="title" id="M000003">
+                <div class="title" id="M000002">
                     
-                    <a name="M000003"></a><b>use_mcc</b>()
+                    <a name="M000002"></a><b>use_mcc</b>()
                     
                 </div>
                 
@@ -388,10 +388,10 @@ enabled or disabled
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000002_source')" id="l_M000002_source">show</a>
                         
                     </p>
-                    <div id="M000003_source" class="dyn-source">
+                    <div id="M000002_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 98</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">use_mcc</span>
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>

data/doc/classes/AdWords/AdWordsCredentials.html

@@ -85,7 +85,7 @@ Generic credentials class, used for any <a href="API.html">API</a> version.
         <dd>
             <ul>
                 
-                <li><a href="#M000019">generate_auth_token</a>,</li>
+                <li><a href="#M000020">generate_auth_token</a>,</li>
                 
                 <li><a href="#M000017">get_handlers</a></li>
                 
@@ -450,9 +450,9 @@ href="AdWordsCredentials.html">AdWordsCredentials</a> object
             </div>
             
             <div class="method">
-                <div class="title" id="M000019">
+                <div class="title" id="M000020">
                     
-                    <a name="M000019"></a><b>generate_auth_token</b>()
+                    <a name="M000020"></a><b>generate_auth_token</b>()
                     
                 </div>
                 
@@ -474,10 +474,10 @@ Returns: The auth token (as a string).
                 
                 <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('M000020_source')" id="l_M000020_source">show</a>
                         
                     </p>
-                    <div id="M000019_source" class="dyn-source">
+                    <div id="M000020_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/credentials.rb, line 275</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">generate_auth_token</span>
       <span class="ruby-identifier">email</span> = <span class="ruby-ivar">@credentials</span>[<span class="ruby-value str">'email'</span>]

data/doc/classes/AdWords/AdWordsLogger.html

@@ -56,7 +56,7 @@ Wrapper class to handle logging to console and/or files.
         <dd>
             <ul>
                 
-                <li><a href="#M000041"><<</a></li>
+                <li><a href="#M000043"><<</a></li>
                 
             </ul>
         </dd>
@@ -65,7 +65,7 @@ Wrapper class to handle logging to console and/or files.
         <dd>
             <ul>
                 
-                <li><a href="#M000037">log_to_file</a></li>
+                <li><a href="#M000040">log_to_file</a></li>
                 
             </ul>
         </dd>
@@ -74,7 +74,7 @@ Wrapper class to handle logging to console and/or files.
         <dd>
             <ul>
                 
-                <li><a href="#M000036">new</a></li>
+                <li><a href="#M000039">new</a></li>
                 
             </ul>
         </dd>
@@ -96,9 +96,9 @@ Wrapper class to handle logging to console and/or files.
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000036">
+                <div class="title" id="M000039">
                     
-                    <a name="M000036"></a><b>new</b>(filename, log_to_console=false)
+                    <a name="M000039"></a><b>new</b>(filename, log_to_console=false)
                     
                 </div>
                 
@@ -111,7 +111,7 @@ Args:
 </p>
 <ul>
 <li>filename: the filename for the log file to be written (if <a
-href="AdWordsLogger.html#M000037">log_to_file</a> is called)
+href="AdWordsLogger.html#M000040">log_to_file</a> is called)
 
 </li>
 <li>log_to_console: boolean, indicates whether or not to log to the console
@@ -126,10 +126,10 @@ href="AdWordsLogger.html#M000037">log_to_file</a> is called)
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000036_source')" id="l_M000036_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000039_source')" id="l_M000039_source">show</a>
                         
                     </p>
-                    <div id="M000036_source" class="dyn-source">
+                    <div id="M000039_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/adwordslogger.rb, line 36</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">log_to_console</span>=<span class="ruby-keyword kw">false</span>)
       <span class="ruby-ivar">@filename</span> = <span class="ruby-identifier">filename</span>
@@ -148,9 +148,9 @@ href="AdWordsLogger.html#M000037">log_to_file</a> is called)
             <div class="sectiontitle">Instance Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000041">
+                <div class="title" id="M000043">
                     
-                    <a name="M000041"></a><b>&lt;&lt;</b>(text)
+                    <a name="M000043"></a><b>&lt;&lt;</b>(text)
                     
                 </div>
                 
@@ -166,10 +166,10 @@ Overload << operator to perform logging.
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000041_source')" id="l_M000041_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">show</a>
                         
                     </p>
-                    <div id="M000041_source" class="dyn-source">
+                    <div id="M000043_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/adwordslogger.rb, line 62</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">text</span>)
       <span class="ruby-ivar">@loggers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">logger</span><span class="ruby-operator">|</span>
@@ -182,9 +182,9 @@ Overload << operator to perform logging.
             </div>
             
             <div class="method">
-                <div class="title" id="M000037">
+                <div class="title" id="M000040">
                     
-                    <a name="M000037"></a><b>log_to_file</b>(path='.')
+                    <a name="M000040"></a><b>log_to_file</b>(path='.')
                     
                 </div>
                 
@@ -210,10 +210,10 @@ provide filename.
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000037_source')" id="l_M000037_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000040_source')" id="l_M000040_source">show</a>
                         
                     </p>
-                    <div id="M000037_source" class="dyn-source">
+                    <div id="M000040_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/adwordslogger.rb, line 53</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">log_to_file</span>(<span class="ruby-identifier">path</span>=<span class="ruby-value str">'.'</span>)
       <span class="ruby-identifier">new_logger</span> = <span class="ruby-constant">Logger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">path</span>, <span class="ruby-ivar">@filename</span>))

data/doc/classes/AdWords/AuthToken.html

@@ -52,7 +52,7 @@ v200902).
         <dd>
             <ul>
                 
-                <li><a href="#M000056">get_token</a></li>
+                <li><a href="#M000055">get_token</a></li>
                 
             </ul>
         </dd>
@@ -100,9 +100,9 @@ v200902).
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000056">
+                <div class="title" id="M000055">
                     
-                    <a name="M000056"></a><b>get_token</b>(email, password, hostname, port, use_ssl)
+                    <a name="M000055"></a><b>get_token</b>(email, password, hostname, port, use_ssl)
                     
                 </div>
                 
@@ -146,10 +146,10 @@ authentication fails.
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000056_source')" id="l_M000056_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000055_source')" id="l_M000055_source">show</a>
                         
                     </p>
-                    <div id="M000056_source" class="dyn-source">
+                    <div id="M000055_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/authtoken.rb, line 53</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">get_token</span>(<span class="ruby-identifier">email</span>, <span class="ruby-identifier">password</span>, <span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">port</span>, <span class="ruby-identifier">use_ssl</span>)
       <span class="ruby-identifier">email</span> = <span class="ruby-constant">CGI</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-identifier">email</span>)

data/doc/classes/AdWords/Error.html

@@ -57,7 +57,7 @@ Ruby objects
         <dd>
             <ul>
                 
-                <li><a href="#M000020">create_specific_api_error</a></li>
+                <li><a href="#M000019">create_specific_api_error</a></li>
                 
             </ul>
         </dd>
@@ -106,9 +106,9 @@ Ruby objects
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000020">
+                <div class="title" id="M000019">
                     
-                    <a name="M000020"></a><b>create_specific_api_error</b>(soap_fault)
+                    <a name="M000019"></a><b>create_specific_api_error</b>(soap_fault)
                     
                 </div>
                 
@@ -137,10 +137,10 @@ href="Error/ApiError.html">ApiError</a>
                 
                 <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('M000019_source')" id="l_M000019_source">show</a>
                         
                     </p>
-                    <div id="M000020_source" class="dyn-source">
+                    <div id="M000019_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 307</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">create_specific_api_error</span>(<span class="ruby-identifier">soap_fault</span>)
       <span class="ruby-identifier">error</span> = <span class="ruby-ivar">@@api_errors</span>[<span class="ruby-identifier">soap_fault</span>.<span class="ruby-identifier">faultcode</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">to_i</span>]

data/doc/classes/AdWords/Error/ApiError.html

@@ -57,7 +57,7 @@ adwords error fields
         <dd>
             <ul>
                 
-                <li><a href="#M000025">new</a></li>
+                <li><a href="#M000023">new</a></li>
                 
             </ul>
         </dd>
@@ -226,9 +226,9 @@ backward compatibility; hopefully this isn&#8217;t too confusing!
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000025">
+                <div class="title" id="M000023">
                     
-                    <a name="M000025"></a><b>new</b>(soap_fault)
+                    <a name="M000023"></a><b>new</b>(soap_fault)
                     
                 </div>
                 
@@ -252,10 +252,10 @@ Args:
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000025_source')" id="l_M000025_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000023_source')" id="l_M000023_source">show</a>
                         
                     </p>
-                    <div id="M000025_source" class="dyn-source">
+                    <div id="M000023_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r.rb, line 369</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">soap_fault</span>)
         <span class="ruby-ivar">@soap_faultcode</span> = <span class="ruby-identifier">protect</span> { <span class="ruby-identifier">soap_fault</span>.<span class="ruby-identifier">faultcode</span> }