google-dfp-api 0.2.2 → 0.2.3

data/ChangeLog

@@ -1,3 +1,6 @@
+0.2.3:
+  - Support for v201107.
+
 0.2.2:
   - Support for OAuth authentication method.
   - Require google-ads-common 0.5.0 or later from now on.

data/examples/v201101/company_service/create_companies.rb

@@ -18,7 +18,7 @@
 #           limitations under the License.
 #
 # This example creates new companies. To determine which companies exist, run
-# get_all_companies.java.
+# get_all_companies.rb.
 
 # Tags: CompanyService.createCompanies
 
@@ -41,9 +41,8 @@ def create_companies()
   company_service = dfp.service(:CompanyService, API_VERSION)
 
   # Create an array to store local company objects.
-  companies = []
-  ITEM_COUNT.times do |index|
-    companies << {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
+  companies = (1..ITEM_COUNT).map do |index|
+    {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
   end
 
   # Create the companies on the server.

data/examples/v201101/company_service/update_companies.rb

@@ -19,9 +19,9 @@
 #
 # This example updates the names of all companies that are advertisers by
 # appending "LLC." up to the first 500. To determine which companies exist, run
-# get_all_companies.rb
+# get_all_companies.rb.
 #
-# Tags: CompanyService.updateCompanies
+# Tags: CompanyService.getCompaniesByStatement, CompanyService.updateCompanies
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201101/creative_service/create_creatives.rb

@@ -53,17 +53,14 @@ def create_creatives()
   image_data_base64 = Base64.encode64(image_data)
 
   # Create an array to store local creative objects.
-  creatives = []
-  ITEM_COUNT.times do |index|
-    creatives << {
-        :xsi_type => 'ImageCreative',
-        :name => "Image creative #%d" % index,
-        :advertiser_id => advertiser_id,
-        :destination_url => 'http://www.google.com',
-        :image_name => 'image.jpg',
-        :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
-        :image_byte_array => image_data_base64
-    }
+  creatives = (1..ITEM_COUNT).map do |index|
+    {:xsi_type => 'ImageCreative',
+     :name => "Image creative #%d" % index,
+     :advertiser_id => advertiser_id,
+     :destination_url => 'http://www.google.com',
+     :image_name => 'image.jpg',
+     :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
+     :image_byte_array => image_data_base64}
   end
 
   # Create the creatives on the server.

data/examples/v201101/inventory_service/create_ad_units.rb

@@ -51,16 +51,13 @@ def create_ad_units()
   puts "Using effective root ad unit: %d" % effective_root_ad_unit_id
 
   # Create an array to store local ad unit objects.
-  ad_units = []
-  ITEM_COUNT.times do |index|
-    ad_units << {
-        :name => "Ad_Unit_%d" % index,
-        :parent_id => effective_root_ad_unit_id,
-        :description => 'Ad unit description.',
-        :target_window => 'BLANK',
-        # Set the size of possible creatives that can match this ad unit.
-        :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]
-    }
+  ad_units = (1..ITEM_COUNT).map do |index|
+    {:name => "Ad_Unit_%d" % index,
+     :parent_id => effective_root_ad_unit_id,
+     :description => 'Ad unit description.',
+     :target_window => 'BLANK',
+     # Set the size of possible creatives that can match this ad unit.
+     :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]}
   end
 
   # Create the ad units on the server.

data/examples/v201101/inventory_service/update_ad_units.rb

@@ -21,7 +21,7 @@
 # determine which ad units exist, run get_all_ad_units.rb or
 # get_inventory_tree.rb.
 #
-# Tags: InventoryService.updateAdUnits
+# Tags: InventoryService.getAdUnitsByStatement, InventoryService.updateAdUnits
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201101/line_item_service/create_line_items.rb

@@ -72,8 +72,7 @@ def create_line_items()
                :inventory_targeting => inventory_targeting}
 
   # Create an array to store local line item objects.
