google-adwords-api 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. data/ChangeLog +4 -0
  2. data/README +2 -1
  3. data/examples/v201109/account_management/create_account.rb +2 -2
  4. data/examples/v201109/account_management/get_account_alerts.rb +3 -3
  5. data/examples/v201109/account_management/get_account_changes.rb +2 -2
  6. data/examples/v201109/account_management/get_account_hierarchy.rb +2 -2
  7. data/examples/v201109/account_management/get_client_customer_id.rb +6 -8
  8. data/examples/v201109/account_management/get_client_unit_usage.rb +6 -7
  9. data/examples/v201109/basic_operations/add_ad_groups.rb +111 -0
  10. data/examples/v201109/basic_operations/add_campaigns.rb +125 -0
  11. data/examples/v201109/basic_operations/add_keywords.rb +16 -11
  12. data/examples/v201109/basic_operations/add_text_ads.rb +23 -19
  13. data/examples/v201109/basic_operations/delete_ad.rb +7 -7
  14. data/examples/v201109/basic_operations/delete_ad_group.rb +7 -7
  15. data/examples/v201109/basic_operations/delete_campaign.rb +7 -7
  16. data/examples/v201109/basic_operations/delete_keyword.rb +7 -7
  17. data/examples/v201109/basic_operations/get_ad_groups.rb +7 -7
  18. data/examples/v201109/basic_operations/get_campaigns.rb +3 -3
  19. data/examples/v201109/basic_operations/get_keywords.rb +7 -7
  20. data/examples/v201109/basic_operations/get_text_ads.rb +7 -7
  21. data/examples/v201109/basic_operations/pause_ad.rb +7 -7
  22. data/examples/v201109/basic_operations/update_ad_group.rb +6 -6
  23. data/examples/v201109/basic_operations/update_campaign.rb +6 -6
  24. data/examples/v201109/basic_operations/update_keyword.rb +7 -7
  25. data/examples/v201109/campaign_management/add_experiment.rb +14 -9
  26. data/examples/v201109/campaign_management/add_keywords_in_bulk.rb +5 -5
  27. data/examples/v201109/campaign_management/add_location_extension.rb +13 -7
  28. data/examples/v201109/campaign_management/add_location_extension_override.rb +7 -7
  29. data/examples/v201109/campaign_management/get_all_disapproved_ads.rb +6 -6
  30. data/examples/v201109/campaign_management/promote_experiment.rb +5 -6
  31. data/examples/v201109/campaign_management/set_ad_parameters.rb +8 -8
  32. data/examples/v201109/campaign_management/validate_text_ad.rb +7 -9
  33. data/examples/v201109/error_handling/handle_captcha_challenge.rb +3 -4
  34. data/examples/v201109/error_handling/handle_partial_failures.rb +5 -6
  35. data/examples/v201109/error_handling/handle_policy_violation_error.rb +5 -6
  36. data/examples/v201109/error_handling/handle_two_factor_authorization_error.rb +2 -2
  37. data/examples/v201109/misc/get_all_images_and_videos.rb +3 -3
  38. data/examples/v201109/misc/upload_image.rb +2 -2
  39. data/examples/v201109/misc/use_oauth.rb +3 -3
  40. data/examples/v201109/optimization/estimate_keyword_traffic.rb +2 -2
  41. data/examples/v201109/optimization/get_keyword_bid_simulations.rb +6 -7
  42. data/examples/v201109/optimization/get_keyword_ideas.rb +6 -7
  43. data/examples/v201109/optimization/get_placement_ideas.rb +6 -7
  44. data/examples/v201109/remarketing/add_audience.rb +5 -3
  45. data/examples/v201109/remarketing/add_conversion_tracker.rb +12 -3
  46. data/examples/v201109/reporting/download_criteria_report.rb +7 -8
  47. data/examples/v201109/reporting/download_defined_report.rb +6 -7
  48. data/examples/v201109/reporting/get_campaign_stats.rb +105 -0
  49. data/examples/v201109/reporting/get_defined_reports.rb +2 -2
  50. data/examples/v201109/reporting/get_report_fields.rb +6 -7
  51. data/examples/v201109/reporting/parallel_report_download.rb +8 -8
  52. data/examples/v201109/targeting/add_campaign_targeting_criteria.rb +5 -6
  53. data/examples/v201109/targeting/get_campaign_targeting_criteria.rb +7 -8
  54. data/examples/v201109/targeting/get_targetable_languages_and_carriers.rb +2 -2
  55. data/examples/v201109/targeting/lookup_location.rb +2 -2
  56. data/lib/adwords_api/version.rb +1 -1
  57. data/test/examples/v201109/test_account_management.rb +60 -0
  58. data/test/examples/v201109/test_basic_operations.rb +172 -0
  59. data/test/examples/v201109/test_campaign_management.rb +116 -0
  60. data/test/examples/v201109/test_error_handling.rb +63 -0
  61. data/test/examples/v201109/test_misc.rb +45 -0
  62. data/test/examples/v201109/test_optimization.rb +63 -0
  63. data/test/examples/v201109/test_remarketing.rb +39 -0
  64. data/test/examples/v201109/test_reporting.rb +89 -0
  65. data/test/examples/v201109/test_targeting.rb +60 -0
  66. data/test/examples/v201109/utils.rb +239 -0
  67. data/test/suite_exampletests.rb +31 -0
  68. metadata +18 -6
  69. data/examples/v201109/basic_operations/add_ad_group.rb +0 -89
  70. data/examples/v201109/basic_operations/add_campaign.rb +0 -99
