google-dfp-api 0.2.0 → 0.2.1
Sign up to get free protection for your applications and to get access to all the features.
- data/ChangeLog +7 -1
- data/README +11 -11
- data/Rakefile +13 -11
- data/examples/v201103/common/error_handling.rb +76 -0
- data/examples/v201103/company_service/create_companies.rb +82 -0
- data/examples/v201103/company_service/get_all_companies.rb +92 -0
- data/examples/v201103/company_service/get_companies_by_statement.rb +88 -0
- data/examples/v201103/company_service/get_company.rb +72 -0
- data/examples/v201103/company_service/update_companies.rb +95 -0
- data/examples/v201103/creative_service/copy_image_creatives.rb +117 -0
- data/examples/v201103/creative_service/create_creatives.rb +109 -0
- data/examples/v201103/creative_service/get_all_creatives.rb +93 -0
- data/examples/v201103/creative_service/get_creative.rb +72 -0
- data/examples/v201103/creative_service/get_creatives_by_statement.rb +87 -0
- data/examples/v201103/creative_service/update_creatives.rb +98 -0
- data/examples/v201103/custom_targeting_service/create_custom_targeting_keys_and_values.rb +118 -0
- data/examples/v201103/custom_targeting_service/delete_custom_targeting_keys.rb +121 -0
- data/examples/v201103/custom_targeting_service/delete_custom_targeting_values.rb +125 -0
- data/examples/v201103/custom_targeting_service/get_all_custom_targeting_keys_and_values.rb +148 -0
- data/examples/v201103/custom_targeting_service/get_custom_targeting_keys_by_statement.rb +92 -0
- data/examples/v201103/custom_targeting_service/get_custom_targeting_values_by_statement.rb +98 -0
- data/examples/v201103/custom_targeting_service/update_custom_targeting_keys.rb +94 -0
- data/examples/v201103/custom_targeting_service/update_custom_targeting_values.rb +106 -0
- data/examples/v201103/forecast_service/get_forecast.rb +103 -0
- data/examples/v201103/forecast_service/get_forecast_by_id.rb +80 -0
- data/examples/v201103/inventory_service/create_ad_units.rb +98 -0
- data/examples/v201103/inventory_service/deactivate_ad_units.rb +119 -0
- data/examples/v201103/inventory_service/get_ad_unit.rb +72 -0
- data/examples/v201103/inventory_service/get_ad_units_by_statement.rb +96 -0
- data/examples/v201103/inventory_service/get_all_ad_units.rb +93 -0
- data/examples/v201103/inventory_service/update_ad_units.rb +94 -0
- data/examples/v201103/line_item_creative_association_service/create_licas.rb +94 -0
- data/examples/v201103/line_item_creative_association_service/deactivate_licas.rb +127 -0
- data/examples/v201103/line_item_creative_association_service/get_all_licas.rb +95 -0
- data/examples/v201103/line_item_creative_association_service/get_lica.rb +77 -0
- data/examples/v201103/line_item_creative_association_service/get_licas_by_statement.rb +91 -0
- data/examples/v201103/line_item_creative_association_service/update_licas.rb +92 -0
- data/examples/v201103/line_item_service/activate_line_items.rb +131 -0
- data/examples/v201103/line_item_service/create_line_items.rb +165 -0
- data/examples/v201103/line_item_service/get_all_line_items.rb +94 -0
- data/examples/v201103/line_item_service/get_line_item.rb +74 -0
- data/examples/v201103/line_item_service/get_line_items_by_statement.rb +89 -0
- data/examples/v201103/line_item_service/target_custom_criteria.rb +135 -0
- data/examples/v201103/line_item_service/update_line_items.rb +110 -0
- data/examples/v201103/network_service/get_all_networks.rb +74 -0
- data/examples/v201103/network_service/get_current_network.rb +66 -0
- data/examples/v201103/order_service/approve_orders.rb +116 -0
- data/examples/v201103/order_service/create_orders.rb +93 -0
- data/examples/v201103/order_service/get_all_orders.rb +93 -0
- data/examples/v201103/order_service/get_order.rb +74 -0
- data/examples/v201103/order_service/get_orders_by_statement.rb +90 -0
- data/examples/v201103/order_service/update_orders.rb +95 -0
- data/examples/v201103/placement_service/create_placements.rb +128 -0
- data/examples/v201103/placement_service/deactivate_placements.rb +118 -0
- data/examples/v201103/placement_service/get_all_placements.rb +93 -0
- data/examples/v201103/placement_service/get_placement.rb +74 -0
- data/examples/v201103/placement_service/get_placements_by_statement.rb +86 -0
- data/examples/v201103/placement_service/update_placements.rb +96 -0
- data/examples/v201103/publisher_query_language_service/get_all_cities.rb +85 -0
- data/examples/v201103/publisher_query_language_service/get_all_countries.rb +85 -0
- data/examples/v201103/publisher_query_language_service/get_all_metros.rb +85 -0
- data/examples/v201103/publisher_query_language_service/get_all_regions.rb +85 -0
- data/examples/v201103/report_service/download_report.rb +81 -0
- data/examples/v201103/report_service/run_delivery_report.rb +89 -0
- data/examples/v201103/report_service/run_inventory_report.rb +90 -0
- data/examples/v201103/report_service/run_sales_report.rb +89 -0
- data/examples/v201103/user_service/create_users.rb +89 -0
- data/examples/v201103/user_service/deactivate_users.rb +99 -0
- data/examples/v201103/user_service/get_all_roles.rb +73 -0
- data/examples/v201103/user_service/get_all_users.rb +92 -0
- data/examples/v201103/user_service/get_user.rb +73 -0
- data/examples/v201103/user_service/get_users_by_statement.rb +79 -0
- data/examples/v201103/user_service/update_users.rb +89 -0
- data/examples/v201104/common/error_handling.rb +76 -0
- data/examples/v201104/company_service/create_companies.rb +82 -0
- data/examples/v201104/company_service/get_all_companies.rb +92 -0
- data/examples/v201104/company_service/get_companies_by_statement.rb +88 -0
- data/examples/v201104/company_service/get_company.rb +72 -0
- data/examples/v201104/company_service/update_companies.rb +95 -0
- data/examples/v201104/creative_service/copy_image_creatives.rb +117 -0
- data/examples/v201104/creative_service/create_creatives.rb +109 -0
- data/examples/v201104/creative_service/get_all_creatives.rb +93 -0
- data/examples/v201104/creative_service/get_creative.rb +72 -0
- data/examples/v201104/creative_service/get_creatives_by_statement.rb +87 -0
- data/examples/v201104/creative_service/update_creatives.rb +98 -0
- data/examples/v201104/custom_targeting_service/create_custom_targeting_keys_and_values.rb +118 -0
- data/examples/v201104/custom_targeting_service/delete_custom_targeting_keys.rb +121 -0
- data/examples/v201104/custom_targeting_service/delete_custom_targeting_values.rb +125 -0
- data/examples/v201104/custom_targeting_service/get_all_custom_targeting_keys_and_values.rb +148 -0
- data/examples/v201104/custom_targeting_service/get_custom_targeting_keys_by_statement.rb +92 -0
- data/examples/v201104/custom_targeting_service/get_custom_targeting_values_by_statement.rb +98 -0
- data/examples/v201104/custom_targeting_service/update_custom_targeting_keys.rb +94 -0
- data/examples/v201104/custom_targeting_service/update_custom_targeting_values.rb +106 -0
- data/examples/v201104/forecast_service/get_forecast.rb +103 -0
- data/examples/v201104/forecast_service/get_forecast_by_id.rb +80 -0
- data/examples/v201104/inventory_service/create_ad_units.rb +98 -0
- data/examples/v201104/inventory_service/deactivate_ad_units.rb +119 -0
- data/examples/v201104/inventory_service/get_ad_unit.rb +72 -0
- data/examples/v201104/inventory_service/get_ad_units_by_statement.rb +96 -0
- data/examples/v201104/inventory_service/get_all_ad_units.rb +93 -0
- data/examples/v201104/inventory_service/update_ad_units.rb +94 -0
- data/examples/v201104/line_item_creative_association_service/create_licas.rb +94 -0
- data/examples/v201104/line_item_creative_association_service/deactivate_licas.rb +127 -0
- data/examples/v201104/line_item_creative_association_service/get_all_licas.rb +95 -0
- data/examples/v201104/line_item_creative_association_service/get_lica.rb +77 -0
- data/examples/v201104/line_item_creative_association_service/get_licas_by_statement.rb +91 -0
- data/examples/v201104/line_item_creative_association_service/update_licas.rb +92 -0
- data/examples/v201104/line_item_service/activate_line_items.rb +131 -0
- data/examples/v201104/line_item_service/create_line_items.rb +157 -0
- data/examples/v201104/line_item_service/get_all_line_items.rb +94 -0
- data/examples/v201104/line_item_service/get_line_item.rb +74 -0
- data/examples/v201104/line_item_service/get_line_items_by_statement.rb +89 -0
- data/examples/v201104/line_item_service/target_custom_criteria.rb +129 -0
- data/examples/v201104/line_item_service/update_line_items.rb +110 -0
- data/examples/v201104/network_service/get_all_networks.rb +74 -0
- data/examples/v201104/network_service/get_current_network.rb +66 -0
- data/examples/v201104/order_service/approve_orders.rb +116 -0
- data/examples/v201104/order_service/create_orders.rb +93 -0
- data/examples/v201104/order_service/get_all_orders.rb +93 -0
- data/examples/v201104/order_service/get_order.rb +74 -0
- data/examples/v201104/order_service/get_orders_by_statement.rb +90 -0
- data/examples/v201104/order_service/update_orders.rb +95 -0
- data/examples/v201104/placement_service/create_placements.rb +128 -0
- data/examples/v201104/placement_service/deactivate_placements.rb +118 -0
- data/examples/v201104/placement_service/get_all_placements.rb +93 -0
- data/examples/v201104/placement_service/get_placement.rb +74 -0
- data/examples/v201104/placement_service/get_placements_by_statement.rb +86 -0
- data/examples/v201104/placement_service/update_placements.rb +96 -0
- data/examples/v201104/publisher_query_language_service/get_all_cities.rb +85 -0
- data/examples/v201104/publisher_query_language_service/get_all_countries.rb +85 -0
- data/examples/v201104/publisher_query_language_service/get_all_metros.rb +85 -0
- data/examples/v201104/publisher_query_language_service/get_all_regions.rb +85 -0
- data/examples/v201104/report_service/download_report.rb +81 -0
- data/examples/v201104/report_service/run_delivery_report.rb +89 -0
- data/examples/v201104/report_service/run_inventory_report.rb +90 -0
- data/examples/v201104/report_service/run_sales_report.rb +89 -0
- data/examples/v201104/user_service/create_users.rb +89 -0
- data/examples/v201104/user_service/deactivate_users.rb +99 -0
- data/examples/v201104/user_service/get_all_roles.rb +73 -0
- data/examples/v201104/user_service/get_all_users.rb +92 -0
- data/examples/v201104/user_service/get_user.rb +73 -0
- data/examples/v201104/user_service/get_users_by_statement.rb +79 -0
- data/examples/v201104/user_service/update_users.rb +89 -0
- data/lib/dfp_api.rb +32 -45
- data/lib/dfp_api/api_config.rb +30 -7
- data/lib/dfp_api/v201101/company_service.rb +9 -9
- data/lib/dfp_api/v201101/company_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/creative_service.rb +9 -9
- data/lib/dfp_api/v201101/creative_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/custom_targeting_service.rb +9 -9
- data/lib/dfp_api/v201101/custom_targeting_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/forecast_service.rb +5 -5
- data/lib/dfp_api/v201101/forecast_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/inventory_service.rb +13 -13
- data/lib/dfp_api/v201101/inventory_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/line_item_creative_association_service.rb +5 -5
- data/lib/dfp_api/v201101/line_item_creative_association_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/line_item_service.rb +13 -13
- data/lib/dfp_api/v201101/line_item_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/network_service.rb +5 -5
- data/lib/dfp_api/v201101/network_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/order_service.rb +13 -13
- data/lib/dfp_api/v201101/order_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/placement_service.rb +9 -9
- data/lib/dfp_api/v201101/placement_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/publisher_query_language_service.rb +1 -1
- data/lib/dfp_api/v201101/publisher_query_language_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/report_service.rb +5 -5
- data/lib/dfp_api/v201101/report_service_registry.rb +3 -3
- data/lib/dfp_api/v201101/user_service.rb +17 -17
- data/lib/dfp_api/v201101/user_service_registry.rb +3 -3
- data/lib/dfp_api/v201103/company_service.rb +52 -0
- data/lib/dfp_api/v201103/company_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/creative_service.rb +52 -0
- data/lib/dfp_api/v201103/creative_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/custom_targeting_service.rb +60 -0
- data/lib/dfp_api/v201103/custom_targeting_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/forecast_service.rb +36 -0
- data/lib/dfp_api/v201103/forecast_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/inventory_service.rb +56 -0
- data/lib/dfp_api/v201103/inventory_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/line_item_creative_association_service.rb +56 -0
- data/lib/dfp_api/v201103/line_item_creative_association_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/line_item_service.rb +56 -0
- data/lib/dfp_api/v201103/line_item_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/network_service.rb +40 -0
- data/lib/dfp_api/v201103/network_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/order_service.rb +56 -0
- data/lib/dfp_api/v201103/order_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/placement_service.rb +56 -0
- data/lib/dfp_api/v201103/placement_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/publisher_query_language_service.rb +32 -0
- data/lib/dfp_api/v201103/publisher_query_language_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/report_service.rb +40 -0
- data/lib/dfp_api/v201103/report_service_registry.rb +37 -0
- data/lib/dfp_api/v201103/user_service.rb +60 -0
- data/lib/dfp_api/v201103/user_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/company_service.rb +52 -0
- data/lib/dfp_api/v201104/company_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/creative_service.rb +52 -0
- data/lib/dfp_api/v201104/creative_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/custom_targeting_service.rb +60 -0
- data/lib/dfp_api/v201104/custom_targeting_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/forecast_service.rb +36 -0
- data/lib/dfp_api/v201104/forecast_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/inventory_service.rb +56 -0
- data/lib/dfp_api/v201104/inventory_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/line_item_creative_association_service.rb +56 -0
- data/lib/dfp_api/v201104/line_item_creative_association_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/line_item_service.rb +56 -0
- data/lib/dfp_api/v201104/line_item_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/network_service.rb +40 -0
- data/lib/dfp_api/v201104/network_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/order_service.rb +56 -0
- data/lib/dfp_api/v201104/order_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/placement_service.rb +56 -0
- data/lib/dfp_api/v201104/placement_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/publisher_query_language_service.rb +32 -0
- data/lib/dfp_api/v201104/publisher_query_language_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/report_service.rb +40 -0
- data/lib/dfp_api/v201104/report_service_registry.rb +37 -0
- data/lib/dfp_api/v201104/user_service.rb +60 -0
- data/lib/dfp_api/v201104/user_service_registry.rb +37 -0
- data/test/bugs/test_issue_00000016.rb +154 -0
- data/test/dfp_api/test_dfp_api.rb +64 -0
- metadata +248 -53
data/ChangeLog
CHANGED
@@ -1,5 +1,11 @@
|
|
1
|
+
0.2.1:
|
2
|
+
- Ruby1.9 compatible.
|
3
|
+
- Fixed issue #16 (deep arrays nesting).
|
4
|
+
- Support for v201103 and v201104.
|
5
|
+
- Require google-ads-common 0.4.0 or later from now on.
|
6
|
+
|
1
7
|
0.2.0:
|
2
|
-
- Require google-ads-common 0.3.0 or later from now on
|
8
|
+
- Require google-ads-common 0.3.0 or later from now on.
|
3
9
|
- Support for Savon backend 0.9.1.
|
4
10
|
|
5
11
|
0.1.1:
|
data/README
CHANGED
@@ -3,12 +3,12 @@
|
|
3
3
|
Google's DoubleClick For Publishers API service lets developers design computer
|
4
4
|
programs that interact directly with the DFP platform. With these applications,
|
5
5
|
advertisers and third parties can more efficiently -- and creatively -- manage
|
6
|
-
their large or complex
|
6
|
+
their large or complex DoubleClick for Publishers accounts.
|
7
7
|
|
8
8
|
The DFP API Ruby Client Library makes it easy to write Ruby clients to
|
9
|
-
programmatically access
|
10
|
-
available as a Ruby gem or gzipped tarball. It depends on the
|
11
|
-
library which is base for all Google Ads APIs for Ruby.
|
9
|
+
programmatically access DoubleClick for Publishers accounts. The client library
|
10
|
+
is available as a Ruby gem or gzipped tarball. It depends on the
|
11
|
+
google-ads-common library which is base for all Google Ads APIs for Ruby.
|
12
12
|
|
13
13
|
|
14
14
|
== What's in the client library?
|
@@ -58,7 +58,7 @@ or if you downloaded the gem package manually, use:
|
|
58
58
|
== Using the library
|
59
59
|
|
60
60
|
In order to use the library you need to include its modules:
|
61
|
-
require '
|
61
|
+
require 'dfp_api'
|
62
62
|
|
63
63
|
Depending on your configuration you might also need to explicitely require
|
64
64
|
the rubygems library first:
|
@@ -78,7 +78,7 @@ constructor:
|
|
78
78
|
:password => 'PASSWORD'
|
79
79
|
},
|
80
80
|
:service => {
|
81
|
-
:environment => '
|
81
|
+
:environment => 'SANDBOX'
|
82
82
|
}
|
83
83
|
})
|
84
84
|
|
@@ -91,7 +91,7 @@ Once the library object is created you can request services with a 'service'
|
|
91
91
|
method:
|
92
92
|
user_service = dfp.service(:UserService, <API_VERSION>)
|
93
93
|
|
94
|
-
where <API_VERSION> is required version of DFP API, e.g. :
|
94
|
+
where <API_VERSION> is required version of DFP API as symbol, e.g. :v201104.
|
95
95
|
|
96
96
|
Then you should be able to execute service methods:
|
97
97
|
|
@@ -124,11 +124,11 @@ Examples can be run by executing by running:
|
|
124
124
|
|
125
125
|
from the "examples/<version>/<service_name>" directory i.e.
|
126
126
|
|
127
|
-
$ cd examples/
|
127
|
+
$ cd examples/v201104/user_service
|
128
128
|
$ ruby get_all_users.rb
|
129
129
|
|
130
130
|
Some examples require modification to be functional, like create_order example
|
131
|
-
needs Advertiser, Trafficker and Salesperson
|
131
|
+
needs Advertiser, Trafficker and Salesperson IDs to be filled in.
|
132
132
|
|
133
133
|
|
134
134
|
== How do I enable logging?
|
@@ -168,8 +168,8 @@ is planned for next releases.
|
|
168
168
|
External dependencies should be pulled automatically on gem install. Here is the
|
169
169
|
list though:
|
170
170
|
|
171
|
-
- Google Ads Common library (google-ads-common-0.
|
172
|
-
- Savon 'the heavy metal Ruby SOAP client' (savon-0.9.1).
|
171
|
+
- Google Ads Common library (google-ads-common-0.4.0);
|
172
|
+
- Savon 'the heavy metal Ruby SOAP client' (savon-0.9.1 or later).
|
173
173
|
|
174
174
|
|
175
175
|
= Where do I submit bug reports and feature requests?
|
data/Rakefile
CHANGED
@@ -17,21 +17,21 @@
|
|
17
17
|
# See the License for the specific language governing permissions and
|
18
18
|
# limitations under the License.
|
19
19
|
#
|
20
|
-
# DFP API Rakefile
|
21
|
-
#
|
20
|
+
# DFP API Rakefile.
|
22
21
|
|
23
22
|
require 'rubygems'
|
24
|
-
require '
|
23
|
+
require 'rubygems/package_task'
|
25
24
|
require 'rake/testtask'
|
26
|
-
require 'lib/dfp_api/api_config'
|
25
|
+
require './lib/dfp_api/api_config'
|
27
26
|
|
28
|
-
# Google common ads library used for wrapper code generation
|
27
|
+
# Google common ads library used for wrapper code generation.
|
29
28
|
gem 'google-ads-common'
|
30
29
|
require 'ads_common/build/savon_generator'
|
31
30
|
|
32
|
-
files = FileList[
|
33
|
-
tests = FileList[
|
31
|
+
files = FileList['{lib,examples}/**/*', 'Rakefile'].to_a
|
32
|
+
tests = FileList['test/**/test*.rb']
|
34
33
|
docs = ['README', 'COPYING', 'ChangeLog']
|
34
|
+
extra_files = ['dfp_api.yml', 'test/dfp_api/test_config.yml']
|
35
35
|
|
36
36
|
spec = Gem::Specification.new do |s|
|
37
37
|
s.name = 'google-dfp-api'
|
@@ -47,16 +47,17 @@ spec = Gem::Specification.new do |s|
|
|
47
47
|
s.test_files = tests
|
48
48
|
s.has_rdoc = true
|
49
49
|
s.extra_rdoc_files = docs
|
50
|
-
s.add_dependency('google-ads-common', '~> 0.
|
50
|
+
s.add_dependency('google-ads-common', '~> 0.4.0')
|
51
51
|
s.add_dependency('savon', '~> 0.9.1')
|
52
52
|
end
|
53
53
|
|
54
|
-
|
54
|
+
package_task = Gem::PackageTask.new(spec) do |pkg|
|
55
55
|
pkg.need_tar = true
|
56
|
+
pkg.package_files.include(extra_files)
|
56
57
|
end
|
57
58
|
|
58
59
|
Rake::TestTask.new do |t|
|
59
|
-
t.test_files =
|
60
|
+
t.test_files = tests
|
60
61
|
end
|
61
62
|
|
62
63
|
desc 'Default target - build'
|
@@ -70,7 +71,7 @@ task :generate do
|
|
70
71
|
versions = api_config.versions()
|
71
72
|
versions.each do |version|
|
72
73
|
code_path = "lib/%s/%s" % [api_config.api_path, version]
|
73
|
-
wsdls = DfpApi::ApiConfig.get_wsdls(
|
74
|
+
wsdls = DfpApi::ApiConfig.get_wsdls(version)
|
74
75
|
wsdls.each do |service_name, wsdl_url|
|
75
76
|
logger.info("Processing %s at [%s]..." % [service_name, wsdl_url])
|
76
77
|
module_name = "%s::%s::%s" % [api_config.api_name, version.to_s.upcase,
|
@@ -79,5 +80,6 @@ task :generate do
|
|
79
80
|
service_name, module_name)
|
80
81
|
generator.process_wsdl()
|
81
82
|
end
|
83
|
+
package_task.package_files.include(FileList[code_path + '/*'].to_a)
|
82
84
|
end
|
83
85
|
end
|
@@ -0,0 +1,76 @@
|
|
1
|
+
#!/usr/bin/ruby
|
2
|
+
#
|
3
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
|
+
#
|
5
|
+
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
8
|
+
# you may not use this file except in compliance with the License.
|
9
|
+
# You may obtain a copy of the License at
|
10
|
+
#
|
11
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
12
|
+
#
|
13
|
+
# Unless required by applicable law or agreed to in writing, software
|
14
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
15
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
16
|
+
# implied.
|
17
|
+
# See the License for the specific language governing permissions and
|
18
|
+
# limitations under the License.
|
19
|
+
#
|
20
|
+
# This example runs incorrect query and demonstrates how to handle errors.
|
21
|
+
#
|
22
|
+
# Tags: UserService.updateUser
|
23
|
+
|
24
|
+
require 'rubygems'
|
25
|
+
require 'dfp_api'
|
26
|
+
|
27
|
+
API_VERSION = :v201103
|
28
|
+
|
29
|
+
def produce_api_error()
|
30
|
+
# Get DfpApi instance and load configuration from ~/dfp_api.yml.
|
31
|
+
dfp = DfpApi::Api.new
|
32
|
+
|
33
|
+
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
34
|
+
# the configuration file or provide your own logger:
|
35
|
+
# dfp.logger = Logger.new('dfp_xml.log')
|
36
|
+
|
37
|
+
# Get the UserService.
|
38
|
+
user_service = dfp.service(:UserService, API_VERSION)
|
39
|
+
|
40
|
+
# Omitting "id" field here to produce an error.
|
41
|
+
user = {:preferred_locale => 'en_UK', :name => 'foo_bar'}
|
42
|
+
|
43
|
+
# Execute request and get the response, this should raise an exception.
|
44
|
+
user = user_service.update_user(user)
|
45
|
+
|
46
|
+
# Output retrieved data.
|
47
|
+
puts "User ID: %d, name: %s, email: %s" %
|
48
|
+
[user[:id], user[:name], user[:email]]
|
49
|
+
end
|
50
|
+
|
51
|
+
if __FILE__ == $0
|
52
|
+
begin
|
53
|
+
# This function should produce an exception for demo.
|
54
|
+
produce_api_error()
|
55
|
+
|
56
|
+
# One of two kinds of exception might occur, general HTTP error like 403 or
|
57
|
+
# 404 and DFP API error defined in WSDL and described in documentation.
|
58
|
+
|
59
|
+
# Handling HTTP errors.
|
60
|
+
rescue AdsCommon::Errors::HttpError => e
|
61
|
+
puts "HTTP Error: %s" % e
|
62
|
+
|
63
|
+
# Handling API errors.
|
64
|
+
rescue DfpApi::Errors::ApiException => e
|
65
|
+
# Standard DFP API error includes message and array of errors occured.
|
66
|
+
puts "Message: %s" % e.message
|
67
|
+
puts 'Errors:'
|
68
|
+
# Print out each of the errors.
|
69
|
+
e.errors.each_with_index do |error, index|
|
70
|
+
puts "\tError [%d]:" % (index + 1)
|
71
|
+
error.each do |field, value|
|
72
|
+
puts "\t\t%s: %s" % [field, value]
|
73
|
+
end
|
74
|
+
end
|
75
|
+
end
|
76
|
+
end
|
@@ -0,0 +1,82 @@
|
|
1
|
+
#!/usr/bin/ruby
|
2
|
+
#
|
3
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
|
+
#
|
5
|
+
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
8
|
+
# you may not use this file except in compliance with the License.
|
9
|
+
# You may obtain a copy of the License at
|
10
|
+
#
|
11
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
12
|
+
#
|
13
|
+
# Unless required by applicable law or agreed to in writing, software
|
14
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
15
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
16
|
+
# implied.
|
17
|
+
# See the License for the specific language governing permissions and
|
18
|
+
# limitations under the License.
|
19
|
+
#
|
20
|
+
# This example creates new companies. To determine which companies exist, run
|
21
|
+
# get_all_companies.java.
|
22
|
+
|
23
|
+
# Tags: CompanyService.createCompanies
|
24
|
+
|
25
|
+
require 'rubygems'
|
26
|
+
require 'dfp_api'
|
27
|
+
|
28
|
+
API_VERSION = :v201103
|
29
|
+
# Number of companies to create.
|
30
|
+
ITEM_COUNT = 5
|
31
|
+
|
32
|
+
def create_companies()
|
33
|
+
# Get DfpApi instance and load configuration from ~/dfp_api.yml.
|
34
|
+
dfp = DfpApi::Api.new
|
35
|
+
|
36
|
+
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
37
|
+
# the configuration file or provide your own logger:
|
38
|
+
# dfp.logger = Logger.new('dfp_xml.log')
|
39
|
+
|
40
|
+
# Get the CompanyService.
|
41
|
+
company_service = dfp.service(:CompanyService, API_VERSION)
|
42
|
+
|
43
|
+
# Create an array to store local company objects.
|
44
|
+
companies = Array.new
|
45
|
+
ITEM_COUNT.times do |index|
|
46
|
+
companies << {:name => "Advertiser #%d" % index, :type => 'ADVERTISER'}
|
47
|
+
end
|
48
|
+
|
49
|
+
# Create the companies on the server.
|
50
|
+
return_companies = company_service.create_companies(companies)
|
51
|
+
|
52
|
+
if return_companies
|
53
|
+
return_companies.each do |company|
|
54
|
+
puts "Company with ID: %d, name: %s and type: %s was created." %
|
55
|
+
[company[:id], company[:name], company[:type]]
|
56
|
+
end
|
57
|
+
else
|
58
|
+
raise 'No companies were created.'
|
59
|
+
end
|
60
|
+
|
61
|
+
end
|
62
|
+
|
63
|
+
if __FILE__ == $0
|
64
|
+
begin
|
65
|
+
create_companies()
|
66
|
+
|
67
|
+
# HTTP errors.
|
68
|
+
rescue AdsCommon::Errors::HttpError => e
|
69
|
+
puts "HTTP Error: %s" % e
|
70
|
+
|
71
|
+
# API errors.
|
72
|
+
rescue DfpApi::Errors::ApiException => e
|
73
|
+
puts "Message: %s" % e.message
|
74
|
+
puts 'Errors:'
|
75
|
+
e.errors.each_with_index do |error, index|
|
76
|
+
puts "\tError [%d]:" % (index + 1)
|
77
|
+
error.each do |field, value|
|
78
|
+
puts "\t\t%s: %s" % [field, value]
|
79
|
+
end
|
80
|
+
end
|
81
|
+
end
|
82
|
+
end
|
@@ -0,0 +1,92 @@
|
|
1
|
+
#!/usr/bin/ruby
|
2
|
+
#
|
3
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
|
+
#
|
5
|
+
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
8
|
+
# you may not use this file except in compliance with the License.
|
9
|
+
# You may obtain a copy of the License at
|
10
|
+
#
|
11
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
12
|
+
#
|
13
|
+
# Unless required by applicable law or agreed to in writing, software
|
14
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
15
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
16
|
+
# implied.
|
17
|
+
# See the License for the specific language governing permissions and
|
18
|
+
# limitations under the License.
|
19
|
+
#
|
20
|
+
# This example gets all companies. To create companies, run create_companies.rb.
|
21
|
+
#
|
22
|
+
# Tags: CompanyService.getCompaniesByStatement
|
23
|
+
|
24
|
+
require 'rubygems'
|
25
|
+
require 'dfp_api'
|
26
|
+
|
27
|
+
API_VERSION = :v201103
|
28
|
+
PAGE_SIZE = 500
|
29
|
+
|
30
|
+
def get_all_companies()
|
31
|
+
# Get DfpApi instance and load configuration from ~/dfp_api.yml.
|
32
|
+
dfp = DfpApi::Api.new
|
33
|
+
|
34
|
+
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
35
|
+
# the configuration file or provide your own logger:
|
36
|
+
# dfp.logger = Logger.new('dfp_xml.log')
|
37
|
+
|
38
|
+
# Get the CompanyService.
|
39
|
+
company_service = dfp.service(:CompanyService, API_VERSION)
|
40
|
+
|
41
|
+
# Define initial values.
|
42
|
+
offset = 0
|
43
|
+
page = Hash.new
|
44
|
+
|
45
|
+
begin
|
46
|
+
# Create a statement to get one page with current offset.
|
47
|
+
statement = {:query => "LIMIT %d OFFSET %d" % [PAGE_SIZE, offset]}
|
48
|
+
|
49
|
+
# Get companies by statement.
|
50
|
+
page = company_service.get_companies_by_statement(statement)
|
51
|
+
|
52
|
+
if page[:results]
|
53
|
+
# Increase query offset by page size.
|
54
|
+
offset += PAGE_SIZE
|
55
|
+
|
56
|
+
# Get the start index for printout.
|
57
|
+
start_index = page[:start_index]
|
58
|
+
|
59
|
+
# Print details about each company in results.
|
60
|
+
page[:results].each_with_index do |company, index|
|
61
|
+
puts "%d) Company ID: %d, name: %s, type: %s" %
|
62
|
+
[index + start_index, company[:id], company[:name], company[:type]]
|
63
|
+
end
|
64
|
+
end
|
65
|
+
end while offset < page[:total_result_set_size]
|
66
|
+
|
67
|
+
# Print a footer.
|
68
|
+
if page.include?(:total_result_set_size)
|
69
|
+
puts "Total number of companies: %d" % page[:total_result_set_size]
|
70
|
+
end
|
71
|
+
end
|
72
|
+
|
73
|
+
if __FILE__ == $0
|
74
|
+
begin
|
75
|
+
get_all_companies()
|
76
|
+
|
77
|
+
# HTTP errors.
|
78
|
+
rescue AdsCommon::Errors::HttpError => e
|
79
|
+
puts "HTTP Error: %s" % e
|
80
|
+
|
81
|
+
# API errors.
|
82
|
+
rescue DfpApi::Errors::ApiException => e
|
83
|
+
puts "Message: %s" % e.message
|
84
|
+
puts 'Errors:'
|
85
|
+
e.errors.each_with_index do |error, index|
|
86
|
+
puts "\tError [%d]:" % (index + 1)
|
87
|
+
error.each do |field, value|
|
88
|
+
puts "\t\t%s: %s" % [field, value]
|
89
|
+
end
|
90
|
+
end
|
91
|
+
end
|
92
|
+
end
|
@@ -0,0 +1,88 @@
|
|
1
|
+
#!/usr/bin/ruby
|
2
|
+
#
|
3
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
|
+
#
|
5
|
+
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
8
|
+
# you may not use this file except in compliance with the License.
|
9
|
+
# You may obtain a copy of the License at
|
10
|
+
#
|
11
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
12
|
+
#
|
13
|
+
# Unless required by applicable law or agreed to in writing, software
|
14
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
15
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
16
|
+
# implied.
|
17
|
+
# See the License for the specific language governing permissions and
|
18
|
+
# limitations under the License.
|
19
|
+
#
|
20
|
+
# This example gets all companies that are advertisers. The statement retrieves
|
21
|
+
# up to the maximum page size limit of 500. To create companies, run
|
22
|
+
# create_companies.rb.
|
23
|
+
#
|
24
|
+
# Tags: CompanyService.getCompaniesByStatement
|
25
|
+
|
26
|
+
require 'rubygems'
|
27
|
+
require 'dfp_api'
|
28
|
+
|
29
|
+
API_VERSION = :v201103
|
30
|
+
|
31
|
+
def get_companies_by_statement()
|
32
|
+
# Get DfpApi instance and load configuration from ~/dfp_api.yml.
|
33
|
+
dfp = DfpApi::Api.new
|
34
|
+
|
35
|
+
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
36
|
+
# the configuration file or provide your own logger:
|
37
|
+
# dfp.logger = Logger.new('dfp_xml.log')
|
38
|
+
|
39
|
+
# Get the CompanyService.
|
40
|
+
company_service = dfp.service(:CompanyService, API_VERSION)
|
41
|
+
|
42
|
+
# Create a statement to only select companies that are advertisers, sorted by
|
43
|
+
# name.
|
44
|
+
statement = {
|
45
|
+
:query => 'WHERE type = :type ORDER BY name LIMIT 500',
|
46
|
+
:values => [
|
47
|
+
{:key => 'type',
|
48
|
+
:value => {:value => 'ADVERTISER', :xsi_type => 'TextValue'}}
|
49
|
+
]
|
50
|
+
}
|
51
|
+
|
52
|
+
# Get companies by statement.
|
53
|
+
page = company_service.get_companies_by_statement(statement)
|
54
|
+
|
55
|
+
if page[:results]
|
56
|
+
# Print details about each company in results.
|
57
|
+
page[:results].each_with_index do |company, index|
|
58
|
+
puts "%d) [%d] name: %s, type: %s" %
|
59
|
+
[index, company[:id], company[:name], company[:type]]
|
60
|
+
end
|
61
|
+
end
|
62
|
+
|
63
|
+
# Print a footer.
|
64
|
+
if page.include?(:total_result_set_size)
|
65
|
+
puts "Total number of companies: %d" % page[:total_result_set_size]
|
66
|
+
end
|
67
|
+
end
|
68
|
+
|
69
|
+
if __FILE__ == $0
|
70
|
+
begin
|
71
|
+
get_companies_by_statement()
|
72
|
+
|
73
|
+
# HTTP errors.
|
74
|
+
rescue AdsCommon::Errors::HttpError => e
|
75
|
+
puts "HTTP Error: %s" % e
|
76
|
+
|
77
|
+
# API errors.
|
78
|
+
rescue DfpApi::Errors::ApiException => e
|
79
|
+
puts "Message: %s" % e.message
|
80
|
+
puts 'Errors:'
|
81
|
+
e.errors.each_with_index do |error, index|
|
82
|
+
puts "\tError [%d]:" % (index + 1)
|
83
|
+
error.each do |field, value|
|
84
|
+
puts "\t\t%s: %s" % [field, value]
|
85
|
+
end
|
86
|
+
end
|
87
|
+
end
|
88
|
+
end
|