google-adx-buyer-api 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (133) hide show
  1. data/COPYING +201 -0
  2. data/ChangeLog +2 -0
  3. data/README +208 -0
  4. data/Rakefile +50 -0
  5. data/examples/v201003/add_ad_group.rb +98 -0
  6. data/examples/v201003/add_ad_group_criteria.rb +100 -0
  7. data/examples/v201003/add_ads.rb +110 -0
  8. data/examples/v201003/add_campaign.rb +101 -0
  9. data/examples/v201003/add_negative_campaign_criterion.rb +95 -0
  10. data/examples/v201003/add_placement_performance_report_definition.rb +108 -0
  11. data/examples/v201003/check_campaigns.rb +132 -0
  12. data/examples/v201003/delete_ad.rb +94 -0
  13. data/examples/v201003/delete_ad_group.rb +86 -0
  14. data/examples/v201003/delete_ad_group_criterion.rb +95 -0
  15. data/examples/v201003/delete_campaign.rb +87 -0
  16. data/examples/v201003/download_report.rb +71 -0
  17. data/examples/v201003/get_all_active_ad_group_criteria.rb +93 -0
  18. data/examples/v201003/get_all_ad_group_criteria.rb +91 -0
  19. data/examples/v201003/get_all_ad_groups.rb +88 -0
  20. data/examples/v201003/get_all_ads.rb +91 -0
  21. data/examples/v201003/get_all_campaign_targets.rb +83 -0
  22. data/examples/v201003/get_all_campaigns.rb +83 -0
  23. data/examples/v201003/get_all_disapproved_ads.rb +94 -0
  24. data/examples/v201003/get_all_images.rb +88 -0
  25. data/examples/v201003/get_all_paused_campaigns.rb +86 -0
  26. data/examples/v201003/get_all_report_definitions.rb +84 -0
  27. data/examples/v201003/get_criterion_bid_landscape.rb +105 -0
  28. data/examples/v201003/get_geo_location_info.rb +108 -0
  29. data/examples/v201003/get_related_placements.rb +111 -0
  30. data/examples/v201003/get_report_fields.rb +81 -0
  31. data/examples/v201003/perform_bulk_mutate_job.rb +222 -0
  32. data/examples/v201003/set_campaign_targets.rb +124 -0
  33. data/examples/v201003/update_ad.rb +95 -0
  34. data/examples/v201003/update_ad_group.rb +90 -0
  35. data/examples/v201003/update_ad_group_criterion.rb +108 -0
  36. data/examples/v201003/update_campaign.rb +92 -0
  37. data/examples/v201003/upload_image.rb +97 -0
  38. data/examples/v201008/add_ad_group.rb +98 -0
  39. data/examples/v201008/add_ad_group_criteria.rb +100 -0
  40. data/examples/v201008/add_ads.rb +110 -0
  41. data/examples/v201008/add_campaign.rb +101 -0
  42. data/examples/v201008/add_experiment.rb +162 -0
  43. data/examples/v201008/add_negative_campaign_criterion.rb +95 -0
  44. data/examples/v201008/add_placement_performance_report_definition.rb +108 -0
  45. data/examples/v201008/add_user_list.rb +96 -0
  46. data/examples/v201008/check_campaigns.rb +132 -0
  47. data/examples/v201008/delete_ad.rb +94 -0
  48. data/examples/v201008/delete_ad_group.rb +86 -0
  49. data/examples/v201008/delete_ad_group_criterion.rb +95 -0
  50. data/examples/v201008/delete_bulk_mutate_job.rb +96 -0
  51. data/examples/v201008/delete_campaign.rb +87 -0
  52. data/examples/v201008/delete_experiment.rb +87 -0
  53. data/examples/v201008/delete_user_list.rb +87 -0
  54. data/examples/v201008/download_report.rb +71 -0
  55. data/examples/v201008/get_all_account_changes.rb +144 -0
  56. data/examples/v201008/get_all_active_ad_group_criteria.rb +93 -0
  57. data/examples/v201008/get_all_ad_group_criteria.rb +91 -0
  58. data/examples/v201008/get_all_ad_groups.rb +88 -0
  59. data/examples/v201008/get_all_ads.rb +91 -0
  60. data/examples/v201008/get_all_campaign_targets.rb +83 -0
  61. data/examples/v201008/get_all_campaigns.rb +83 -0
  62. data/examples/v201008/get_all_disapproved_ads.rb +94 -0
  63. data/examples/v201008/get_all_experiments.rb +93 -0
  64. data/examples/v201008/get_all_images.rb +88 -0
  65. data/examples/v201008/get_all_paused_campaigns.rb +86 -0
  66. data/examples/v201008/get_all_report_definitions.rb +84 -0
  67. data/examples/v201008/get_all_user_lists.rb +84 -0
  68. data/examples/v201008/get_bulk_mutate_job.rb +106 -0
  69. data/examples/v201008/get_campaign_alerts.rb +103 -0
  70. data/examples/v201008/get_criterion_bid_landscape.rb +105 -0
  71. data/examples/v201008/get_geo_location_info.rb +108 -0
  72. data/examples/v201008/get_related_placements.rb +114 -0
  73. data/examples/v201008/get_report_fields.rb +81 -0
  74. data/examples/v201008/perform_bulk_mutate_job.rb +222 -0
  75. data/examples/v201008/promote_experiment.rb +88 -0
  76. data/examples/v201008/set_campaign_targets.rb +124 -0
  77. data/examples/v201008/update_ad.rb +95 -0
  78. data/examples/v201008/update_ad_group.rb +90 -0
  79. data/examples/v201008/update_ad_group_criterion.rb +108 -0
  80. data/examples/v201008/update_campaign.rb +93 -0
  81. data/examples/v201008/update_user_list.rb +91 -0
  82. data/examples/v201008/upload_image.rb +97 -0
  83. data/examples/v201101/add_ad_group.rb +98 -0
  84. data/examples/v201101/add_ad_group_criteria.rb +100 -0
  85. data/examples/v201101/add_ads.rb +110 -0
  86. data/examples/v201101/add_campaign.rb +108 -0
  87. data/examples/v201101/add_conversion.rb +97 -0
  88. data/examples/v201101/add_experiment.rb +162 -0
  89. data/examples/v201101/add_negative_campaign_criterion.rb +95 -0
  90. data/examples/v201101/add_placement_performance_report_definition.rb +108 -0
  91. data/examples/v201101/add_rtb_campaign.rb +113 -0
  92. data/examples/v201101/add_user_list.rb +122 -0
  93. data/examples/v201101/check_campaigns.rb +132 -0
  94. data/examples/v201101/delete_ad.rb +94 -0
  95. data/examples/v201101/delete_ad_group.rb +86 -0
  96. data/examples/v201101/delete_ad_group_criterion.rb +95 -0
  97. data/examples/v201101/delete_bulk_mutate_job.rb +96 -0
  98. data/examples/v201101/delete_campaign.rb +87 -0
  99. data/examples/v201101/delete_experiment.rb +87 -0
  100. data/examples/v201101/delete_user_list.rb +87 -0
  101. data/examples/v201101/download_report.rb +71 -0
  102. data/examples/v201101/get_ad_group_bid_landscape.rb +103 -0
  103. data/examples/v201101/get_all_account_changes.rb +146 -0
  104. data/examples/v201101/get_all_active_ad_group_criteria.rb +106 -0
  105. data/examples/v201101/get_all_ad_group_criteria.rb +97 -0
  106. data/examples/v201101/get_all_ad_groups.rb +94 -0
  107. data/examples/v201101/get_all_ads.rb +99 -0
  108. data/examples/v201101/get_all_campaign_targets.rb +83 -0
  109. data/examples/v201101/get_all_campaigns.rb +86 -0
  110. data/examples/v201101/get_all_conversions.rb +88 -0
  111. data/examples/v201101/get_all_disapproved_ads.rb +102 -0
  112. data/examples/v201101/get_all_experiments.rb +98 -0
  113. data/examples/v201101/get_all_images.rb +90 -0
  114. data/examples/v201101/get_all_paused_campaigns.rb +92 -0
  115. data/examples/v201101/get_all_report_definitions.rb +84 -0
  116. data/examples/v201101/get_all_user_lists.rb +87 -0
  117. data/examples/v201101/get_bulk_mutate_job.rb +106 -0
  118. data/examples/v201101/get_campaign_alerts.rb +103 -0
  119. data/examples/v201101/get_criterion_bid_landscape.rb +102 -0
  120. data/examples/v201101/get_geo_location_info.rb +108 -0
  121. data/examples/v201101/get_related_placements.rb +114 -0
  122. data/examples/v201101/get_report_fields.rb +81 -0
  123. data/examples/v201101/perform_bulk_mutate_job.rb +222 -0
  124. data/examples/v201101/promote_experiment.rb +88 -0
  125. data/examples/v201101/set_campaign_targets.rb +111 -0
  126. data/examples/v201101/update_ad.rb +95 -0
  127. data/examples/v201101/update_ad_group.rb +90 -0
  128. data/examples/v201101/update_ad_group_criterion.rb +108 -0
  129. data/examples/v201101/update_campaign.rb +93 -0
  130. data/examples/v201101/update_conversion.rb +96 -0
  131. data/examples/v201101/update_user_list.rb +91 -0
  132. data/examples/v201101/upload_image.rb +97 -0
  133. metadata +208 -0