@@ -0,0 +1,31 @@
1
+ #!/usr/bin/env ruby
2
+ # Encoding: utf-8
3
+ #
4
+ # Author:: api.dklimkin@gmail.com (Danial Klimkin)
5
+ #
6
+ # Copyright:: Copyright 2012, Google Inc. All Rights Reserved.
7
+ #
8
+ # License:: Licensed under the Apache License, Version 2.0 (the "License");
9
+ # you may not use this file except in compliance with the License.
10
+ # You may obtain a copy of the License at
11
+ #
12
+ # http://www.apache.org/licenses/LICENSE-2.0
13
+ #
14
+ # Unless required by applicable law or agreed to in writing, software
15
+ # distributed under the License is distributed on an "AS IS" BASIS,
16
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
17
+ # implied.
18
+ # See the License for the specific language governing permissions and
19
+ # limitations under the License.
20
+ #
21
+ # Test suite for example tests.
22
+
23
+ lib = File.expand_path('../../lib/', __FILE__)
24
+ $:.unshift lib unless $:.include?(lib)
25
+
26
+ require 'test/unit'
27
+
28
+ # v201109 example tests.
29
+ $:.unshift File.expand_path('../../examples/v201109', __FILE__)
30
+ Dir.glob('./test/examples/v201109/utils.rb').each {|file| require file}
31
+ Dir.glob('./test/examples/v201109/test*.rb').each {|file| require file}
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-adwords-api
3
3
  version: !ruby/object:Gem::Version
4
- hash: 9
4
+ hash: 15
5
5
  prerelease: false
6
6
  segments:
7
7
  - 0
8
8
  - 5
9
- - 1
10
- version: 0.5.1
9
+ - 2
10
+ version: 0.5.2
11
11
  platform: ruby
12
12
  authors:
13
13
  - Danial Klimkin
@@ -15,7 +15,7 @@ autorequire:
15
15
  bindir: bin
16
16
  cert_chain: []
17
17
 
18
- date: 2012-03-13 00:00:00 +04:00
18
+ date: 2012-03-20 00:00:00 +04:00
19
19
  default_executable:
20
20
  dependencies:
21
21
  - !ruby/object:Gem::Dependency
@@ -63,6 +63,7 @@ files:
63
63
  - examples/v201109/reporting/download_criteria_report.rb
64
64
  - examples/v201109/reporting/download_defined_report.rb
65
65
  - examples/v201109/reporting/get_defined_reports.rb
66
+ - examples/v201109/reporting/get_campaign_stats.rb
66
67
  - examples/v201109/reporting/parallel_report_download.rb
