google-adwords-api 0.5.3 → 0.6.0
Sign up to get free protection for your applications and to get access to all the features.
- data/ChangeLog +7 -0
- data/README +4 -4
- data/examples/v201109_1/account_management/create_account.rb +80 -0
- data/examples/v201109_1/account_management/get_account_alerts.rb +111 -0
- data/examples/v201109_1/account_management/get_account_changes.rb +137 -0
- data/examples/v201109_1/account_management/get_account_hierarchy.rb +93 -0
- data/examples/v201109_1/account_management/get_client_customer_id.rb +85 -0
- data/examples/v201109_1/account_management/get_client_unit_usage.rb +87 -0
- data/examples/v201109_1/basic_operations/add_ad_groups.rb +111 -0
- data/examples/v201109_1/basic_operations/add_campaigns.rb +140 -0
- data/examples/v201109_1/basic_operations/add_keywords.rb +108 -0
- data/examples/v201109_1/basic_operations/add_text_ads.rb +105 -0
- data/examples/v201109_1/basic_operations/delete_ad.rb +85 -0
- data/examples/v201109_1/basic_operations/delete_ad_group.rb +102 -0
- data/examples/v201109_1/basic_operations/delete_campaign.rb +103 -0
- data/examples/v201109_1/basic_operations/delete_keyword.rb +90 -0
- data/examples/v201109_1/basic_operations/get_ad_groups.rb +98 -0
- data/examples/v201109_1/basic_operations/get_campaigns.rb +93 -0
- data/examples/v201109_1/basic_operations/get_keywords.rb +104 -0
- data/examples/v201109_1/basic_operations/get_text_ads.rb +106 -0
- data/examples/v201109_1/basic_operations/pause_ad.rb +84 -0
- data/examples/v201109_1/basic_operations/update_ad_group.rb +81 -0
- data/examples/v201109_1/basic_operations/update_campaign.rb +84 -0
- data/examples/v201109_1/basic_operations/update_keyword.rb +99 -0
- data/examples/v201109_1/campaign_management/add_experiment.rb +158 -0
- data/examples/v201109_1/campaign_management/add_keywords_in_bulk.rb +150 -0
- data/examples/v201109_1/campaign_management/add_location_extension.rb +117 -0
- data/examples/v201109_1/campaign_management/add_location_extension_override.rb +83 -0
- data/examples/v201109_1/campaign_management/get_all_disapproved_ads.rb +93 -0
- data/examples/v201109_1/campaign_management/promote_experiment.rb +77 -0
- data/examples/v201109_1/campaign_management/set_ad_parameters.rb +114 -0
- data/examples/v201109_1/campaign_management/validate_text_ad.rb +106 -0
- data/examples/v201109_1/error_handling/handle_captcha_challenge.rb +93 -0
- data/examples/v201109_1/error_handling/handle_partial_failures.rb +126 -0
- data/examples/v201109_1/error_handling/handle_policy_violation_error.rb +137 -0
- data/examples/v201109_1/error_handling/handle_two_factor_authorization_error.rb +87 -0
- data/examples/v201109_1/misc/get_all_images_and_videos.rb +101 -0
- data/examples/v201109_1/misc/upload_image.rb +90 -0
- data/examples/v201109_1/misc/use_oauth.rb +97 -0
- data/examples/v201109_1/optimization/estimate_keyword_traffic.rb +129 -0
- data/examples/v201109_1/optimization/get_keyword_bid_simulations.rb +92 -0
- data/examples/v201109_1/optimization/get_keyword_ideas.rb +113 -0
- data/examples/v201109_1/optimization/get_placement_ideas.rb +106 -0
- data/examples/v201109_1/remarketing/add_audience.rb +115 -0
- data/examples/v201109_1/remarketing/add_conversion_tracker.rb +97 -0
- data/examples/v201109_1/reporting/download_criteria_report.rb +79 -0
- data/examples/v201109_1/reporting/get_campaign_stats.rb +105 -0
- data/examples/v201109_1/reporting/get_defined_reports.rb +75 -0
- data/examples/{v201109/reporting/download_defined_report.rb → v201109_1/reporting/get_report_fields.rb} +15 -11
- data/examples/v201109_1/reporting/parallel_report_download.rb +159 -0
- data/examples/v201109_1/targeting/add_campaign_targeting_criteria.rb +118 -0
- data/examples/v201109_1/targeting/get_campaign_targeting_criteria.rb +102 -0
- data/examples/v201109_1/targeting/get_targetable_languages_and_carriers.rb +86 -0
- data/examples/v201109_1/targeting/lookup_location.rb +103 -0
- data/lib/adwords_api.rb +15 -88
- data/lib/adwords_api/api_config.rb +75 -33
- data/lib/adwords_api/client_login_header_handler.rb +17 -26
- data/lib/adwords_api/credential_handler.rb +29 -65
- data/lib/adwords_api/report_header_handler.rb +65 -0
- data/lib/adwords_api/report_utils.rb +12 -36
- data/lib/adwords_api/v201109/ad_extension_override_service.rb +3 -3
- data/lib/adwords_api/v201109/ad_extension_override_service_registry.rb +2 -2
- data/lib/adwords_api/v201109/ad_group_ad_service.rb +3 -3
- data/lib/adwords_api/v201109/ad_group_ad_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/ad_group_criterion_service.rb +3 -3
- data/lib/adwords_api/v201109/ad_group_criterion_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/ad_group_service.rb +3 -3
- data/lib/adwords_api/v201109/ad_group_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/ad_param_service.rb +3 -3
- data/lib/adwords_api/v201109/ad_param_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/alert_service.rb +3 -3
- data/lib/adwords_api/v201109/alert_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/budget_order_service.rb +42 -0
- data/lib/adwords_api/v201109/budget_order_service_registry.rb +46 -0
- data/lib/adwords_api/v201109/bulk_mutate_job_service.rb +3 -3
- data/lib/adwords_api/v201109/bulk_mutate_job_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/campaign_ad_extension_service.rb +3 -3
- data/lib/adwords_api/v201109/campaign_ad_extension_service_registry.rb +2 -2
- data/lib/adwords_api/v201109/campaign_criterion_service.rb +3 -3
- data/lib/adwords_api/v201109/campaign_criterion_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/campaign_service.rb +3 -3
- data/lib/adwords_api/v201109/campaign_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/campaign_target_service.rb +3 -3
- data/lib/adwords_api/v201109/campaign_target_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/constant_data_service.rb +3 -3
- data/lib/adwords_api/v201109/constant_data_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/conversion_tracker_service.rb +3 -3
- data/lib/adwords_api/v201109/conversion_tracker_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/create_account_service.rb +3 -3
- data/lib/adwords_api/v201109/create_account_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/customer_sync_service.rb +3 -3
- data/lib/adwords_api/v201109/customer_sync_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/data_service.rb +3 -3
- data/lib/adwords_api/v201109/data_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/experiment_service.rb +3 -3
- data/lib/adwords_api/v201109/experiment_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/geo_location_service.rb +3 -3
- data/lib/adwords_api/v201109/geo_location_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/info_service.rb +3 -3
- data/lib/adwords_api/v201109/info_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/location_criterion_service.rb +3 -3
- data/lib/adwords_api/v201109/location_criterion_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/media_service.rb +3 -3
- data/lib/adwords_api/v201109/media_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/mutate_job_service.rb +3 -3
- data/lib/adwords_api/v201109/mutate_job_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/report_definition_service.rb +3 -12
- data/lib/adwords_api/v201109/report_definition_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/serviced_account_service.rb +3 -3
- data/lib/adwords_api/v201109/serviced_account_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/targeting_idea_service.rb +3 -3
- data/lib/adwords_api/v201109/targeting_idea_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/traffic_estimator_service.rb +3 -3
- data/lib/adwords_api/v201109/traffic_estimator_service_registry.rb +1 -1
- data/lib/adwords_api/v201109/user_list_service.rb +3 -3
- data/lib/adwords_api/v201109/user_list_service_registry.rb +1 -1
- data/lib/adwords_api/v201109_1/ad_extension_override_service.rb +38 -0
- data/lib/adwords_api/v201109_1/ad_extension_override_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/ad_group_ad_service.rb +38 -0
- data/lib/adwords_api/v201109_1/ad_group_ad_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/ad_group_criterion_service.rb +38 -0
- data/lib/adwords_api/v201109_1/ad_group_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/ad_group_service.rb +38 -0
- data/lib/adwords_api/v201109_1/ad_group_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/ad_param_service.rb +38 -0
- data/lib/adwords_api/v201109_1/ad_param_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/alert_service.rb +34 -0
- data/lib/adwords_api/v201109_1/alert_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/budget_order_service.rb +42 -0
- data/lib/adwords_api/v201109_1/budget_order_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/bulk_mutate_job_service.rb +38 -0
- data/lib/adwords_api/v201109_1/bulk_mutate_job_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/campaign_ad_extension_service.rb +38 -0
- data/lib/adwords_api/v201109_1/campaign_ad_extension_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/campaign_criterion_service.rb +38 -0
- data/lib/adwords_api/v201109_1/campaign_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/campaign_service.rb +38 -0
- data/lib/adwords_api/v201109_1/campaign_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/campaign_target_service.rb +38 -0
- data/lib/adwords_api/v201109_1/campaign_target_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/constant_data_service.rb +38 -0
- data/lib/adwords_api/v201109_1/constant_data_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/conversion_tracker_service.rb +38 -0
- data/lib/adwords_api/v201109_1/conversion_tracker_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/create_account_service.rb +34 -0
- data/lib/adwords_api/v201109_1/create_account_service_registry.rb +47 -0
- data/lib/adwords_api/v201109_1/customer_sync_service.rb +34 -0
- data/lib/adwords_api/v201109_1/customer_sync_service_registry.rb +47 -0
- data/lib/adwords_api/v201109_1/data_service.rb +38 -0
- data/lib/adwords_api/v201109_1/data_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/experiment_service.rb +38 -0
- data/lib/adwords_api/v201109_1/experiment_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/geo_location_service.rb +34 -0
- data/lib/adwords_api/v201109_1/geo_location_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/info_service.rb +34 -0
- data/lib/adwords_api/v201109_1/info_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/location_criterion_service.rb +34 -0
- data/lib/adwords_api/v201109_1/location_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/media_service.rb +38 -0
- data/lib/adwords_api/v201109_1/media_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/mutate_job_service.rb +42 -0
- data/lib/adwords_api/v201109_1/mutate_job_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/report_definition_service.rb +38 -0
- data/lib/adwords_api/v201109_1/report_definition_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/serviced_account_service.rb +34 -0
- data/lib/adwords_api/v201109_1/serviced_account_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/targeting_idea_service.rb +38 -0
- data/lib/adwords_api/v201109_1/targeting_idea_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/traffic_estimator_service.rb +34 -0
- data/lib/adwords_api/v201109_1/traffic_estimator_service_registry.rb +46 -0
- data/lib/adwords_api/v201109_1/user_list_service.rb +38 -0
- data/lib/adwords_api/v201109_1/user_list_service_registry.rb +46 -0
- data/lib/adwords_api/version.rb +1 -1
- data/test/adwords_api/test_api_config.rb +24 -8
- data/test/adwords_api/test_credential_handler.rb +32 -52
- data/test/coverage.rb +38 -0
- data/test/examples/v201109/test_reporting.rb +0 -12
- data/test/examples/v201109_1/test_account_management.rb +60 -0
- data/test/examples/v201109_1/test_basic_operations.rb +172 -0
- data/test/examples/v201109_1/test_campaign_management.rb +116 -0
- data/test/examples/v201109_1/test_error_handling.rb +63 -0
- data/{lib/adwords_api/v13_login_handler.rb → test/examples/v201109_1/test_misc.rb} +24 -10
- data/test/examples/v201109_1/test_optimization.rb +63 -0
- data/test/{suite_exampletests.rb → examples/v201109_1/test_remarketing.rb} +16 -8
- data/test/examples/v201109_1/test_reporting.rb +77 -0
- data/test/examples/v201109_1/test_targeting.rb +60 -0
- data/test/examples/v201109_1/utils.rb +239 -0
- data/test/suite_exampletests_v201109.rb +37 -0
- data/test/suite_exampletests_v201109_1.rb +37 -0
- data/test/suite_unittests.rb +7 -5
- metadata +136 -11
- data/lib/adwords_api/extensions.rb +0 -269
@@ -0,0 +1,106 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
3
|
+
#
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
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 shows how to use the 'validate only' header. No objects will be
|
22
|
+
# created, but exceptions will still be thrown.
|
23
|
+
#
|
24
|
+
# Tags: CampaignService.mutate
|
25
|
+
|
26
|
+
require 'adwords_api'
|
27
|
+
|
28
|
+
def validate_text_ad(ad_group_id)
|
29
|
+
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
30
|
+
# when called without parameters.
|
31
|
+
adwords = AdwordsApi::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
|
+
# adwords.logger = Logger.new('adwords_xml.log')
|
36
|
+
|
37
|
+
ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
|
38
|
+
|
39
|
+
# Enable 'validate only' option.
|
40
|
+
adwords.validate_only = true
|
41
|
+
|
42
|
+
# Prepare for adding text ad.
|
43
|
+
operation = {
|
44
|
+
:operator => 'ADD',
|
45
|
+
:operand => {
|
46
|
+
:ad_group_id => ad_group_id,
|
47
|
+
:ad => {
|
48
|
+
:xsi_type => 'TextAd',
|
49
|
+
:headline => 'Luxury Cruise to Mars',
|
50
|
+
:description1 => 'Visit the Red Planet in style.',
|
51
|
+
:description2 => 'Low-gravity fun for everyone!',
|
52
|
+
:url => 'http://www.example.com',
|
53
|
+
:display_url => 'www.example.com'
|
54
|
+
}
|
55
|
+
}
|
56
|
+
}
|
57
|
+
|
58
|
+
# Validate text ad add operation.
|
59
|
+
response = ad_group_ad_srv.mutate([operation])
|
60
|
+
if response and response[:value]
|
61
|
+
ad = response[:value].first
|
62
|
+
puts "Unexpected ad creation! Name '%s', ID %d and status '%s'." %
|
63
|
+
[campaign[:name], campaign[:id], campaign[:status]]
|
64
|
+
else
|
65
|
+
puts 'Text ad validated, no error thrown and no ad created.'
|
66
|
+
end
|
67
|
+
|
68
|
+
# Now let's check an invalid ad using extra punctuation to trigger an error.
|
69
|
+
operation[:operand][:ad][:headline] = 'Luxury Cruise to Mars!!!!!'
|
70
|
+
|
71
|
+
# Validate text ad add operation.
|
72
|
+
begin
|
73
|
+
response = ad_group_ad_srv.mutate([operation])
|
74
|
+
if response and response[:value]
|
75
|
+
ad = response[:value].first
|
76
|
+
raise StandardError, ("Unexpected ad creation! Name '%s', ID %d and " +
|
77
|
+
"status '%s'.") % [campaign[:name], campaign[:id], campaign[:status]]
|
78
|
+
end
|
79
|
+
rescue AdwordsApi::Errors::ApiException => e
|
80
|
+
puts "Validation correctly failed with an exception: %s" % e.class
|
81
|
+
end
|
82
|
+
end
|
83
|
+
|
84
|
+
if __FILE__ == $0
|
85
|
+
API_VERSION = :v201109_1
|
86
|
+
|
87
|
+
begin
|
88
|
+
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
89
|
+
validate_text_ad(ad_group_id)
|
90
|
+
|
91
|
+
# HTTP errors.
|
92
|
+
rescue AdsCommon::Errors::HttpError => e
|
93
|
+
puts "HTTP Error: %s" % e
|
94
|
+
|
95
|
+
# API errors.
|
96
|
+
rescue AdwordsApi::Errors::ApiException => e
|
97
|
+
puts "Message: %s" % e.message
|
98
|
+
puts 'Errors:'
|
99
|
+
e.errors.each_with_index do |error, index|
|
100
|
+
puts "\tError [%d]:" % (index + 1)
|
101
|
+
error.each do |field, value|
|
102
|
+
puts "\t\t%s: %s" % [field, value]
|
103
|
+
end
|
104
|
+
end
|
105
|
+
end
|
106
|
+
end
|
@@ -0,0 +1,93 @@
|
|
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
|
+
# This example illustrates how to handle 'CAPTCHA required' authorization
|
22
|
+
# errors. Refer to the best practices guide on how to avoid this error:
|
23
|
+
#
|
24
|
+
# http://code.google.com/apis/adwords/docs/guides/bestpractices.html#auth_tokens
|
25
|
+
|
26
|
+
require 'adwords_api'
|
27
|
+
|
28
|
+
def handle_captcha_challenge()
|
29
|
+
# Initialize token variable.
|
30
|
+
logintoken = nil
|
31
|
+
|
32
|
+
# This code will repeatedly request authToken from the server until it gets
|
33
|
+
# a CAPTCHA challenge request. It is here for illustration purposes only
|
34
|
+
# and should never be used in a real application.
|
35
|
+
begin
|
36
|
+
MAX_RETRIES.times do |retry_number|
|
37
|
+
puts "Running request %d of %d..." % [retry_number + 1, MAX_RETRIES]
|
38
|
+
# Forcing library to request a new authorization token.
|
39
|
+
adwords = AdwordsApi::Api.new
|
40
|
+
auth_token = adwords.authorize()
|
41
|
+
end
|
42
|
+
# Still no challenge, make sure ClientLogin authorization is used.
|
43
|
+
raise StandardError, "Failed to get challenge after %d requests." %
|
44
|
+
MAX_RETRIES
|
45
|
+
rescue AdsCommon::Errors::CaptchaRequiredError => e
|
46
|
+
logintoken = e.captcha_token
|
47
|
+
end
|
48
|
+
|
49
|
+
puts "CaptchaRequiredError occurred. To recover download the image and type" +
|
50
|
+
" the CAPTCHA below: %s\n" % e.captcha_url
|
51
|
+
puts 'Enter code or ENTER to retry: '
|
52
|
+
logincaptcha = gets.chomp
|
53
|
+
|
54
|
+
# Initialize variable for extra parameters.
|
55
|
+
credentials = {}
|
56
|
+
if logincaptcha and !logincaptcha.empty?
|
57
|
+
credentials[:logincaptcha] = logincaptcha
|
58
|
+
credentials[:logintoken] = logintoken
|
59
|
+
end
|
60
|
+
|
61
|
+
begin
|
62
|
+
adwords = AdwordsApi::Api.new
|
63
|
+
auth_token = adwords.authorize(credentials)
|
64
|
+
puts "Successfully retrieved authToken: " + auth_token
|
65
|
+
rescue AdsCommon::Errors::CaptchaRequiredError => e
|
66
|
+
puts 'Invalid CAPTCHA text entered.'
|
67
|
+
raise e
|
68
|
+
end
|
69
|
+
end
|
70
|
+
|
71
|
+
if __FILE__ == $0
|
72
|
+
API_VERSION = :v201109_1
|
73
|
+
MAX_RETRIES = 500
|
74
|
+
|
75
|
+
begin
|
76
|
+
handle_captcha_challenge()
|
77
|
+
|
78
|
+
# HTTP errors.
|
79
|
+
rescue AdsCommon::Errors::HttpError => e
|
80
|
+
puts "HTTP Error: %s" % e
|
81
|
+
|
82
|
+
# API errors.
|
83
|
+
rescue AdwordsApi::Errors::ApiException => e
|
84
|
+
puts "Message: %s" % e.message
|
85
|
+
puts 'Errors:'
|
86
|
+
e.errors.each_with_index do |error, index|
|
87
|
+
puts "\tError [%d]:" % (index + 1)
|
88
|
+
error.each do |field, value|
|
89
|
+
puts "\t\t%s: %s" % [field, value]
|
90
|
+
end
|
91
|
+
end
|
92
|
+
end
|
93
|
+
end
|
@@ -0,0 +1,126 @@
|
|
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 demonstrates how to handle partial failures.
|
22
|
+
#
|
23
|
+
# Tags: AdGroupCriterionService.mutate
|
24
|
+
|
25
|
+
require 'adwords_api'
|
26
|
+
require 'adwords_api/utils'
|
27
|
+
|
28
|
+
def handle_partial_failures(ad_group_id)
|
29
|
+
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
30
|
+
# when called without parameters.
|
31
|
+
adwords = AdwordsApi::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
|
+
# adwords.logger = Logger.new('adwords_xml.log')
|
36
|
+
|
37
|
+
ad_group_criterion_srv =
|
38
|
+
adwords.service(:AdGroupCriterionService, API_VERSION)
|
39
|
+
|
40
|
+
# Set partial failures flag.
|
41
|
+
adwords.partial_failure = true
|
42
|
+
|
43
|
+
# Create keywords.
|
44
|
+
keyword_text = ['mars cruise', 'inv@lid cruise', 'venus cruise',
|
45
|
+
'b(a)d keyword cruise']
|
46
|
+
keywords = []
|
47
|
+
keyword_text.each do |text|
|
48
|
+
keyword = {
|
49
|
+
# The 'xsi_type' field allows you to specify the xsi:type of the object
|
50
|
+
# being created. It's only necessary when you must provide an explicit
|
51
|
+
# type that the client library can't infer.
|
52
|
+
:xsi_type => 'Keyword',
|
53
|
+
:match_type => 'BROAD',
|
54
|
+
:text => text
|
55
|
+
}
|
56
|
+
keywords << keyword
|
57
|
+
end
|
58
|
+
|
59
|
+
# Create biddable ad group criteria and operations.
|
60
|
+
operations = []
|
61
|
+
keywords.each do |kwd|
|
62
|
+
operation = {
|
63
|
+
:operator => 'ADD',
|
64
|
+
:operand => {
|
65
|
+
:xsi_type => 'BiddableAdGroupCriterion',
|
66
|
+
:ad_group_id => ad_group_id,
|
67
|
+
:criterion => kwd
|
68
|
+
}
|
69
|
+
}
|
70
|
+
operations << operation
|
71
|
+
end
|
72
|
+
|
73
|
+
# Add criteria.
|
74
|
+
response = ad_group_criterion_srv.mutate(operations)
|
75
|
+
if response and response[:value]
|
76
|
+
ad_group_criteria = response[:value]
|
77
|
+
ad_group_criteria.each do |ad_group_criterion|
|
78
|
+
if ad_group_criterion[:criterion]
|
79
|
+
puts "Ad group criterion with ad group id " +
|
80
|
+
"#{ad_group_criterion[:ad_group_id]}, criterion id "+
|
81
|
+
"#{ad_group_criterion[:criterion][:id]} and keyword \"" +
|
82
|
+
"#{ad_group_criterion[:criterion][:text]}\" was added."
|
83
|
+
end
|
84
|
+
end
|
85
|
+
else
|
86
|
+
puts "No criteria were added."
|
87
|
+
end
|
88
|
+
|
89
|
+
# Check partial failures.
|
90
|
+
if response and response[:partial_failure_errors]
|
91
|
+
response[:partial_failure_errors].each do |error|
|
92
|
+
operation_index = AdwordsApi::Utils.operation_index_for_error(error)
|
93
|
+
if operation_index
|
94
|
+
ad_group_criterion = operations[operation_index][:operand]
|
95
|
+
puts "Ad group criterion with ad group id " +
|
96
|
+
"#{ad_group_criterion[:ad_group_id]} and keyword \"" +
|
97
|
+
"#{ad_group_criterion[:criterion][:text]}\" triggered an error " +
|
98
|
+
"for the following reason: \"#{error[:error_string]}\"."
|
99
|
+
end
|
100
|
+
end
|
101
|
+
end
|
102
|
+
end
|
103
|
+
|
104
|
+
if __FILE__ == $0
|
105
|
+
API_VERSION = :v201109_1
|
106
|
+
|
107
|
+
begin
|
108
|
+
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
109
|
+
handle_partial_failures(ad_group_id)
|
110
|
+
|
111
|
+
# HTTP errors.
|
112
|
+
rescue AdsCommon::Errors::HttpError => e
|
113
|
+
puts "HTTP Error: %s" % e
|
114
|
+
|
115
|
+
# API errors.
|
116
|
+
rescue AdwordsApi::Errors::ApiException => e
|
117
|
+
puts "Message: %s" % e.message
|
118
|
+
puts 'Errors:'
|
119
|
+
e.errors.each_with_index do |error, index|
|
120
|
+
puts "\tError [%d]:" % (index + 1)
|
121
|
+
error.each do |field, value|
|
122
|
+
puts "\t\t%s: %s" % [field, value]
|
123
|
+
end
|
124
|
+
end
|
125
|
+
end
|
126
|
+
end
|
@@ -0,0 +1,137 @@
|
|
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 demonstrates how to handle policy violation errors. To create
|
22
|
+
# an ad group, run add_ad_group.rb.
|
23
|
+
#
|
24
|
+
# Tags: AdGroupAdService.mutate
|
25
|
+
|
26
|
+
require 'adwords_api'
|
27
|
+
require 'adwords_api/utils'
|
28
|
+
|
29
|
+
def handle_policy_violation_error(ad_group_id)
|
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
|
+
ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
|
39
|
+
|
40
|
+
# Create text ad.
|
41
|
+
text_ad_operation = {
|
42
|
+
:operator => 'ADD',
|
43
|
+
:operand => {
|
44
|
+
:ad_group_id => ad_group_id,
|
45
|
+
:ad => {
|
46
|
+
# The 'xsi_type' field allows you to specify the xsi:type of the object
|
47
|
+
# being created. It's only necessary when you must provide an explicit
|
48
|
+
# type that the client library can't infer.
|
49
|
+
:xsi_type => 'TextAd',
|
50
|
+
:headline => 'Mars Cruise!!!',
|
51
|
+
:description1 => 'Visit the Red Planet in style.',
|
52
|
+
:description2 => 'Low-gravity fun for everyone!',
|
53
|
+
:url => 'http://www.example.com',
|
54
|
+
:display_url => 'www.example.com',
|
55
|
+
}
|
56
|
+
}
|
57
|
+
}
|
58
|
+
|
59
|
+
operations = [text_ad_operation]
|
60
|
+
|
61
|
+
# Validate ad.
|
62
|
+
begin
|
63
|
+
# Enable "validate only" for the length of this block
|
64
|
+
adwords.validate_only do
|
65
|
+
ad_group_ad_srv.mutate(operations)
|
66
|
+
end
|
67
|
+
puts 'Validation successful, no errors returned.'
|
68
|
+
rescue AdwordsApi::Errors::ApiException => e
|
69
|
+
e.errors.each do |error|
|
70
|
+
if error[:xsi_type] == 'PolicyViolationError'
|
71
|
+
operation_index = AdwordsApi::Utils.operation_index_for_error(error)
|
72
|
+
operation = operations[operation_index]
|
73
|
+
puts "Ad with headline '%s' violated %s policy '%s'." %
|
74
|
+
[operation[:operand][:ad][:headline],
|
75
|
+
error[:is_exemptable] ? 'exemptable' : 'non-exemptable',
|
76
|
+
error[:external_policy_name]]
|
77
|
+
if error[:is_exemptable]
|
78
|
+
# Add exemption request to the operation.
|
79
|
+
puts "Adding exemption request for policy name '%s' on text '%s'." %
|
80
|
+
[error[:key][:policy_name], error[:key][:violating_text]]
|
81
|
+
unless operation[:exemption_requests]
|
82
|
+
operation[:exemption_requests] = []
|
83
|
+
end
|
84
|
+
operation[:exemption_requests] << {
|
85
|
+
:key => error[:key]
|
86
|
+
}
|
87
|
+
else
|
88
|
+
# Remove non-exemptable operation
|
89
|
+
puts "Removing the operation from the request."
|
90
|
+
operations.delete(operation)
|
91
|
+
end
|
92
|
+
else
|
93
|
+
# Non-policy error returned, re-throw exception.
|
94
|
+
raise e
|
95
|
+
end
|
96
|
+
end
|
97
|
+
end
|
98
|
+
|
99
|
+
# Add ads.
|
100
|
+
if operations.size > 0
|
101
|
+
response = ad_group_ad_srv.mutate(operations)
|
102
|
+
if response and response[:value]
|
103
|
+
ads = response[:value]
|
104
|
+
puts "Added #{ads.length} ad(s) to ad group #{ad_group_id}."
|
105
|
+
ads.each do |ad|
|
106
|
+
puts " Ad id is #{ad[:ad][:id]}, type is #{ad[:ad][:xsi_type]} and " +
|
107
|
+
"status is \"#{ad[:status]}\"."
|
108
|
+
end
|
109
|
+
else
|
110
|
+
puts "No ads were added."
|
111
|
+
end
|
112
|
+
end
|
113
|
+
end
|
114
|
+
|
115
|
+
if __FILE__ == $0
|
116
|
+
API_VERSION = :v201109_1
|
117
|
+
|
118
|
+
begin
|
119
|
+
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
120
|
+
handle_policy_violation_error(ad_group_id)
|
121
|
+
|
122
|
+
# HTTP errors.
|
123
|
+
rescue AdsCommon::Errors::HttpError => e
|
124
|
+
puts "HTTP Error: %s" % e
|
125
|
+
|
126
|
+
# API errors.
|
127
|
+
rescue AdwordsApi::Errors::ApiException => e
|
128
|
+
puts "Message: %s" % e.message
|
129
|
+
puts 'Errors:'
|
130
|
+
e.errors.each_with_index do |error, index|
|
131
|
+
puts "\tError [%d]:" % (index + 1)
|
132
|
+
error.each do |field, value|
|
133
|
+
puts "\t\t%s: %s" % [field, value]
|
134
|
+
end
|
135
|
+
end
|
136
|
+
end
|
137
|
+
end
|