@@ -0,0 +1,86 @@
1
+ #!/usr/bin/ruby
2
+ #
3
+ # Author:: api.sgomes@gmail.com (Sérgio Gomes)
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 illustrates how to retrieve all the campaigns for an account.
21
+ #
22
+ # Tags: CampaignService.get
23
+
24
+ require 'rubygems'
25
+ gem 'google-adwords-api'
26
+ require 'adwords_api'
27
+
28
+ API_VERSION = :v201101
29
+
30
+ def get_all_campaigns()
31
+ # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
32
+ # when called without parameters.
33
+ adwords = AdwordsApi::Api.new
34
+ campaign_srv = adwords.service(:CampaignService, API_VERSION)
35
+
36
+ # Get all the campaigns for this account; empty selector.
37
+ selector = {
38
+ :fields => ['Id', 'Name', 'Status'],
39
+ :ordering => [{:field => 'Name', :sort_order => 'ASCENDING'}]
40
+ }
41
+ response = campaign_srv.get(selector)
42
+
43
+ if response and response[:entries]
44
+ campaigns = response[:entries]
45
+ campaigns.each do |campaign|
46
+ puts "Campaign name is \"#{campaign[:name]}\", id is #{campaign[:id]} " +
47
+ "and status is \"#{campaign[:status]}\"."
48
+ end
49
+ else
50
+ puts "No campaigns were found."
51
+ end
52
+ end
53
+
54
+ if __FILE__ == $0
55
+ # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
56
+ # variable to 'true'. This can be done either from your operating system
57
+ # environment or via code, as done below.
58
+ ENV['ADWORDSAPI_DEBUG'] = 'false'
59
+
60
+ begin
61
+ get_all_campaigns()
62
+
63
+ # Connection error. Likely transitory.
64
+ rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
65
+ puts 'Connection Error: %s' % e
66
+ puts 'Source: %s' % e.backtrace.first
67
+
68
+ # API Error.
69
+ rescue AdwordsApi::Errors::ApiException => e
70
+ puts 'API Exception caught.'
71
+ puts 'Message: %s' % e.message
72
+ puts 'Code: %d' % e.code if e.code
73
+ puts 'Trigger: %s' % e.trigger if e.trigger
74
+ puts 'Errors:'
75
+ if e.errors
76
+ e.errors.each_with_index do |error, index|
77
+ puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
78
+ error.each_pair do |field, value|
79
+ if field != :xsi_type
80
+ puts ' %s: %s' % [field, value]
81
+ end
82
+ end
83
+ end
84
+ end
85
+ end
86
+ end
@@ -0,0 +1,88 @@
1
+ #!/usr/bin/ruby
2
+ #
3
+ # Author:: api.sgomes@gmail.com (Sérgio Gomes)
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 conversions in the account. To add conversions, run
21
+ # add_conversion.rb.
22
+ #
23
+ # Tags: ConversionTrackerService.get
24
+
25
+ require 'rubygems'
26
+ gem 'google-adwords-api'
27
+ require 'adwords_api'
28
+
29
+ API_VERSION = :v201101
30
+
31
+ def get_all_conversions()
32
+ # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
33
+ # when called without parameters.
34
+ adwords = AdwordsApi::Api.new
35
+ conv_tracker_srv = adwords.service(:ConversionTrackerService, API_VERSION)
36
+
37
+ # Get all conversions.
38
+ selector = {
39
+ :fields => ['Id', 'Name', 'Status', 'Category'],
40
+ :ordering => [{:field => 'Name', :sort_order => 'ASCENDING'}],
41
+ }
42
+ response = conv_tracker_srv.get(selector)
43
+ if response and response[:entries]
44
+ conversions = response[:entries]
45
+ puts "#{conversions.length} conversions(s) found."
46
+ conversions.each do |conversion|
47
+ puts " Conversion with id \"#{conversion[:id]}\", status \"" +
48
+ "#{conversion[:status]}\" and category \"#{conversion[:category]}\"" +
49
+ " was found. Code snippet: \n#{conversion[:snippet]}\n"
50
+ end
51
+ else
52
+ puts "No conversions found."
53
+ end
54
+ end
55
+
56
+ if __FILE__ == $0
57
+ # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
58
+ # variable to 'true'. This can be done either from your operating system
59
+ # environment or via code, as done below.
60
+ ENV['ADWORDSAPI_DEBUG'] = 'false'
61
+
62
+ begin
63
+ get_all_conversions()
64
+
65
+ # Connection error. Likely transitory.
66
+ rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
67
+ puts 'Connection Error: %s' % e
68
+ puts 'Source: %s' % e.backtrace.first
69
+
70
+ # API Error.
71
+ rescue AdwordsApi::Errors::ApiException => e
72
+ puts 'API Exception caught.'
73
+ puts 'Message: %s' % e.message
74
+ puts 'Code: %d' % e.code if e.code
75
+ puts 'Trigger: %s' % e.trigger if e.trigger
76
+ puts 'Errors:'
77
+ if e.errors
78
+ e.errors.each_with_index do |error, index|
79
+ puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
80
+ error.each_pair do |field, value|
81
+ if field != :xsi_type
82
+ puts ' %s: %s' % [field, value]
83
+ end
84
+ end
85
+ end
86
+ end
87
+ end
88
+ end
@@ -0,0 +1,102 @@
1
+ #!/usr/bin/ruby
2
+ #
3
+ # Author:: api.sgomes@gmail.com (Sérgio Gomes)
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 illustrates how to retrieve all the disapproved ads in a given
21
+ # ad group. To add ads, run add_ads.rb.
22
+ #
23
+ # Tags: AdGroupAdService.get
24
+
25
+ require 'rubygems'
26
+ gem 'google-adwords-api'
27
+ require 'adwords_api'
28
+
29
+ API_VERSION = :v201101
30
+
31
+ def get_all_disapproved_ads()
32
+ # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
33
+ # when called without parameters.
34
+ adwords = AdwordsApi::Api.new
35
+ ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
36
+
37
+ ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
38
+
39
+ # Get all the disapproved ads for this campaign.
40
+ selector = {
41
+ :fields => ['Id', 'DisapprovalReasons'],
42
+ :ordering => [{:field => 'Id', :sort_order => 'ASCENDING'}],
43
+ :predicates => [
44
+ {:field => 'AdGroupId', :operator => 'IN', :values => [ad_group_id]},
45
+ {
46
+ :field => 'CreativeApprovalStatus',
47
+ :operator => 'IN',
48
+ :values => ['DISAPPROVED']
49
+ }
50
+ ]
51
+ }
52
+ response = ad_group_ad_srv.get(selector)
53
+ if response and response[:entries]
54
+ ad_group_ads = response[:entries]
55
+ puts "Ad group ##{ad_group_id} has #{ad_group_ads.length} " +
56
+ "disapproved ad(s)."
57
+ ad_group_ads.each do |ad_group_ad|
58
+ puts " Ad with id #{ad_group_ad[:ad][:id]} and type " +
59
+ "#{ad_group_ad[:ad][:xsi_type]} was disapproved for the following " +
60
+ "reasons:"
61
+ ad_group_ad[:ad][:disapproval_reasons].each do |reason|
62
+ puts " #{reason}"
63
+ end
64
+ end
65
+ else
66
+ puts "No disapproved ads found for ad group ##{ad_group_id}."
67
+ end
68
+ end
69
+
70
+ if __FILE__ == $0
71
+ # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
72
+ # variable to 'true'. This can be done either from your operating system
73
+ # environment or via code, as done below.
74
+ ENV['ADWORDSAPI_DEBUG'] = 'false'
75
+
76
+ begin
77
+ get_all_disapproved_ads()
78
+
79
+ # Connection error. Likely transitory.
80
+ rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
81
+ puts 'Connection Error: %s' % e
82
+ puts 'Source: %s' % e.backtrace.first
83
+
84
+ # API Error.
85
+ rescue AdwordsApi::Errors::ApiException => e
86
+ puts 'API Exception caught.'
87
+ puts 'Message: %s' % e.message
88
+ puts 'Code: %d' % e.code if e.code
89
+ puts 'Trigger: %s' % e.trigger if e.trigger
90
+ puts 'Errors:'
91
+ if e.errors
92
+ e.errors.each_with_index do |error, index|
93
+ puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
94
+ error.each_pair do |field, value|
95
+ if field != :xsi_type
96
+ puts ' %s: %s' % [field, value]
97
+ end
98
+ end
99
+ end
100
+ end
101
+ end
102
+ end
@@ -0,0 +1,98 @@
1
+ #!/usr/bin/ruby
2
+ #
3
+ # Author:: api.sgomes@gmail.com (Sérgio Gomes)
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 experiments in a campaign. To add an experiment, run
21
+ # add_experiment.rb. To get campaigns, run get_all_campaigns.rb.
22
+ #
23
+ # Tags: ExperimentService.get
24
+
25
+ require 'rubygems'
26
+ gem 'google-adwords-api'
27
+ require 'adwords_api'
28
+
29
+ API_VERSION = :v201101
30
+
31
+ def get_all_experiments()
32
+ # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
33
+ # when called without parameters.
34
+ adwords = AdwordsApi::Api.new
35
+ experiment_srv = adwords.service(:ExperimentService, API_VERSION)
36
+
37
+ campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
38
+
39
+ # Get all the experiments for this campaign.
40
+ selector = {
41
+ :fields => ['Id', 'Name', 'ControlId', 'AdGroupsCount'],
42
+ :ordering => [{:field => 'Name', :sort_order => 'ASCENDING'}],
43
+ :predicates => [{
44
+ :field => 'CampaignId',
45
+ :operator => 'IN',
46
+ :values => [campaign_id]
47
+ }]
48
+ }
49
+ response = experiment_srv.get(selector)
50
+
51
+ if response and response[:entries]
52
+ experiments = response[:entries]
53
+ experiments.each do |experiment|
54
+ experiment_stats = experiment[:experiment_summary_stats]
55
+ puts "Experiment with name \"#{experiment[:name]}\", " +
56
+ "id #{experiment[:id]} and control id " +
57
+ "#{experiment[:control_id]} was found and it includes " +
58
+ "#{experiment_stats[:ad_groups_count]} ad group(s) and " +
59
+ "#{experiment_stats[:ad_group_criteria_count]} criteria.\n"
60
+ end
61
+ else
62
+ puts "No experiments were found."
63
+ end
64
+ end
65
+
66
+ if __FILE__ == $0
67
+ # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
68
+ # variable to 'true'. This can be done either from your operating system
69
+ # environment or via code, as done below.
70
+ ENV['ADWORDSAPI_DEBUG'] = 'false'
71
+
72
+ begin
73
+ get_all_experiments()
74
+
75
+ # Connection error. Likely transitory.
76
+ rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
77
+ puts 'Connection Error: %s' % e
78
+ puts 'Source: %s' % e.backtrace.first
79
+
80
+ # API Error.
81
+ rescue AdwordsApi::Errors::ApiException => e
82
+ puts 'API Exception caught.'
83
+ puts 'Message: %s' % e.message
84
+ puts 'Code: %d' % e.code if e.code
85
+ puts 'Trigger: %s' % e.trigger if e.trigger
86
+ puts 'Errors:'
87
+ if e.errors
88
+ e.errors.each_with_index do |error, index|
89
+ puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
90
+ error.each_pair do |field, value|
91
+ if field != :xsi_type
92
+ puts ' %s: %s' % [field, value]
93
+ end
94
+ end
95
+ end
96
+ end
97
+ end
98
+ end
@@ -0,0 +1,90 @@
1
+ #!/usr/bin/ruby
2
+ #
3
+ # Author:: api.sgomes@gmail.com (Sérgio Gomes)
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 illustrates how to retrieve all images. To upload an image, run
21
+ # upload_image.rb.
22
+ #
23
+ # Tags: MediaService.get
24
+
25
+ require 'rubygems'
26
+ gem 'google-adwords-api'
27
+ require 'adwords_api'
28
+
29
+ API_VERSION = :v201101
30
+
31
+ def get_all_images()
32
+ # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
33
+ # when called without parameters.
34
+ adwords = AdwordsApi::Api.new
35
+ media_srv = adwords.service(:MediaService, API_VERSION)
36
+
37
+ # Get all the images.
38
+ selector = {
39
+ :fields => ['MediaId', 'Height', 'Width', 'MimeType', 'Urls'],
40
+ :ordering => [{:field => 'MediaId', :sort_order => 'ASCENDING'}],
41
+ :predicates => [{:field => 'Type', :operator => 'IN', :values => ['IMAGE']}]
42
+ }
43
+ response = media_srv.get(selector)
44
+ if response and response[:entries]
45
+ images = response[:entries]
46
+ puts "#{images.length} images(s) found."
47
+ images.each do |image|
48
+ dimensions = AdwordsApi::Utils.map(image[:dimensions])
49
+ puts " Image id is #{image[:media_id]}, dimensions are " +
50
+ "#{dimensions['FULL'][:height]}x#{dimensions['FULL'][:width]} " +
51
+ "and MIME type is \"#{image[:mime_type]}\"."
52
+ end
53
+ else
54
+ puts "No images found."
55
+ end
56
+ end
57
+
58
+ if __FILE__ == $0
59
+ # To enable logging of SOAP requests, set the ADWORDSAPI_DEBUG environment
60
+ # variable to 'true'. This can be done either from your operating system
61
+ # environment or via code, as done below.
62
+ ENV['ADWORDSAPI_DEBUG'] = 'false'
63
+
64
+ begin
65
+ get_all_images()
66
+
67
+ # Connection error. Likely transitory.
68
+ rescue Errno::ECONNRESET, SOAP::HTTPStreamError, SocketError => e
69
+ puts 'Connection Error: %s' % e
70
+ puts 'Source: %s' % e.backtrace.first
71
+
72
+ # API Error.
73
+ rescue AdwordsApi::Errors::ApiException => e
74
+ puts 'API Exception caught.'
75
+ puts 'Message: %s' % e.message
76
+ puts 'Code: %d' % e.code if e.code
77
+ puts 'Trigger: %s' % e.trigger if e.trigger
78
+ puts 'Errors:'
79
+ if e.errors
80
+ e.errors.each_with_index do |error, index|
81
+ puts ' %d. Error type is %s. Fields:' % [index + 1, error[:xsi_type]]
82
+ error.each_pair do |field, value|
83
+ if field != :xsi_type
84
+ puts ' %s: %s' % [field, value]
85
+ end
86
+ end
87
+ end
88
+ end
89
+ end
90
+ end