67
68
  - examples/v201109/reporting/get_report_fields.rb
68
69
  - examples/v201109/error_handling/handle_policy_violation_error.rb
@@ -94,11 +95,11 @@ files:
94
95
  - examples/v201109/basic_operations/update_campaign.rb
95
96
  - examples/v201109/basic_operations/get_campaigns.rb
96
97
  - examples/v201109/basic_operations/get_ad_groups.rb
97
- - examples/v201109/basic_operations/add_campaign.rb
98
- - examples/v201109/basic_operations/add_ad_group.rb
98
+ - examples/v201109/basic_operations/add_campaigns.rb
99
99
  - examples/v201109/basic_operations/delete_ad_group.rb
100
100
  - examples/v201109/basic_operations/delete_keyword.rb
101
101
  - examples/v201109/basic_operations/delete_ad.rb
102
+ - examples/v201109/basic_operations/add_ad_groups.rb
102
103
  - examples/v201109/basic_operations/update_ad_group.rb
103
104
  - examples/v201109/basic_operations/get_keywords.rb
104
105
  - examples/v201109/basic_operations/delete_campaign.rb
@@ -176,11 +177,22 @@ files:
176
177
  - lib/adwords_api/client_login_header_handler.rb
177
178
  - lib/adwords_api/v13_login_handler.rb
178
179
  - lib/adwords_api.rb
180
+ - test/examples/v201109/utils.rb
181
+ - test/examples/v201109/test_error_handling.rb
182
+ - test/examples/v201109/test_targeting.rb
183
+ - test/examples/v201109/test_misc.rb
184
+ - test/examples/v201109/test_remarketing.rb
185
+ - test/examples/v201109/test_account_management.rb
186
+ - test/examples/v201109/test_optimization.rb
187
+ - test/examples/v201109/test_reporting.rb
188
+ - test/examples/v201109/test_basic_operations.rb
189
+ - test/examples/v201109/test_campaign_management.rb
179
190
  - test/bugs/test_issue_00000031.rb
180
191
  - test/suite_unittests.rb
181
192
  - test/adwords_api/test_report_utils.rb
182
193
  - test/adwords_api/test_api_config.rb
183
194
  - test/adwords_api/test_utils.rb
195
+ - test/suite_exampletests.rb
184
196
  - COPYING
185
197
  - README
186
198
  - ChangeLog
