adwords4r 17.1.0 → 17.2.0

data/ChangeLog.txt

@@ -1,3 +1,6 @@
+17.2.0
+- Added new set of code samples for v200909.
+
 17.1.0
 - Added support for AdParamService in v200909.
 - Improved request logging, by adding isFault and faultMessage.

data/Rakefile

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

data/doc/classes/AdWords.html

@@ -59,18 +59,18 @@
             
             <li><a href="../files/lib/adwords4r/v200906/AdGroupAdServiceWrapper_rb.html">lib/adwords4r/v200906/AdGroupAdServiceWrapper.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200906/AdGroupCriterionServiceWrapper_rb.html">lib/adwords4r/v200906/AdGroupCriterionServiceWrapper.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v200906/AdGroupServiceWrapper_rb.html">lib/adwords4r/v200906/AdGroupServiceWrapper.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v200906/AdGroupCriterionServiceWrapper_rb.html">lib/adwords4r/v200906/AdGroupCriterionServiceWrapper.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v200906/CampaignCriterionServiceWrapper_rb.html">lib/adwords4r/v200906/CampaignCriterionServiceWrapper.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v200906/CampaignServiceWrapper_rb.html">lib/adwords4r/v200906/CampaignServiceWrapper.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200906/CampaignTargetServiceWrapper_rb.html">lib/adwords4r/v200906/CampaignTargetServiceWrapper.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/v200906/CampaignTargetServiceWrapper_rb.html">lib/adwords4r/v200906/CampaignTargetServiceWrapper.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v200909/AdGroupAdServiceWrapper_rb.html">lib/adwords4r/v200909/AdGroupAdServiceWrapper.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v200909/AdGroupCriterionServiceWrapper_rb.html">lib/adwords4r/v200909/AdGroupCriterionServiceWrapper.rb</a></li>
@@ -79,26 +79,26 @@
             
             <li><a href="../files/lib/adwords4r/v200909/BulkMutateJobServiceWrapper_rb.html">lib/adwords4r/v200909/BulkMutateJobServiceWrapper.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200909/CampaignAdExtensionServiceWrapper_rb.html">lib/adwords4r/v200909/CampaignAdExtensionServiceWrapper.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v200909/CampaignCriterionServiceWrapper_rb.html">lib/adwords4r/v200909/CampaignCriterionServiceWrapper.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v200909/CampaignAdExtensionServiceWrapper_rb.html">lib/adwords4r/v200909/CampaignAdExtensionServiceWrapper.rb</a></li>
+            
             <li><a href="../files/lib/adwords4r/v200909/CampaignServiceWrapper_rb.html">lib/adwords4r/v200909/CampaignServiceWrapper.rb</a></li>
             
             <li><a href="../files/lib/adwords4r/v200909/CampaignTargetServiceWrapper_rb.html">lib/adwords4r/v200909/CampaignTargetServiceWrapper.rb</a></li>
             
-            <li><a href="../files/lib/adwords4r/v200909/GeoLocationServiceWrapper_rb.html">lib/adwords4r/v200909/GeoLocationServiceWrapper.rb</a></li>
-            
             <li><a href="../files/lib/adwords4r/v200909/InfoServiceWrapper_rb.html">lib/adwords4r/v200909/InfoServiceWrapper.rb</a></li>
             
+            <li><a href="../files/lib/adwords4r/v200909/GeoLocationServiceWrapper_rb.html">lib/adwords4r/v200909/GeoLocationServiceWrapper.rb</a></li>
+            
             <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/AccountService_rb.html">lib/adwords4r/v13/AccountService.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>
@@ -149,10 +149,10 @@
             
             <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>
             
+            <li><a href="../files/lib/adwords4r/v200909/AdParamService_rb.html">lib/adwords4r/v200909/AdParamService.rb</a></li>
+            
         </ul>
     </div>
     <div id="bodyContent">

data/doc/classes/AdWords/API.html

@@ -78,7 +78,7 @@ Holds all the services, as well as login credentials.
         <dd>
             <ul>
                 
-                <li><a href="#M000009">service</a></li>
+                <li><a href="#M000010">service</a></li>
                 
             </ul>
         </dd>
@@ -87,7 +87,7 @@ Holds all the services, as well as login credentials.
         <dd>
             <ul>
                 
-                <li><a href="#M000002">use_mcc</a>,</li>
+                <li><a href="#M000003">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#M000009">service</a>
+                    <a href="API.html#M000010">service</a>
                     
                 </div>
                 
@@ -338,9 +338,9 @@ Returns:
             </div>
             
             <div class="method">
-                <div class="title" id="M000009">
+                <div class="title" id="M000010">
                     
-                    <a name="M000009"></a><b>service</b>(name, version = nil)
+                    <a name="M000010"></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="M000002">
+                <div class="title" id="M000003">
                     
-                    <a name="M000002"></a><b>use_mcc</b>()
+                    <a name="M000003"></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('M000002_source')" id="l_M000002_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show</a>
                         
                     </p>
-                    <div id="M000002_source" class="dyn-source">
+                    <div id="M000003_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="#M000020">generate_auth_token</a>,</li>
+                <li><a href="#M000019">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="M000020">
+                <div class="title" id="M000019">
                     