-  line_items = []
-  ITEM_COUNT.times do |index|
+  line_items = (1..ITEM_COUNT).map do |index|
     line_item = {:name => "Line item #%d" % index,
                  :order_id => order_id,
                  :targeting => targeting,
@@ -102,7 +101,7 @@ def create_line_items()
     line_item[:units_bought] = 500000
     line_item[:unit_type] = 'IMPRESSIONS'
 
-    line_items << line_item
+    line_item
   end
 
   # Create the line items on the server.

data/examples/v201101/line_item_service/update_line_items.rb

@@ -21,7 +21,7 @@
 # the first 500. To determine which line items exist, run get_all_line_items.rb.
 # To determine which order exist, run get_all_orders.rb.
 #
-# Tags: LineItemService.updateLineItems
+# Tags: LineItemService.getLineItemsByStatement, LineItemService.updateLineItems
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201101/order_service/create_orders.rb

@@ -49,12 +49,11 @@ def create_orders()
   trafficker_id = 'INSERT_TRAFFICKER_ID_HERE'.to_i
 
   # Create an array to store local order objects.
-  orders = []
-  ITEM_COUNT.times do |index|
-    orders << {:name => "Order #%d" % index,
-               :advertiser_id => advertiser_id,
-               :salesperson_id => salesperson_id,
-               :trafficker_id => trafficker_id}
+  orders = (1..ITEM_COUNT).map do |index|
+    {:name => "Order #%d" % index,
+     :advertiser_id => advertiser_id,
+     :salesperson_id => salesperson_id,
+     :trafficker_id => trafficker_id}
   end
 
   # Create the orders on the server.

data/examples/v201101/order_service/update_orders.rb

@@ -20,7 +20,7 @@
 # This example updates the notes of each order up to the first 500.
 # To determine which orders exist, run get_all_orders.rb.
 #
-# Tags: OrderService.updateOrders
+# Tags: OrderService.getOrdersByStatement, OrderService.updateOrders
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201101/placement_service/create_placements.rb

@@ -19,7 +19,7 @@
 #
 # This example creates new placements for various ad unit sizes. To determine
 # which placements exist, run get_all_placements.rb.
-
+#
 # Tags: PlacementService.createPlacements,
 #       InventoryService.getAdUnitsByStatement
 

data/examples/v201101/placement_service/update_placements.rb

@@ -20,7 +20,8 @@
 # This example updates all placements to allow for AdSense targeting up to the
 # first 500. To determine which placements exist, run get_all_placements.rb.
 #
-# Tags: PlacementService.updatePlacements
+# Tags: PlacementService.getPlacementsByStatement,
+#       PlacementService.updatePlacements
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201101/user_service/update_users.rb

@@ -21,7 +21,7 @@
 # a very large baby boom and lack of creativity). To determine which users
 # exist, run get_all_users.rb.
 #
-# Tags: UserService.updateUsers
+# Tags: UserService.getUsersByStatement, UserService.updateUsers
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/company_service/create_companies.rb

@@ -18,7 +18,7 @@
 #           limitations under the License.
 #
 # This example creates new companies. To determine which companies exist, run
-# get_all_companies.java.
+# get_all_companies.rb.
 
 # Tags: CompanyService.createCompanies
 
@@ -41,9 +41,8 @@ def create_companies()
   company_service = dfp.service(:CompanyService, API_VERSION)
 
   # Create an array to store local company objects.
-  companies = []
-  ITEM_COUNT.times do |index|
-    companies << {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
+  companies = (1..ITEM_COUNT).map do |index|
+    {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
   end
 
   # Create the companies on the server.

data/examples/v201103/company_service/update_companies.rb

@@ -19,9 +19,9 @@
 #
 # This example updates the names of all companies that are advertisers by
 # appending "LLC." up to the first 500. To determine which companies exist, run
-# get_all_companies.rb
+# get_all_companies.rb.
 #
-# Tags: CompanyService.updateCompanies
+# Tags: CompanyService.getCompaniesByStatement, CompanyService.updateCompanies
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/creative_service/create_creatives.rb

@@ -53,17 +53,14 @@ def create_creatives()
   image_data_base64 = Base64.encode64(image_data)
 
   # Create an array to store local creative objects.
-  creatives = []
-  ITEM_COUNT.times do |index|
-    creatives << {
-        :xsi_type => 'ImageCreative',
-        :name => "Image creative #%d" % index,
-        :advertiser_id => advertiser_id,
-        :destination_url => 'http://www.google.com',
-        :image_name => 'image.jpg',
-        :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
-        :image_byte_array => image_data_base64
-    }
+  creatives = (1..ITEM_COUNT).map do |index|
+    {:xsi_type => 'ImageCreative',
+     :name => "Image creative #%d" % index,
+     :advertiser_id => advertiser_id,
+     :destination_url => 'http://www.google.com',
+     :image_name => 'image.jpg',
+     :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
+     :image_byte_array => image_data_base64}
   end
 
   # Create the creatives on the server.

data/examples/v201103/inventory_service/create_ad_units.rb

@@ -51,16 +51,13 @@ def create_ad_units()
   puts "Using effective root ad unit: %d" % effective_root_ad_unit_id
 
   # Create an array to store local ad unit objects.
-  ad_units = []
-  ITEM_COUNT.times do |index|
-    ad_units << {
-        :name => "Ad_Unit_%d" % index,
-        :parent_id => effective_root_ad_unit_id,
-        :description => 'Ad unit description.',
-        :target_window => 'BLANK',
-        # Set the size of possible creatives that can match this ad unit.
-        :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]
-    }
+  ad_units = (1..ITEM_COUNT).map do |index|
+    {:name => "Ad_Unit_%d" % index,
+     :parent_id => effective_root_ad_unit_id,
+     :description => 'Ad unit description.',
+     :target_window => 'BLANK',
+     # Set the size of possible creatives that can match this ad unit.
+     :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]}
   end
 
   # Create the ad units on the server.

data/examples/v201103/inventory_service/update_ad_units.rb

@@ -21,7 +21,7 @@
 # determine which ad units exist, run get_all_ad_units.rb or
 # get_inventory_tree.rb.
 #
-# Tags: InventoryService.updateAdUnits
+# Tags: InventoryService.getAdUnitsByStatement, InventoryService.updateAdUnits
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/line_item_service/create_line_items.rb

@@ -96,8 +96,7 @@ def create_line_items()
   }
 
   # Create an array to store local line item objects.
