google-dfp-api 0.7.0 → 0.7.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +8 -8
- data/ChangeLog +4 -0
- data/README +2 -2
- data/examples/v201208/common/setup_oauth2.rb +89 -0
- data/examples/v201211/common/setup_oauth2.rb +89 -0
- data/examples/v201302/common/setup_oauth2.rb +89 -0
- data/examples/v201306/common/setup_oauth2.rb +89 -0
- data/examples/v201308/common/setup_oauth2.rb +89 -0
- data/examples/v201311/activity_group_service/create_activity_groups.rb +94 -0
- data/examples/v201311/activity_group_service/get_active_activity_groups.rb +100 -0
- data/examples/v201311/activity_group_service/get_all_activity_groups.rb +95 -0
- data/examples/v201311/activity_group_service/update_activity_groups.rb +87 -0
- data/examples/v201311/activity_service/create_activities.rb +91 -0
- data/examples/v201311/activity_service/get_active_activities.rb +103 -0
- data/examples/v201311/activity_service/get_all_activities.rb +96 -0
- data/examples/v201311/activity_service/update_activities.rb +85 -0
- data/examples/v201311/audience_segment_service/create_audience_segments.rb +118 -0
- data/examples/v201311/audience_segment_service/get_all_audience_segments.rb +94 -0
- data/examples/v201311/audience_segment_service/get_first_party_audience_segments.rb +99 -0
- data/examples/v201311/audience_segment_service/populate_first_party_audience_segments.rb +101 -0
- data/examples/v201311/audience_segment_service/update_audience_segments.rb +98 -0
- data/examples/v201311/common/error_handling.rb +76 -0
- data/examples/{v201208/common/oauth2_handling.rb → v201311/common/oauth2_jwt_handling.rb} +20 -41
- data/examples/v201311/common/setup_oauth2.rb +89 -0
- data/examples/v201311/company_service/create_companies.rb +81 -0
- data/examples/v201311/company_service/get_all_companies.rb +92 -0
- data/examples/v201311/company_service/get_companies_by_statement.rb +88 -0
- data/examples/v201311/company_service/get_company.rb +72 -0
- data/examples/v201311/company_service/update_companies.rb +102 -0
- data/examples/v201311/contact_service/create_contacts.rb +95 -0
- data/examples/v201311/contact_service/get_all_contacts.rb +92 -0
- data/examples/v201311/contact_service/get_uninvited_contacts.rb +102 -0
- data/examples/v201311/contact_service/update_contacts.rb +84 -0
- data/examples/v201311/content_service/get_all_content.rb +94 -0
- data/examples/v201311/content_service/get_content_by_category.rb +143 -0
- data/examples/v201311/creative_service/copy_image_creatives.rb +115 -0
- data/examples/v201311/creative_service/create_creative_from_template.rb +139 -0
- data/examples/v201311/creative_service/create_creatives.rb +112 -0
- data/examples/v201311/creative_service/create_custom_creative.rb +104 -0
- data/examples/v201311/creative_service/get_all_creatives.rb +93 -0
- data/examples/v201311/creative_service/get_creative.rb +72 -0
- data/examples/v201311/creative_service/get_creatives_by_statement.rb +87 -0
- data/examples/v201311/creative_service/update_creatives.rb +96 -0
- data/examples/v201311/creative_set_service/associate_creative_set_to_line_item.rb +77 -0
- data/examples/v201311/creative_set_service/create_creative_set.rb +83 -0
- data/examples/v201311/creative_set_service/get_all_creative_sets.rb +94 -0
- data/examples/v201311/creative_set_service/get_creative_sets_by_statement.rb +90 -0
- data/examples/v201311/creative_set_service/update_creative_sets.rb +85 -0
- data/examples/v201311/creative_template_service/get_all_creative_templates.rb +94 -0
- data/examples/v201311/creative_template_service/get_creative_template.rb +74 -0
- data/examples/v201311/creative_template_service/get_creative_templates_by_statement.rb +80 -0
- data/examples/v201311/creative_wrapper_service/create_creative_wrappers.rb +89 -0
- data/examples/v201311/creative_wrapper_service/deactivate_creative_wrapper.rb +102 -0
- data/examples/v201311/creative_wrapper_service/get_all_creative_wrappers.rb +94 -0
- data/examples/v201311/creative_wrapper_service/get_creative_wrappers_by_statement.rb +88 -0
- data/examples/v201311/creative_wrapper_service/update_creative_wrappers.rb +86 -0
- data/examples/v201311/custom_field_service/create_custom_field_options.rb +87 -0
- data/examples/v201311/custom_field_service/create_custom_fields.rb +86 -0
- data/examples/v201311/custom_field_service/deactivate_all_line_item_custom_fields.rb +112 -0
- data/examples/v201311/custom_field_service/get_all_custom_fields.rb +102 -0
- data/examples/v201311/custom_field_service/get_all_line_item_custom_fields.rb +86 -0
- data/examples/v201311/custom_field_service/set_line_item_custom_field_value.rb +135 -0
- data/examples/v201311/custom_field_service/update_custom_fields.rb +84 -0
- data/examples/v201311/custom_targeting_service/create_custom_targeting_keys_and_values.rb +140 -0
- data/examples/v201311/custom_targeting_service/delete_custom_targeting_keys.rb +121 -0
- data/examples/v201311/custom_targeting_service/delete_custom_targeting_values.rb +125 -0
- data/examples/v201311/custom_targeting_service/get_all_custom_targeting_keys_and_values.rb +148 -0
- data/examples/v201311/custom_targeting_service/get_custom_targeting_keys_by_statement.rb +92 -0
- data/examples/v201311/custom_targeting_service/get_custom_targeting_values_by_statement.rb +98 -0
- data/examples/v201311/custom_targeting_service/update_custom_targeting_keys.rb +94 -0
- data/examples/v201311/custom_targeting_service/update_custom_targeting_values.rb +106 -0
- data/examples/v201311/forecast_service/get_forecast.rb +108 -0
- data/examples/v201311/forecast_service/get_forecast_by_id.rb +81 -0
- data/examples/v201311/inventory_service/create_ad_units.rb +101 -0
- data/examples/v201311/inventory_service/create_mobile_ad_unit.rb +101 -0
- data/examples/v201311/inventory_service/create_video_ad_unit.rb +108 -0
- data/examples/v201311/inventory_service/deactivate_ad_units.rb +119 -0
- data/examples/v201311/inventory_service/get_ad_unit.rb +72 -0
- data/examples/v201311/inventory_service/get_ad_unit_sizes.rb +85 -0
- data/examples/v201311/inventory_service/get_ad_units_by_statement.rb +96 -0
- data/examples/v201311/inventory_service/get_all_ad_units.rb +93 -0
- data/examples/v201311/inventory_service/update_ad_units.rb +96 -0
- data/examples/v201311/label_service/create_labels.rb +83 -0
- data/examples/v201311/label_service/deactivate_labels.rb +118 -0
- data/examples/v201311/label_service/get_all_labels.rb +95 -0
- data/examples/v201311/label_service/get_label.rb +76 -0
- data/examples/v201311/label_service/get_labels_by_statement.rb +81 -0
- data/examples/v201311/label_service/update_labels.rb +102 -0
- data/examples/v201311/line_item_creative_association_service/create_licas.rb +94 -0
- data/examples/v201311/line_item_creative_association_service/deactivate_licas.rb +127 -0
- data/examples/v201311/line_item_creative_association_service/get_all_licas.rb +98 -0
- data/examples/v201311/line_item_creative_association_service/get_lica.rb +77 -0
- data/examples/v201311/line_item_creative_association_service/get_licas_by_statement.rb +91 -0
- data/examples/v201311/line_item_creative_association_service/update_licas.rb +91 -0
- data/examples/v201311/line_item_service/activate_line_items.rb +131 -0
- data/examples/v201311/line_item_service/create_line_items.rb +177 -0
- data/examples/v201311/line_item_service/create_mobile_line_item.rb +135 -0
- data/examples/v201311/line_item_service/create_video_line_item.rb +158 -0
- data/examples/v201311/line_item_service/get_all_line_items.rb +94 -0
- data/examples/v201311/line_item_service/get_line_item.rb +74 -0
- data/examples/v201311/line_item_service/get_line_items_by_statement.rb +93 -0
- data/examples/v201311/line_item_service/get_recently_updated_line_items.rb +98 -0
- data/examples/v201311/line_item_service/target_custom_criteria.rb +129 -0
- data/examples/v201311/line_item_service/update_line_items.rb +109 -0
- data/examples/v201311/network_service/get_all_networks.rb +74 -0
- data/examples/v201311/network_service/get_current_network.rb +66 -0
- data/examples/v201311/network_service/make_test_network.rb +79 -0
- data/examples/v201311/order_service/approve_orders.rb +122 -0
- data/examples/v201311/order_service/create_orders.rb +92 -0
- data/examples/v201311/order_service/get_all_orders.rb +93 -0
- data/examples/v201311/order_service/get_order.rb +74 -0
- data/examples/v201311/order_service/get_orders_by_statement.rb +90 -0
- data/examples/v201311/order_service/update_orders.rb +97 -0
- data/examples/v201311/placement_service/create_placements.rb +131 -0
- data/examples/v201311/placement_service/deactivate_placements.rb +118 -0
- data/examples/v201311/placement_service/get_all_placements.rb +93 -0
- data/examples/v201311/placement_service/get_placement.rb +74 -0
- data/examples/v201311/placement_service/get_placements_by_statement.rb +86 -0
- data/examples/v201311/placement_service/update_placements.rb +97 -0
- data/examples/v201311/publisher_query_language_service/fetch_match_tables.rb +113 -0
- data/examples/v201311/publisher_query_language_service/get_all_line_items.rb +100 -0
- data/examples/v201311/publisher_query_language_service/get_geo_targets.rb +102 -0
- data/examples/v201311/publisher_query_language_service/get_line_items_named_like.rb +100 -0
- data/examples/v201311/report_service/display_report.rb +81 -0
- data/examples/v201311/report_service/download_report.rb +81 -0
- data/examples/v201311/report_service/run_delivery_report.rb +103 -0
- data/examples/v201311/report_service/run_inventory_report.rb +112 -0
- data/examples/v201311/report_service/run_merged_delivery_report.rb +94 -0
- data/examples/v201311/report_service/run_reach_report.rb +87 -0
- data/examples/v201311/report_service/run_report_with_custom_fields.rb +135 -0
- data/examples/v201311/report_service/run_sales_report.rb +92 -0
- data/examples/v201311/suggested_ad_unit_service/approve_all_suggested_ad_units.rb +109 -0
- data/examples/v201311/suggested_ad_unit_service/get_all_suggested_ad_units.rb +96 -0
- data/examples/v201311/suggested_ad_unit_service/get_suggested_ad_unit.rb +75 -0
- data/examples/v201311/suggested_ad_unit_service/get_suggested_ad_units_by_statement.rb +92 -0
- data/examples/v201311/team_service/create_teams.rb +83 -0
- data/examples/v201311/team_service/get_all_teams.rb +92 -0
- data/examples/v201311/team_service/get_team.rb +74 -0
- data/examples/v201311/team_service/get_teams_by_statement.rb +78 -0
- data/examples/v201311/team_service/update_teams.rb +97 -0
- data/examples/v201311/user_service/create_users.rb +89 -0
- data/examples/v201311/user_service/deactivate_users.rb +97 -0
- data/examples/v201311/user_service/get_all_roles.rb +73 -0
- data/examples/{v201211/common/oauth2_handling.rb → v201311/user_service/get_all_users.rb} +9 -44
- data/examples/v201311/user_service/get_current_user.rb +66 -0
- data/examples/v201311/user_service/get_user.rb +73 -0
- data/examples/v201311/user_service/get_users_by_statement.rb +79 -0
- data/examples/v201311/user_service/update_users.rb +89 -0
- data/examples/v201311/user_team_association_service/create_user_team_associations.rb +86 -0
- data/examples/v201311/user_team_association_service/delete_user_team_associations.rb +111 -0
- data/examples/v201311/user_team_association_service/get_all_user_team_associations.rb +94 -0
- data/examples/v201311/user_team_association_service/get_user_team_association.rb +76 -0
- data/examples/v201311/user_team_association_service/get_user_team_associations_by_statement.rb +94 -0
- data/examples/v201311/user_team_association_service/update_user_team_associations.rb +102 -0
- data/lib/dfp_api/api_config.rb +49 -4
- data/lib/dfp_api/v201311/activity_group_service.rb +54 -0
- data/lib/dfp_api/v201311/activity_group_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/activity_service.rb +54 -0
- data/lib/dfp_api/v201311/activity_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/ad_rule_service.rb +58 -0
- data/lib/dfp_api/v201311/ad_rule_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/audience_segment_service.rb +46 -0
- data/lib/dfp_api/v201311/audience_segment_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/base_rate_service.rb +58 -0
- data/lib/dfp_api/v201311/base_rate_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/company_service.rb +54 -0
- data/lib/dfp_api/v201311/company_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/contact_service.rb +54 -0
- data/lib/dfp_api/v201311/contact_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/content_bundle_service.rb +58 -0
- data/lib/dfp_api/v201311/content_bundle_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/content_metadata_key_hierarchy_service.rb +34 -0
- data/lib/dfp_api/v201311/content_metadata_key_hierarchy_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/content_service.rb +38 -0
- data/lib/dfp_api/v201311/content_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/creative_service.rb +54 -0
- data/lib/dfp_api/v201311/creative_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/creative_set_service.rb +46 -0
- data/lib/dfp_api/v201311/creative_set_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/creative_template_service.rb +38 -0
- data/lib/dfp_api/v201311/creative_template_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/creative_wrapper_service.rb +58 -0
- data/lib/dfp_api/v201311/creative_wrapper_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/custom_field_service.rb +78 -0
- data/lib/dfp_api/v201311/custom_field_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/custom_targeting_service.rb +62 -0
- data/lib/dfp_api/v201311/custom_targeting_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/exchange_rate_service.rb +50 -0
- data/lib/dfp_api/v201311/exchange_rate_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/forecast_service.rb +38 -0
- data/lib/dfp_api/v201311/forecast_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/inventory_service.rb +62 -0
- data/lib/dfp_api/v201311/inventory_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/label_service.rb +58 -0
- data/lib/dfp_api/v201311/label_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/line_item_creative_association_service.rb +62 -0
- data/lib/dfp_api/v201311/line_item_creative_association_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/line_item_service.rb +58 -0
- data/lib/dfp_api/v201311/line_item_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/line_item_template_service.rb +34 -0
- data/lib/dfp_api/v201311/line_item_template_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/network_service.rb +46 -0
- data/lib/dfp_api/v201311/network_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/order_service.rb +58 -0
- data/lib/dfp_api/v201311/order_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/placement_service.rb +58 -0
- data/lib/dfp_api/v201311/placement_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/product_service.rb +50 -0
- data/lib/dfp_api/v201311/product_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/product_template_service.rb +58 -0
- data/lib/dfp_api/v201311/product_template_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/proposal_line_item_service.rb +58 -0
- data/lib/dfp_api/v201311/proposal_line_item_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/proposal_service.rb +58 -0
- data/lib/dfp_api/v201311/proposal_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/publisher_query_language_service.rb +34 -0
- data/lib/dfp_api/v201311/publisher_query_language_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/rate_card_customization_service.rb +58 -0
- data/lib/dfp_api/v201311/rate_card_customization_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/rate_card_service.rb +58 -0
- data/lib/dfp_api/v201311/rate_card_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/reconciliation_order_report_service.rb +42 -0
- data/lib/dfp_api/v201311/reconciliation_order_report_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/reconciliation_report_row_service.rb +38 -0
- data/lib/dfp_api/v201311/reconciliation_report_row_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/reconciliation_report_service.rb +46 -0
- data/lib/dfp_api/v201311/reconciliation_report_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/report_service.rb +46 -0
- data/lib/dfp_api/v201311/report_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/suggested_ad_unit_service.rb +42 -0
- data/lib/dfp_api/v201311/suggested_ad_unit_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/team_service.rb +54 -0
- data/lib/dfp_api/v201311/team_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/user_service.rb +66 -0
- data/lib/dfp_api/v201311/user_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/user_team_association_service.rb +58 -0
- data/lib/dfp_api/v201311/user_team_association_service_registry.rb +46 -0
- data/lib/dfp_api/v201311/workflow_request_service.rb +38 -0
- data/lib/dfp_api/v201311/workflow_request_service_registry.rb +46 -0
- data/lib/dfp_api/version.rb +1 -1
- data/test/bugs/test_issue_00000016.rb +3 -3
- metadata +241 -10
- data/examples/v201302/common/oauth2_handling.rb +0 -128
- data/examples/v201306/common/oauth2_handling.rb +0 -128
- data/examples/v201308/common/oauth2_handling.rb +0 -128
@@ -0,0 +1,97 @@
|
|
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 updates teams by adding an ad unit to the first 5. To determine
|
22
|
+
# which teams exist, run get_all_teams.rb. To determine which ad units exist,
|
23
|
+
# run get_all_ad_units.rb.
|
24
|
+
#
|
25
|
+
# Tags: TeamService.getTeamsByStatement, TeamService.updateTeams
|
26
|
+
|
27
|
+
require 'dfp_api'
|
28
|
+
|
29
|
+
API_VERSION = :v201311
|
30
|
+
|
31
|
+
def update_teams()
|
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
|
+
# Set the ID of the ad unit to add to the teams.
|
40
|
+
ad_unit_id = 'INSERT_AD_UNIT_ID_HERE'.to_i
|
41
|
+
|
42
|
+
# Get the TeamService.
|
43
|
+
team_service = dfp.service(:TeamService, API_VERSION)
|
44
|
+
|
45
|
+
# Create a statement to select first 5 teams that aren't built-in.
|
46
|
+
statement = {:query => 'WHERE id > 0 LIMIT 5'}
|
47
|
+
|
48
|
+
# Get teams by statement.
|
49
|
+
page = team_service.get_teams_by_statement(statement)
|
50
|
+
|
51
|
+
if page[:results]
|
52
|
+
teams = page[:results]
|
53
|
+
|
54
|
+
# Create a local set of teams than need to be updated. We are updating by
|
55
|
+
# adding an ad unit to it.
|
56
|
+
updated_teams = teams.inject([]) do |updated_teams, team|
|
57
|
+
# Don't add ad unit if the team has all inventory already.
|
58
|
+
unless team[:has_all_inventory]
|
59
|
+
team[:ad_unit_ids] ||= []
|
60
|
+
team[:ad_unit_ids] << ad_unit_id
|
61
|
+
# Workaround for issue #94.
|
62
|
+
team[:description] = "" if team[:description].nil?
|
63
|
+
updated_teams << team
|
64
|
+
end
|
65
|
+
updated_teams
|
66
|
+
end
|
67
|
+
|
68
|
+
# Update the teams on the server.
|
69
|
+
return_teams = team_service.update_teams(updated_teams)
|
70
|
+
return_teams.each do |team|
|
71
|
+
puts "Team ID: %d was updated" % team[:id]
|
72
|
+
end
|
73
|
+
else
|
74
|
+
puts 'No teams found to update.'
|
75
|
+
end
|
76
|
+
end
|
77
|
+
|
78
|
+
if __FILE__ == $0
|
79
|
+
begin
|
80
|
+
update_teams()
|
81
|
+
|
82
|
+
# HTTP errors.
|
83
|
+
rescue AdsCommon::Errors::HttpError => e
|
84
|
+
puts "HTTP Error: %s" % e
|
85
|
+
|
86
|
+
# API errors.
|
87
|
+
rescue DfpApi::Errors::ApiException => e
|
88
|
+
puts "Message: %s" % e.message
|
89
|
+
puts 'Errors:'
|
90
|
+
e.errors.each_with_index do |error, index|
|
91
|
+
puts "\tError [%d]:" % (index + 1)
|
92
|
+
error.each do |field, value|
|
93
|
+
puts "\t\t%s: %s" % [field, value]
|
94
|
+
end
|
95
|
+
end
|
96
|
+
end
|
97
|
+
end
|
@@ -0,0 +1,89 @@
|
|
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 creates new users. To determine which users exist, run
|
22
|
+
# get_all_users.rb. To determine which roles exist, run get_all_roles.rb.
|
23
|
+
#
|
24
|
+
# Tags: UserService.createUsers
|
25
|
+
|
26
|
+
require 'dfp_api'
|
27
|
+
|
28
|
+
API_VERSION = :v201311
|
29
|
+
|
30
|
+
def create_users()
|
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 UserService.
|
39
|
+
user_service = dfp.service(:UserService, API_VERSION)
|
40
|
+
|
41
|
+
# Set the user's email addresses and names.
|
42
|
+
emails_and_names = [
|
43
|
+
{:name => 'INSERT_NAME_HERE',
|
44
|
+
:email => 'INSERT_EMAIL_ADDRESS_HERE'},
|
45
|
+
{:name => 'INSERT_NAME_HERE',
|
46
|
+
:email => 'INSERT_EMAIL_ADDRESS_HERE'}
|
47
|
+
]
|
48
|
+
|
49
|
+
# Set the role ID for new users.
|
50
|
+
role_id = 'INSERT_ROLE_ID_HERE'.to_i
|
51
|
+
|
52
|
+
# Create an array to store local user objects.
|
53
|
+
users = emails_and_names.map do |email_and_name|
|
54
|
+
email_and_name.merge({:role_id => role_id, :preferred_locale => 'en_US'})
|
55
|
+
end
|
56
|
+
|
57
|
+
# Create the users on the server.
|
58
|
+
return_users = user_service.create_users(users)
|
59
|
+
|
60
|
+
if return_users
|
61
|
+
return_users.each do |user|
|
62
|
+
puts "User with ID: %d, name: %s and email: %s was created." %
|
63
|
+
[user[:id], user[:name], user[:email]]
|
64
|
+
end
|
65
|
+
else
|
66
|
+
raise 'No users were created.'
|
67
|
+
end
|
68
|
+
end
|
69
|
+
|
70
|
+
if __FILE__ == $0
|
71
|
+
begin
|
72
|
+
create_users()
|
73
|
+
|
74
|
+
# HTTP errors.
|
75
|
+
rescue AdsCommon::Errors::HttpError => e
|
76
|
+
puts "HTTP Error: %s" % e
|
77
|
+
|
78
|
+
# API errors.
|
79
|
+
rescue DfpApi::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
|
@@ -0,0 +1,97 @@
|
|
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 deactivates a user. Deactivated users can no longer make requests
|
22
|
+
# to the API. The user making the request cannot deactivate itself. To determine
|
23
|
+
# which users exist, run get_all_users.rb.
|
24
|
+
#
|
25
|
+
# Tags: UserService.getUsersByStatement, UserService.performUserAction
|
26
|
+
|
27
|
+
require 'dfp_api'
|
28
|
+
|
29
|
+
API_VERSION = :v201311
|
30
|
+
|
31
|
+
def deactivate_users()
|
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 UserService.
|
40
|
+
user_service = dfp.service(:UserService, API_VERSION)
|
41
|
+
|
42
|
+
# Set the ID of the user to deactivate
|
43
|
+
user_id = 'INSERT_USER_ID_HERE'
|
44
|
+
|
45
|
+
# Create filter text to select user by id.
|
46
|
+
statement = {
|
47
|
+
:query => 'WHERE id = :user_id',
|
48
|
+
:values => [
|
49
|
+
{:key => 'user_id',
|
50
|
+
:value => {:value => user_id, :xsi_type => 'NumberValue'}}
|
51
|
+
]
|
52
|
+
}
|
53
|
+
|
54
|
+
# Get users by statement.
|
55
|
+
page = user_service.get_users_by_statement(statement)
|
56
|
+
|
57
|
+
if page[:results]
|
58
|
+
page[:results].each do |user|
|
59
|
+
puts "User ID: %d, name: %s and status: %s will be deactivated." %
|
60
|
+
[user[:id], user[:name], user[:status]]
|
61
|
+
end
|
62
|
+
|
63
|
+
# Perform action.
|
64
|
+
result = user_service.perform_user_action(
|
65
|
+
{:xsi_type => 'DeactivateUsers'}, statement)
|
66
|
+
|
67
|
+
# Display results.
|
68
|
+
if result and result[:num_changes] > 0
|
69
|
+
puts "Number of users deactivated: %d" % result[:num_changes]
|
70
|
+
else
|
71
|
+
puts 'No users were deactivated.'
|
72
|
+
end
|
73
|
+
else
|
74
|
+
puts 'No user found to deactivate.'
|
75
|
+
end
|
76
|
+
end
|
77
|
+
|
78
|
+
if __FILE__ == $0
|
79
|
+
begin
|
80
|
+
deactivate_users()
|
81
|
+
|
82
|
+
# HTTP errors.
|
83
|
+
rescue AdsCommon::Errors::HttpError => e
|
84
|
+
puts "HTTP Error: %s" % e
|
85
|
+
|
86
|
+
# API errors.
|
87
|
+
rescue DfpApi::Errors::ApiException => e
|
88
|
+
puts "Message: %s" % e.message
|
89
|
+
puts 'Errors:'
|
90
|
+
e.errors.each_with_index do |error, index|
|
91
|
+
puts "\tError [%d]:" % (index + 1)
|
92
|
+
error.each do |field, value|
|
93
|
+
puts "\t\t%s: %s" % [field, value]
|
94
|
+
end
|
95
|
+
end
|
96
|
+
end
|
97
|
+
end
|
@@ -0,0 +1,73 @@
|
|
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 gets all roles. This example can be used to determine which role
|
22
|
+
# ID is needed when getting and creating users.
|
23
|
+
#
|
24
|
+
# Tags: UserService.getAllRoles
|
25
|
+
|
26
|
+
require 'dfp_api'
|
27
|
+
|
28
|
+
API_VERSION = :v201311
|
29
|
+
|
30
|
+
def get_all_roles()
|
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 UserService.
|
39
|
+
user_service = dfp.service(:UserService, API_VERSION)
|
40
|
+
|
41
|
+
# Get all roles.
|
42
|
+
roles = user_service.get_all_roles()
|
43
|
+
|
44
|
+
if roles
|
45
|
+
# Print details about each role in results page.
|
46
|
+
roles.each_with_index do |role, index|
|
47
|
+
puts "%d) Role ID: %d, name: %s" % [index, role[:id], role[:name]]
|
48
|
+
end
|
49
|
+
# Print a footer
|
50
|
+
puts "Total number of roles: %d" % roles.size
|
51
|
+
end
|
52
|
+
end
|
53
|
+
|
54
|
+
if __FILE__ == $0
|
55
|
+
begin
|
56
|
+
get_all_roles()
|
57
|
+
|
58
|
+
# HTTP errors.
|
59
|
+
rescue AdsCommon::Errors::HttpError => e
|
60
|
+
puts "HTTP Error: %s" % e
|
61
|
+
|
62
|
+
# API errors.
|
63
|
+
rescue DfpApi::Errors::ApiException => e
|
64
|
+
puts "Message: %s" % e.message
|
65
|
+
puts 'Errors:'
|
66
|
+
e.errors.each_with_index do |error, index|
|
67
|
+
puts "\tError [%d]:" % (index + 1)
|
68
|
+
error.each do |field, value|
|
69
|
+
puts "\t\t%s: %s" % [field, value]
|
70
|
+
end
|
71
|
+
end
|
72
|
+
end
|
73
|
+
end
|
@@ -3,7 +3,7 @@
|
|
3
3
|
#
|
4
4
|
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
5
5
|
#
|
6
|
-
# Copyright:: Copyright
|
6
|
+
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
7
7
|
#
|
8
8
|
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
9
9
|
# you may not use this file except in compliance with the License.
|
@@ -18,18 +18,17 @@
|
|
18
18
|
# See the License for the specific language governing permissions and
|
19
19
|
# limitations under the License.
|
20
20
|
#
|
21
|
-
# This example
|
22
|
-
#
|
21
|
+
# This example gets all users for an account. To create users run
|
22
|
+
# create_users.rb.
|
23
23
|
#
|
24
24
|
# Tags: UserService.getUsersByStatement
|
25
25
|
|
26
26
|
require 'dfp_api'
|
27
27
|
|
28
|
-
API_VERSION = :
|
28
|
+
API_VERSION = :v201311
|
29
29
|
PAGE_SIZE = 500
|
30
|
-
MAX_RETRIES = 3
|
31
30
|
|
32
|
-
def
|
31
|
+
def get_all_users()
|
33
32
|
# Get DfpApi instance and load configuration from ~/dfp_api.yml.
|
34
33
|
dfp = DfpApi::Api.new
|
35
34
|
|
@@ -37,45 +36,19 @@ def oauth2_handling()
|
|
37
36
|
# the configuration file or provide your own logger:
|
38
37
|
# dfp.logger = Logger.new('dfp_xml.log')
|
39
38
|
|
40
|
-
# Forcing authorization. A callback URL and other parameters could be
|
41
|
-
# specified as parameter for OAuth method.
|
42
|
-
token = dfp.authorize({:oauth_callback => 'oob'}) do |oauth_url|
|
43
|
-
# For command-line we ask user to go to URL and type in code.
|
44
|
-
verification_code = get_verification_code(oauth_url)
|
45
|
-
# Return verification code from the block.
|
46
|
-
(verification_code.empty?) ? nil : verification_code
|
47
|
-
end
|
48
|
-
|
49
39
|
# Get the UserService.
|
50
40
|
user_service = dfp.service(:UserService, API_VERSION)
|
51
41
|
|
52
42
|
# Define initial values.
|
53
43
|
offset = 0
|
54
|
-
page =
|
55
|
-
retry_count = 0
|
44
|
+
page = {}
|
56
45
|
|
57
46
|
begin
|
58
47
|
# Create statement for one page with current offset.
|
59
48
|
statement = {:query => "LIMIT %d OFFSET %d" % [PAGE_SIZE, offset]}
|
60
49
|
|
61
|
-
|
62
|
-
|
63
|
-
page = user_service.get_users_by_statement(statement)
|
64
|
-
|
65
|
-
# The second way to do OAuth authentication is to make a request and catch
|
66
|
-
# the OAuthVerificationRequired exception. Add the verification code to the
|
67
|
-
# credentials once acquired.
|
68
|
-
rescue AdsCommon::Errors::OAuth2VerificationRequired => e
|
69
|
-
if retry_count < MAX_RETRIES
|
70
|
-
verification_code = get_verification_code(e.oauth_url)
|
71
|
-
dfp.credential_handler.set_credential(
|
72
|
-
:oauth2_verification_code, verification_code)
|
73
|
-
retry_count += 1
|
74
|
-
retry
|
75
|
-
else
|
76
|
-
raise AdsCommon::Errors::AuthError, 'Failed to authenticate.'
|
77
|
-
end
|
78
|
-
end
|
50
|
+
# Get users by statement.
|
51
|
+
page = user_service.get_users_by_statement(statement)
|
79
52
|
|
80
53
|
if page[:results]
|
81
54
|
# Increase query offset by page size.
|
@@ -98,17 +71,9 @@ def oauth2_handling()
|
|
98
71
|
end
|
99
72
|
end
|
100
73
|
|
101
|
-
# Misc util to get the verification code from the console.
|
102
|
-
def get_verification_code(url)
|
103
|
-
puts "Hit Auth error, please navigate to URL:\n\t%s" % url
|
104
|
-
print 'Log in and type the verification code: '
|
105
|
-
verification_code = gets.chomp
|
106
|
-
return verification_code
|
107
|
-
end
|
108
|
-
|
109
74
|
if __FILE__ == $0
|
110
75
|
begin
|
111
|
-
|
76
|
+
get_all_users()
|
112
77
|
|
113
78
|
# HTTP errors.
|
114
79
|
rescue AdsCommon::Errors::HttpError => e
|