-                    <a name="M000020"></a><b>generate_auth_token</b>()
+                    <a name="M000019"></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('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/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="#M000043"><<</a></li>
+                <li><a href="#M000048"><<</a></li>
                 
             </ul>
         </dd>
@@ -65,7 +65,7 @@ Wrapper class to handle logging to console and/or files.
         <dd>
             <ul>
                 
-                <li><a href="#M000040">log_to_file</a></li>
+                <li><a href="#M000046">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="#M000039">new</a></li>
+                <li><a href="#M000045">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="M000039">
+                <div class="title" id="M000045">
                     
-                    <a name="M000039"></a><b>new</b>(filename, log_to_console=false)
+                    <a name="M000045"></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#M000040">log_to_file</a> is called)
+href="AdWordsLogger.html#M000046">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#M000040">log_to_file</a> is called)
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000039_source')" id="l_M000039_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show</a>
                         
                     </p>
-                    <div id="M000039_source" class="dyn-source">
+                    <div id="M000045_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#M000040">log_to_file</a> is called)
             <div class="sectiontitle">Instance Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000043">
+                <div class="title" id="M000048">
                     
-                    <a name="M000043"></a><b>&lt;&lt;</b>(text)
+                    <a name="M000048"></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('M000043_source')" id="l_M000043_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">show</a>
                         
                     </p>
-                    <div id="M000043_source" class="dyn-source">
+                    <div id="M000048_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="M000040">
+                <div class="title" id="M000046">
                     
-                    <a name="M000040"></a><b>log_to_file</b>(path='.')
+                    <a name="M000046"></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('M000040_source')" id="l_M000040_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show</a>
                         
                     </p>
-                    <div id="M000040_source" class="dyn-source">
+                    <div id="M000046_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="#M000055">get_token</a></li>
+                <li><a href="#M000054">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="M000055">
+                <div class="title" id="M000054">
                     
-                    <a name="M000055"></a><b>get_token</b>(email, password, hostname, port, use_ssl)
+                    <a name="M000054"></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('M000055_source')" id="l_M000055_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000054_source')" id="l_M000054_source">show</a>
                         
                     </p>
-                    <div id="M000055_source" class="dyn-source">
+                    <div id="M000054_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="#M000019">create_specific_api_error</a></li>
+                <li><a href="#M000020">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="M000019">
+                <div class="title" id="M000020">
                     
-                    <a name="M000019"></a><b>create_specific_api_error</b>(soap_fault)
+                    <a name="M000020"></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('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.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="#M000023">new</a></li>
+                <li><a href="#M000024">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="M000023">
+                <div class="title" id="M000024">
                     
-                    <a name="M000023"></a><b>new</b>(soap_fault)
+                    <a name="M000024"></a><b>new</b>(soap_fault)
                     
                 </div>
                 
@@ -252,10 +252,10 @@ Args:
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000023_source')" id="l_M000023_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000024_source')" id="l_M000024_source">show</a>
                         
                     </p>
-                    <div id="M000023_source" class="dyn-source">
+                    <div id="M000024_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> }

data/doc/classes/AdWords/Extensions.html

@@ -43,7 +43,7 @@
         <dd>
             <ul>
                 
-                <li><a href="#M000054">downloadCsvReport</a>,</li>
+                <li><a href="#M000055">downloadCsvReport</a>,</li>
                 
                 <li><a href="#M000053">downloadXmlReport</a></li>
                 
@@ -96,9 +96,9 @@
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000054">
+                <div class="title" id="M000055">
                     
-                    <a name="M000054"></a><b>downloadCsvReport</b>(wrapper, job_id, report_xml=nil)
+                    <a name="M000055"></a><b>downloadCsvReport</b>(wrapper, job_id, report_xml=nil)
                     
                 </div>
                 
@@ -136,10 +136,10 @@ Returns: The CSV data for the report (as a string)
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000054_source')" id="l_M000054_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000055_source')" id="l_M000055_source">show</a>
                         
                     </p>
-                    <div id="M000054_source" class="dyn-source">
+                    <div id="M000055_source" class="dyn-source">
                         <pre><span class="ruby-comment cmt"># File lib/adwords4r/apiextensions.rb, line 121</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">downloadCsvReport</span>(<span class="ruby-identifier">wrapper</span>, <span class="ruby-identifier">job_id</span>, <span class="ruby-identifier">report_xml</span>=<span class="ruby-keyword kw">nil</span>)
       <span class="ruby-comment cmt"># Get XML report data.</span>

data/doc/classes/AdWords/Generator.html

@@ -50,7 +50,7 @@ Contains the methods that handle wrapper code generation.
         <dd>
             <ul>
                 
-                <li><a href="#M000072">generate_wrapper_class</a></li>
+                <li><a href="#M000073">generate_wrapper_class</a></li>
                 
             </ul>
         </dd>
@@ -84,9 +84,9 @@ Contains the methods that handle wrapper code generation.
             <div class="sectiontitle">Class Public methods</div>
             
             <div class="method">
-                <div class="title" id="M000072">
+                <div class="title" id="M000073">
                     
-                    <a name="M000072"></a><b>generate_wrapper_class</b>(version, service)
+                    <a name="M000073"></a><b>generate_wrapper_class</b>(version, service)
                     
                 </div>
                 
@@ -148,10 +148,10 @@ Returns: The Ruby code for the class, as a string.
                 
                 <div class="sourcecode">
                     <p class="source-link">
-                        Source: <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show</a>
+                        Source: <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">show</a>
                         
                     </p>
-                    <div id="M000072_source" class="dyn-source">
+                    <div id="M000073_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>