@@ -1,89 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Author:: api.sgomes@gmail.com (Sérgio Gomes)
5
- #
6
- # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
7
- #
8
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
9
- # you may not use this file except in compliance with the License.
10
- # You may obtain a copy of the License at
11
- #
12
- # http://www.apache.org/licenses/LICENSE-2.0
13
- #
14
- # Unless required by applicable law or agreed to in writing, software
15
- # distributed under the License is distributed on an "AS IS" BASIS,
16
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
17
- # implied.
18
- # See the License for the specific language governing permissions and
19
- # limitations under the License.
20
- #
21
- # This example illustrates how to create an ad group. To create a campaign, run
22
- # add_campaign.rb.
23
- #
24
- # Tags: AdGroupService.mutate
25
-
26
- require 'adwords_api'
27
-
28
- API_VERSION = :v201109
29
-
30
- def add_ad_group()
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
-
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
- # adwords.logger = Logger.new('adwords_xml.log')
38
-
39
- ad_group_srv = adwords.service(:AdGroupService, API_VERSION)
40
-
41
- campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
42
-
43
- # Prepare for adding ad group.
44
- operation = {
45
- :operator => 'ADD',
46
- :operand => {
47
- :name => "Earth to Mars Cruises #%d" % (Time.new.to_f * 1000).to_i,
48
- :status => 'ENABLED',
49
- :campaign_id => campaign_id,
50
- :bids => {
51
- # The 'xsi_type' field allows you to specify the xsi:type of the object
52
- # being created. It's only necessary when you must provide an explicit
53
- # type that the client library can't infer.
54
- :xsi_type => 'ManualCPCAdGroupBids',
55
- :keyword_max_cpc => {
56
- :amount => {
57
- :micro_amount => 10000000
58
- }
59
- }
60
- },
61
- }
62
- }
63
-
64
- # Add ad group.
65
- response = ad_group_srv.mutate([operation])
66
- ad_group = response[:value].first
67
- puts "Ad group ID %d was successfully added." % ad_group[:id]
68
- end
69
-
70
- if __FILE__ == $0
71
- begin
72
- add_ad_group()
73
-
74
- # HTTP errors.
75
- rescue AdsCommon::Errors::HttpError => e
76
- puts "HTTP Error: %s" % e
77
-
78
- # API errors.
79
- rescue AdwordsApi::Errors::ApiException => e
80
- puts "Message: %s" % e.message
81
- puts 'Errors:'
82
- e.errors.each_with_index do |error, index|
83
- puts "\tError [%d]:" % (index + 1)
84
- error.each do |field, value|
85
- puts "\t\t%s: %s" % [field, value]
86
- end
87
- end
88
- end
89
- end
@@ -1,99 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Author:: api.sgomes@gmail.com (Sérgio Gomes)
5
- #
6
- # Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
7
- #
8
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
9
- # you may not use this file except in compliance with the License.
10
- # You may obtain a copy of the License at
11
- #
12
- # http://www.apache.org/licenses/LICENSE-2.0
13
- #
14
- # Unless required by applicable law or agreed to in writing, software
15
- # distributed under the License is distributed on an "AS IS" BASIS,
16
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
17
- # implied.
18
- # See the License for the specific language governing permissions and
19
- # limitations under the License.
20
- #
21
- # This example illustrates how to create a campaign.
22
- #
23
- # Tags: CampaignService.mutate
24
-
25
- require 'adwords_api'
26
-
27
- API_VERSION = :v201109
28
-
29
- def add_campaign()
30
- # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
31
- # when called without parameters.
32
- adwords = AdwordsApi::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
- # adwords.logger = Logger.new('adwords_xml.log')
37
-
38
- campaign_srv = adwords.service(:CampaignService, API_VERSION)
39
-
40
- # Prepare for adding campaign.
41
- operation = {
42
- :operator => 'ADD',
43
- :operand => {
44
- :name => "Interplanetary Cruise #%d" % (Time.new.to_f * 1000).to_i,
45
- :status => 'PAUSED',
46
- :bidding_strategy => {
47
- # The 'xsi_type' field allows you to specify the xsi:type of the object
48
- # being created. It's only necessary when you must provide an explicit
49
- # type that the client library can't infer.
50
- :xsi_type => 'ManualCPC'
51
- },
52
- :budget => {
53
- :period => 'DAILY',
54
- :amount => {
55
- :micro_amount => 50000000
56
- },
57
- :delivery_method => 'STANDARD'
58
- },
59
- # Set the campaign network options to Search and Search Network.
60
- :network_setting => {
61
- :target_google_search => true,
62
- :target_search_network => true,
63
- :target_content_network => false,
64
- :target_content_contextual => false
65
- }
66
- }
67
- }
68
-
69
- # Add campaign.
70
- response = campaign_srv.mutate([operation])
71
- if response and response[:value]
72
- campaign = response[:value].first
73
- puts "Campaign with name '%s' and ID %d was added." %
74
- [campaign[:name], campaign[:id]]
75
- else
76
- puts 'No campaigns were added.'
77
- end
78
- end
79
-
80
- if __FILE__ == $0
81
- begin
82
- add_campaign()
83
-
84
- # HTTP errors.
85
- rescue AdsCommon::Errors::HttpError => e
86
- puts "HTTP Error: %s" % e
87
-
88
- # API errors.
89
- rescue AdwordsApi::Errors::ApiException => e
90
- puts "Message: %s" % e.message
91
- puts 'Errors:'
92
- e.errors.each_with_index do |error, index|
93
- puts "\tError [%d]:" % (index + 1)
94
- error.each do |field, value|
95
- puts "\t\t%s: %s" % [field, value]
96
- end
97
- end
98
- end
99
- end