-  line_items = []
-  ITEM_COUNT.times do |index|
+  line_items = (1..ITEM_COUNT).map do |index|
     line_item = {:name => "Line item #%d" % index,
                  :order_id => order_id,
                  :targeting => targeting,
@@ -126,7 +125,7 @@ def create_line_items()
     line_item[:units_bought] = 500000
     line_item[:unit_type] = 'IMPRESSIONS'
 
-    line_items << line_item
+    line_item
   end
 
   # Create the line items on the server.

data/examples/v201103/line_item_service/update_line_items.rb

@@ -21,7 +21,7 @@
 # the first 500. To determine which line items exist, run get_all_line_items.rb.
 # To determine which order exist, run get_all_orders.rb.
 #
-# Tags: LineItemService.updateLineItems
+# Tags: LineItemService.getLineItemsByStatement, LineItemService.updateLineItems
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/order_service/create_orders.rb

@@ -49,12 +49,11 @@ def create_orders()
   trafficker_id = 'INSERT_TRAFFICKER_ID_HERE'.to_i
 
   # Create an array to store local order objects.
-  orders = []
-  ITEM_COUNT.times do |index|
-    orders << {:name => "Order #%d" % index,
-               :advertiser_id => advertiser_id,
-               :salesperson_id => salesperson_id,
-               :trafficker_id => trafficker_id}
+  orders = (1..ITEM_COUNT).map do |index|
+    {:name => "Order #%d" % index,
+     :advertiser_id => advertiser_id,
+     :salesperson_id => salesperson_id,
+     :trafficker_id => trafficker_id}
   end
 
   # Create the orders on the server.

data/examples/v201103/order_service/update_orders.rb

@@ -20,7 +20,7 @@
 # This example updates the notes of each order up to the first 500.
 # To determine which orders exist, run get_all_orders.rb.
 #
-# Tags: OrderService.updateOrders
+# Tags: OrderService.getOrdersByStatement, OrderService.updateOrders
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/placement_service/create_placements.rb

@@ -19,7 +19,7 @@
 #
 # This example creates new placements for various ad unit sizes. To determine
 # which placements exist, run get_all_placements.rb.
-
+#
 # Tags: PlacementService.createPlacements,
 #       InventoryService.getAdUnitsByStatement
 

data/examples/v201103/placement_service/update_placements.rb

@@ -20,7 +20,8 @@
 # This example updates all placements to allow for AdSense targeting up to the
 # first 500. To determine which placements exist, run get_all_placements.rb.
 #
-# Tags: PlacementService.updatePlacements
+# Tags: PlacementService.getPlacementsByStatement,
+#       PlacementService.updatePlacements
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201103/user_service/update_users.rb

@@ -21,7 +21,7 @@
 # a very large baby boom and lack of creativity). To determine which users
 # exist, run get_all_users.rb.
 #
-# Tags: UserService.updateUsers
+# Tags: UserService.getUsersByStatement, UserService.updateUsers
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201104/company_service/create_companies.rb

@@ -18,7 +18,7 @@
 #           limitations under the License.
 #
 # This example creates new companies. To determine which companies exist, run
-# get_all_companies.java.
+# get_all_companies.rb.
 
 # Tags: CompanyService.createCompanies
 
@@ -41,9 +41,8 @@ def create_companies()
   company_service = dfp.service(:CompanyService, API_VERSION)
 
   # Create an array to store local company objects.
-  companies = []
-  ITEM_COUNT.times do |index|
-    companies << {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
+  companies = (1..ITEM_COUNT).map do |index|
+    {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
   end
 
   # Create the companies on the server.

data/examples/v201104/company_service/update_companies.rb

@@ -19,9 +19,9 @@
 #
 # This example updates the names of all companies that are advertisers by
 # appending "LLC." up to the first 500. To determine which companies exist, run
-# get_all_companies.rb
+# get_all_companies.rb.
 #
-# Tags: CompanyService.updateCompanies
+# Tags: CompanyService.getCompaniesByStatement, CompanyService.updateCompanies
 
 require 'rubygems'
 require 'dfp_api'

data/examples/v201104/creative_service/create_creatives.rb

@@ -53,17 +53,14 @@ def create_creatives()
   image_data_base64 = Base64.encode64(image_data)
 
   # Create an array to store local creative objects.
-  creatives = []
-  ITEM_COUNT.times do |index|
-    creatives << {
-        :xsi_type => 'ImageCreative',
-        :name => "Image creative #%d" % index,
-        :advertiser_id => advertiser_id,
-        :destination_url => 'http://www.google.com',
-        :image_name => 'image.jpg',
-        :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
-        :image_byte_array => image_data_base64
-    }
+  creatives = (1..ITEM_COUNT).map do |index|
+    {:xsi_type => 'ImageCreative',
+     :name => "Image creative #%d" % index,
+     :advertiser_id => advertiser_id,
+     :destination_url => 'http://www.google.com',
+     :image_name => 'image.jpg',
+     :size => {:width => 300, :height => 250, :is_aspect_ratio => false},
+     :image_byte_array => image_data_base64}
   end
 
   # Create the creatives on the server.

data/examples/v201104/inventory_service/create_ad_units.rb

@@ -51,16 +51,13 @@ def create_ad_units()
   puts "Using effective root ad unit: %d" % effective_root_ad_unit_id
 
   # Create an array to store local ad unit objects.
-  ad_units = []
-  ITEM_COUNT.times do |index|
-    ad_units << {
-        :name => "Ad_Unit_%d" % index,
-        :parent_id => effective_root_ad_unit_id,
-        :description => 'Ad unit description.',
-        :target_window => 'BLANK',
-        # Set the size of possible creatives that can match this ad unit.
-        :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]
-    }
+  ad_units = (1..ITEM_COUNT).map do |index|
+    {:name => "Ad_Unit_%d" % index,
+     :parent_id => effective_root_ad_unit_id,
+     :description => 'Ad unit description.',
+     :target_window => 'BLANK',
+     # Set the size of possible creatives that can match this ad unit.
+     :sizes => [{:width => 300, :height => 250, :is_aspect_ratio => false}]}
   end
 
   # Create the ad units on the server.