google-adwords-api 0.4.5 → 0.5.0
Sign up to get free protection for your applications and to get access to all the features.
- data/ChangeLog +4 -0
- data/README +3 -3
- data/Rakefile +3 -3
- data/examples/v201109/{create_account.rb → account_management/create_account.rb} +2 -1
- data/examples/v201109/{get_campaign_alerts.rb → account_management/get_account_alerts.rb} +38 -21
- data/examples/v201109/{get_all_account_changes.rb → account_management/get_account_changes.rb} +40 -39
- data/examples/v201109/{get_account_hierarchy.rb → account_management/get_account_hierarchy.rb} +2 -1
- data/examples/v201109/{get_client_customer_id.rb → account_management/get_client_customer_id.rb} +2 -1
- data/examples/v201109/{get_unit_count.rb → account_management/get_client_unit_usage.rb} +15 -7
- data/examples/v201109/{add_ad_group.rb → basic_operations/add_ad_group.rb} +2 -1
- data/examples/v201109/{add_campaign.rb → basic_operations/add_campaign.rb} +2 -1
- data/examples/v201109/{add_ad_group_criteria.rb → basic_operations/add_keywords.rb} +32 -37
- data/examples/{v200909/update_ad.rb → v201109/basic_operations/add_text_ads.rb} +41 -25
- data/examples/v201109/{delete_ad.rb → basic_operations/delete_ad.rb} +5 -4
- data/examples/v201109/{delete_ad_group.rb → basic_operations/delete_ad_group.rb} +34 -8
- data/examples/v201109/{delete_campaign.rb → basic_operations/delete_campaign.rb} +32 -6
- data/examples/v201109/{delete_ad_group_criterion.rb → basic_operations/delete_keyword.rb} +15 -10
- data/examples/v201109/{get_all_ad_groups.rb → basic_operations/get_ad_groups.rb} +32 -18
- data/examples/v201109/{get_all_campaigns.rb → basic_operations/get_campaigns.rb} +31 -14
- data/examples/v201109/{get_all_active_ad_group_criteria.rb → basic_operations/get_keywords.rb} +41 -34
- data/examples/v201109/{get_all_ads.rb → basic_operations/get_text_ads.rb} +39 -22
- data/examples/v201109/{update_ad.rb → basic_operations/pause_ad.rb} +9 -10
- data/examples/v201109/{update_ad_group.rb → basic_operations/update_ad_group.rb} +2 -1
- data/examples/v201109/{update_campaign.rb → basic_operations/update_campaign.rb} +2 -1
- data/examples/v201109/{update_ad_group_criterion.rb → basic_operations/update_keyword.rb} +10 -9
- data/examples/v201109/{add_experiment.rb → campaign_management/add_experiment.rb} +4 -3
- data/examples/v201109/{perform_mutate_job.rb → campaign_management/add_keywords_in_bulk.rb} +17 -43
- data/examples/v201109/{add_campaign_ad_extension.rb → campaign_management/add_location_extension.rb} +28 -37
- data/examples/v201109/{add_ad_extension_override.rb → campaign_management/add_location_extension_override.rb} +12 -10
- data/examples/v201109/{get_all_disapproved_ads.rb → campaign_management/get_all_disapproved_ads.rb} +3 -2
- data/examples/v201109/{promote_experiment.rb → campaign_management/promote_experiment.rb} +4 -4
- data/examples/v201109/{set_ad_params.rb → campaign_management/set_ad_parameters.rb} +7 -7
- data/examples/{v201003/delete_ad.rb → v201109/campaign_management/validate_text_ad.rb} +40 -16
- data/examples/v201109/{handle_partial_failures.rb → error_handling/handle_partial_failures.rb} +2 -1
- data/examples/v201109/{handle_policy_violation_error.rb → error_handling/handle_policy_violation_error.rb} +2 -1
- data/examples/v201109/{handle_second_factor.rb → error_handling/handle_two_factor_authorization_error.rb} +5 -4
- data/examples/v201109/{get_all_images.rb → misc/get_all_images_and_videos.rb} +40 -20
- data/examples/v201109/{upload_image.rb → misc/upload_image.rb} +2 -1
- data/examples/v201109/{oauth_handling.rb → misc/use_oauth.rb} +10 -7
- data/examples/v201109/{get_traffic_estimates.rb → optimization/estimate_keyword_traffic.rb} +4 -3
- data/examples/v201109/{get_criterion_bid_landscape.rb → optimization/get_keyword_bid_simulations.rb} +21 -20
- data/examples/v201109/{get_related_keywords.rb → optimization/get_keyword_ideas.rb} +6 -5
- data/examples/v201109/{get_keyword_opportunities.rb → optimization/get_keyword_opportunities.rb} +2 -1
- data/examples/v201109/{get_related_placements.rb → optimization/get_placement_ideas.rb} +5 -4
- data/examples/v201109/{add_user_list.rb → remarketing/add_audience.rb} +6 -5
- data/examples/v201109/{add_conversion.rb → remarketing/add_conversion_tracker.rb} +8 -7
- data/examples/v201109/{download_adhoc_report.rb → reporting/download_criteria_report.rb} +19 -17
- data/examples/v201109/{download_report.rb → reporting/download_defined_report.rb} +7 -5
- data/examples/v201109/{get_all_report_definitions.rb → reporting/get_defined_reports.rb} +7 -6
- data/examples/v201109/{get_report_fields.rb → reporting/get_report_fields.rb} +2 -1
- data/examples/v201109/{parallel_report_download.rb → reporting/parallel_report_download.rb} +2 -1
- data/examples/v201109/{add_campaign_targeting_criteria.rb → targeting/add_campaign_targeting_criteria.rb} +22 -4
- data/examples/v201109/{add_negative_campaign_criterion.rb → targeting/get_campaign_targeting_criteria.rb} +43 -26
- data/examples/v201109/{get_all_carriers.rb → targeting/get_targetable_languages_and_carriers.rb} +19 -4
- data/examples/v201109/{get_location_criteria.rb → targeting/lookup_location.rb} +4 -3
- data/lib/adwords_api.rb +2 -2
- data/lib/adwords_api/api_config.rb +3 -130
- data/lib/adwords_api/client_login_header_handler.rb +1 -1
- data/lib/adwords_api/credential_handler.rb +2 -2
- data/lib/adwords_api/errors.rb +2 -2
- data/lib/adwords_api/extensions.rb +3 -2
- data/lib/adwords_api/report_utils.rb +1 -1
- data/lib/adwords_api/utils.rb +2 -2
- data/lib/adwords_api/v13_login_handler.rb +1 -1
- data/lib/adwords_api/v201109/ad_extension_override_service.rb +10 -8
- data/lib/adwords_api/v201109/ad_extension_override_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/ad_group_ad_service.rb +10 -8
- data/lib/adwords_api/v201109/ad_group_ad_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/ad_group_criterion_service.rb +10 -8
- data/lib/adwords_api/v201109/ad_group_criterion_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/ad_group_service.rb +10 -8
- data/lib/adwords_api/v201109/ad_group_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/ad_param_service.rb +10 -8
- data/lib/adwords_api/v201109/ad_param_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/alert_service.rb +6 -4
- data/lib/adwords_api/v201109/alert_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/bulk_mutate_job_service.rb +10 -8
- data/lib/adwords_api/v201109/bulk_mutate_job_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/bulk_opportunity_service.rb +6 -4
- data/lib/adwords_api/v201109/bulk_opportunity_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/campaign_ad_extension_service.rb +10 -8
- data/lib/adwords_api/v201109/campaign_ad_extension_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/campaign_criterion_service.rb +10 -8
- data/lib/adwords_api/v201109/campaign_criterion_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/campaign_service.rb +10 -8
- data/lib/adwords_api/v201109/campaign_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/campaign_target_service.rb +10 -8
- data/lib/adwords_api/v201109/campaign_target_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/constant_data_service.rb +6 -4
- data/lib/adwords_api/v201109/constant_data_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/conversion_tracker_service.rb +10 -8
- data/lib/adwords_api/v201109/conversion_tracker_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/create_account_service.rb +6 -4
- data/lib/adwords_api/v201109/create_account_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/customer_sync_service.rb +6 -4
- data/lib/adwords_api/v201109/customer_sync_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/data_service.rb +10 -8
- data/lib/adwords_api/v201109/data_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/experiment_service.rb +10 -8
- data/lib/adwords_api/v201109/experiment_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/geo_location_service.rb +6 -4
- data/lib/adwords_api/v201109/geo_location_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/info_service.rb +6 -4
- data/lib/adwords_api/v201109/info_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/location_criterion_service.rb +6 -4
- data/lib/adwords_api/v201109/location_criterion_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/media_service.rb +10 -8
- data/lib/adwords_api/v201109/media_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/mutate_job_service.rb +10 -8
- data/lib/adwords_api/v201109/mutate_job_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/report_definition_service.rb +10 -8
- data/lib/adwords_api/v201109/report_definition_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/serviced_account_service.rb +6 -4
- data/lib/adwords_api/v201109/serviced_account_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/targeting_idea_service.rb +10 -8
- data/lib/adwords_api/v201109/targeting_idea_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/traffic_estimator_service.rb +6 -4
- data/lib/adwords_api/v201109/traffic_estimator_service_registry.rb +8 -6
- data/lib/adwords_api/v201109/user_list_service.rb +10 -8
- data/lib/adwords_api/v201109/user_list_service_registry.rb +8 -6
- data/test/adwords_api/test_api_config.rb +2 -7
- data/test/adwords_api/test_report_utils.rb +2 -1
- data/test/adwords_api/test_utils.rb +1 -0
- data/test/bugs/test_issue_00000031.rb +2 -1
- metadata +116 -481
- data/examples/v200909/add_ad_extension_override.rb +0 -82
- data/examples/v200909/add_ad_group.rb +0 -89
- data/examples/v200909/add_ad_group_criteria.rb +0 -108
- data/examples/v200909/add_ads.rb +0 -121
- data/examples/v200909/add_campaign.rb +0 -92
- data/examples/v200909/add_campaign_ad_extension.rb +0 -121
- data/examples/v200909/add_negative_campaign_criterion.rb +0 -87
- data/examples/v200909/check_campaigns.rb +0 -123
- data/examples/v200909/delete_ad.rb +0 -85
- data/examples/v200909/delete_ad_group.rb +0 -77
- data/examples/v200909/delete_ad_group_criterion.rb +0 -86
- data/examples/v200909/delete_campaign.rb +0 -78
- data/examples/v200909/get_all_active_ad_group_criteria.rb +0 -84
- data/examples/v200909/get_all_ad_extension_overrides.rb +0 -82
- data/examples/v200909/get_all_ad_group_criteria.rb +0 -82
- data/examples/v200909/get_all_ad_groups.rb +0 -79
- data/examples/v200909/get_all_ad_params.rb +0 -80
- data/examples/v200909/get_all_ads.rb +0 -79
- data/examples/v200909/get_all_campaign_ad_extensions.rb +0 -81
- data/examples/v200909/get_all_campaign_targets.rb +0 -74
- data/examples/v200909/get_all_campaigns.rb +0 -74
- data/examples/v200909/get_all_disapproved_ads.rb +0 -85
- data/examples/v200909/get_all_paused_campaigns.rb +0 -77
- data/examples/v200909/get_conversion_optimizer_eligibility.rb +0 -103
- data/examples/v200909/get_geo_location_info.rb +0 -99
- data/examples/v200909/get_method_cost.rb +0 -87
- data/examples/v200909/get_operation_count.rb +0 -79
- data/examples/v200909/get_related_keywords.rb +0 -108
- data/examples/v200909/get_related_placements.rb +0 -107
- data/examples/v200909/get_total_usage_units_per_month.rb +0 -74
- data/examples/v200909/get_unit_count.rb +0 -79
- data/examples/v200909/perform_bulk_mutate_job.rb +0 -212
- data/examples/v200909/set_ad_params.rb +0 -115
- data/examples/v200909/set_campaign_targets.rb +0 -116
- data/examples/v200909/update_ad_group.rb +0 -81
- data/examples/v200909/update_ad_group_criterion.rb +0 -99
- data/examples/v200909/update_campaign.rb +0 -84
- data/examples/v201003/add_ad_extension_override.rb +0 -82
- data/examples/v201003/add_ad_group.rb +0 -89
- data/examples/v201003/add_ad_group_criteria.rb +0 -108
- data/examples/v201003/add_ads.rb +0 -174
- data/examples/v201003/add_campaign.rb +0 -92
- data/examples/v201003/add_campaign_ad_extension.rb +0 -121
- data/examples/v201003/add_keywords_performance_report_definition.rb +0 -99
- data/examples/v201003/add_negative_campaign_criterion.rb +0 -87
- data/examples/v201003/check_campaigns.rb +0 -123
- data/examples/v201003/delete_ad_group.rb +0 -77
- data/examples/v201003/delete_ad_group_criterion.rb +0 -86
- data/examples/v201003/delete_campaign.rb +0 -78
- data/examples/v201003/download_report.rb +0 -67
- data/examples/v201003/get_all_active_ad_group_criteria.rb +0 -84
- data/examples/v201003/get_all_ad_extension_overrides.rb +0 -82
- data/examples/v201003/get_all_ad_group_criteria.rb +0 -82
- data/examples/v201003/get_all_ad_groups.rb +0 -79
- data/examples/v201003/get_all_ad_params.rb +0 -80
- data/examples/v201003/get_all_ads.rb +0 -82
- data/examples/v201003/get_all_campaign_ad_extensions.rb +0 -81
- data/examples/v201003/get_all_campaign_targets.rb +0 -74
- data/examples/v201003/get_all_campaigns.rb +0 -74
- data/examples/v201003/get_all_disapproved_ads.rb +0 -85
- data/examples/v201003/get_all_images.rb +0 -80
- data/examples/v201003/get_all_paused_campaigns.rb +0 -77
- data/examples/v201003/get_all_report_definitions.rb +0 -75
- data/examples/v201003/get_all_videos.rb +0 -76
- data/examples/v201003/get_conversion_optimizer_eligibility.rb +0 -103
- data/examples/v201003/get_criterion_bid_landscape.rb +0 -96
- data/examples/v201003/get_geo_location_info.rb +0 -99
- data/examples/v201003/get_method_cost.rb +0 -87
- data/examples/v201003/get_operation_count.rb +0 -79
- data/examples/v201003/get_related_keywords.rb +0 -108
- data/examples/v201003/get_related_placements.rb +0 -107
- data/examples/v201003/get_report_fields.rb +0 -72
- data/examples/v201003/get_total_usage_units_per_month.rb +0 -74
- data/examples/v201003/get_unit_count.rb +0 -79
- data/examples/v201003/perform_bulk_mutate_job.rb +0 -212
- data/examples/v201003/set_ad_params.rb +0 -115
- data/examples/v201003/set_campaign_targets.rb +0 -116
- data/examples/v201003/update_ad.rb +0 -86
- data/examples/v201003/update_ad_group.rb +0 -81
- data/examples/v201003/update_ad_group_criterion.rb +0 -99
- data/examples/v201003/update_campaign.rb +0 -83
- data/examples/v201003/upload_image.rb +0 -90
- data/examples/v201008/add_ad_extension_override.rb +0 -82
- data/examples/v201008/add_ad_group.rb +0 -89
- data/examples/v201008/add_ad_group_criteria.rb +0 -108
- data/examples/v201008/add_ads.rb +0 -174
- data/examples/v201008/add_campaign.rb +0 -92
- data/examples/v201008/add_campaign_ad_extension.rb +0 -121
- data/examples/v201008/add_experiment.rb +0 -153
- data/examples/v201008/add_keywords_performance_report_definition.rb +0 -99
- data/examples/v201008/add_negative_campaign_criterion.rb +0 -87
- data/examples/v201008/add_user_list.rb +0 -87
- data/examples/v201008/check_campaigns.rb +0 -123
- data/examples/v201008/delete_ad.rb +0 -85
- data/examples/v201008/delete_ad_group.rb +0 -77
- data/examples/v201008/delete_ad_group_criterion.rb +0 -86
- data/examples/v201008/delete_bulk_mutate_job.rb +0 -87
- data/examples/v201008/delete_campaign.rb +0 -78
- data/examples/v201008/delete_experiment.rb +0 -78
- data/examples/v201008/delete_user_list.rb +0 -78
- data/examples/v201008/download_report.rb +0 -67
- data/examples/v201008/get_account_hierarchy.rb +0 -101
- data/examples/v201008/get_all_account_changes.rb +0 -135
- data/examples/v201008/get_all_active_ad_group_criteria.rb +0 -84
- data/examples/v201008/get_all_ad_extension_overrides.rb +0 -82
- data/examples/v201008/get_all_ad_group_criteria.rb +0 -82
- data/examples/v201008/get_all_ad_groups.rb +0 -79
- data/examples/v201008/get_all_ad_params.rb +0 -80
- data/examples/v201008/get_all_ads.rb +0 -82
- data/examples/v201008/get_all_campaign_ad_extensions.rb +0 -81
- data/examples/v201008/get_all_campaign_targets.rb +0 -74
- data/examples/v201008/get_all_campaigns.rb +0 -74
- data/examples/v201008/get_all_disapproved_ads.rb +0 -85
- data/examples/v201008/get_all_experiments.rb +0 -84
- data/examples/v201008/get_all_images.rb +0 -80
- data/examples/v201008/get_all_paused_campaigns.rb +0 -77
- data/examples/v201008/get_all_report_definitions.rb +0 -75
- data/examples/v201008/get_all_user_lists.rb +0 -75
- data/examples/v201008/get_all_videos.rb +0 -76
- data/examples/v201008/get_bulk_mutate_job.rb +0 -97
- data/examples/v201008/get_campaign_alerts.rb +0 -95
- data/examples/v201008/get_conversion_optimizer_eligibility.rb +0 -88
- data/examples/v201008/get_criterion_bid_landscape.rb +0 -96
- data/examples/v201008/get_geo_location_info.rb +0 -99
- data/examples/v201008/get_method_cost.rb +0 -87
- data/examples/v201008/get_operation_count.rb +0 -79
- data/examples/v201008/get_related_keywords.rb +0 -108
- data/examples/v201008/get_related_placements.rb +0 -107
- data/examples/v201008/get_report_fields.rb +0 -72
- data/examples/v201008/get_total_usage_units_per_month.rb +0 -74
- data/examples/v201008/get_traffic_estimates.rb +0 -147
- data/examples/v201008/get_unit_count.rb +0 -79
- data/examples/v201008/handle_partial_failures.rb +0 -127
- data/examples/v201008/handle_policy_violation_error.rb +0 -138
- data/examples/v201008/perform_bulk_mutate_job.rb +0 -212
- data/examples/v201008/promote_experiment.rb +0 -79
- data/examples/v201008/set_ad_params.rb +0 -115
- data/examples/v201008/set_campaign_targets.rb +0 -116
- data/examples/v201008/update_ad.rb +0 -86
- data/examples/v201008/update_ad_group.rb +0 -81
- data/examples/v201008/update_ad_group_criterion.rb +0 -99
- data/examples/v201008/update_campaign.rb +0 -84
- data/examples/v201008/update_user_list.rb +0 -82
- data/examples/v201008/upload_image.rb +0 -90
- data/examples/v201101/add_ad_extension_override.rb +0 -82
- data/examples/v201101/add_ad_group.rb +0 -89
- data/examples/v201101/add_ad_group_criteria.rb +0 -108
- data/examples/v201101/add_ads.rb +0 -174
- data/examples/v201101/add_campaign.rb +0 -99
- data/examples/v201101/add_campaign_ad_extension.rb +0 -121
- data/examples/v201101/add_conversion.rb +0 -88
- data/examples/v201101/add_experiment.rb +0 -153
- data/examples/v201101/add_keywords_performance_report_definition.rb +0 -99
- data/examples/v201101/add_negative_campaign_criterion.rb +0 -87
- data/examples/v201101/add_user_list.rb +0 -113
- data/examples/v201101/check_campaigns.rb +0 -123
- data/examples/v201101/delete_ad.rb +0 -85
- data/examples/v201101/delete_ad_group.rb +0 -77
- data/examples/v201101/delete_ad_group_criterion.rb +0 -86
- data/examples/v201101/delete_bulk_mutate_job.rb +0 -87
- data/examples/v201101/delete_campaign.rb +0 -78
- data/examples/v201101/delete_experiment.rb +0 -78
- data/examples/v201101/delete_user_list.rb +0 -78
- data/examples/v201101/download_report.rb +0 -67
- data/examples/v201101/get_account_hierarchy.rb +0 -102
- data/examples/v201101/get_ad_group_bid_landscape.rb +0 -94
- data/examples/v201101/get_all_account_changes.rb +0 -137
- data/examples/v201101/get_all_active_ad_group_criteria.rb +0 -97
- data/examples/v201101/get_all_ad_extension_overrides.rb +0 -82
- data/examples/v201101/get_all_ad_group_criteria.rb +0 -88
- data/examples/v201101/get_all_ad_groups.rb +0 -85
- data/examples/v201101/get_all_ad_params.rb +0 -80
- data/examples/v201101/get_all_ads.rb +0 -90
- data/examples/v201101/get_all_campaign_ad_extensions.rb +0 -87
- data/examples/v201101/get_all_campaign_targets.rb +0 -74
- data/examples/v201101/get_all_campaigns.rb +0 -77
- data/examples/v201101/get_all_conversions.rb +0 -79
- data/examples/v201101/get_all_disapproved_ads.rb +0 -93
- data/examples/v201101/get_all_experiments.rb +0 -89
- data/examples/v201101/get_all_images.rb +0 -82
- data/examples/v201101/get_all_paused_campaigns.rb +0 -83
- data/examples/v201101/get_all_report_definitions.rb +0 -75
- data/examples/v201101/get_all_user_lists.rb +0 -78
- data/examples/v201101/get_all_videos.rb +0 -78
- data/examples/v201101/get_bulk_mutate_job.rb +0 -97
- data/examples/v201101/get_campaign_alerts.rb +0 -95
- data/examples/v201101/get_conversion_optimizer_eligibility.rb +0 -93
- data/examples/v201101/get_criterion_bid_landscape.rb +0 -93
- data/examples/v201101/get_geo_location_info.rb +0 -99
- data/examples/v201101/get_keyword_opportunities.rb +0 -95
- data/examples/v201101/get_method_cost.rb +0 -87
- data/examples/v201101/get_operation_count.rb +0 -79
- data/examples/v201101/get_related_keywords.rb +0 -108
- data/examples/v201101/get_related_placements.rb +0 -107
- data/examples/v201101/get_report_fields.rb +0 -72
- data/examples/v201101/get_total_usage_units_per_month.rb +0 -74
- data/examples/v201101/get_traffic_estimates.rb +0 -148
- data/examples/v201101/get_unit_count.rb +0 -79
- data/examples/v201101/handle_partial_failures.rb +0 -127
- data/examples/v201101/handle_policy_violation_error.rb +0 -138
- data/examples/v201101/handle_second_factor.rb +0 -87
- data/examples/v201101/oauth_handling.rb +0 -95
- data/examples/v201101/perform_bulk_mutate_job.rb +0 -212
- data/examples/v201101/promote_experiment.rb +0 -79
- data/examples/v201101/set_ad_params.rb +0 -115
- data/examples/v201101/set_campaign_targets.rb +0 -102
- data/examples/v201101/update_ad.rb +0 -86
- data/examples/v201101/update_ad_group.rb +0 -81
- data/examples/v201101/update_ad_group_criterion.rb +0 -99
- data/examples/v201101/update_campaign.rb +0 -84
- data/examples/v201101/update_conversion.rb +0 -87
- data/examples/v201101/update_user_list.rb +0 -82
- data/examples/v201101/upload_image.rb +0 -90
- data/examples/v201109/add_ads.rb +0 -174
- data/examples/v201109/check_campaigns.rb +0 -123
- data/examples/v201109/delete_bulk_mutate_job.rb +0 -87
- data/examples/v201109/delete_experiment.rb +0 -78
- data/examples/v201109/delete_user_list.rb +0 -78
- data/examples/v201109/get_ad_group_bid_landscape.rb +0 -94
- data/examples/v201109/get_all_ad_extension_overrides.rb +0 -82
- data/examples/v201109/get_all_ad_group_criteria.rb +0 -90
- data/examples/v201109/get_all_ad_params.rb +0 -86
- data/examples/v201109/get_all_campaign_ad_extensions.rb +0 -87
- data/examples/v201109/get_all_campaign_targets.rb +0 -74
- data/examples/v201109/get_all_conversions.rb +0 -79
- data/examples/v201109/get_all_experiments.rb +0 -89
- data/examples/v201109/get_all_languages.rb +0 -73
- data/examples/v201109/get_all_paused_campaigns.rb +0 -83
- data/examples/v201109/get_all_user_lists.rb +0 -78
- data/examples/v201109/get_all_videos.rb +0 -78
- data/examples/v201109/get_bulk_mutate_job.rb +0 -97
- data/examples/v201109/get_conversion_optimizer_eligibility.rb +0 -93
- data/examples/v201109/get_geo_location_info.rb +0 -99
- data/examples/v201109/get_method_cost.rb +0 -87
- data/examples/v201109/get_operation_count.rb +0 -79
- data/examples/v201109/get_total_usage_units_per_month.rb +0 -74
- data/examples/v201109/oauth_report_download.rb +0 -97
- data/examples/v201109/perform_bulk_mutate_job.rb +0 -212
- data/examples/v201109/update_conversion.rb +0 -87
- data/examples/v201109/update_user_list.rb +0 -82
- data/lib/adwords_api/v13/account_service.rb +0 -48
- data/lib/adwords_api/v13/account_service_registry.rb +0 -41
- data/lib/adwords_api/v13/report_service.rb +0 -65
- data/lib/adwords_api/v13/report_service_registry.rb +0 -41
- data/lib/adwords_api/v200909/ad_extension_override_service.rb +0 -36
- data/lib/adwords_api/v200909/ad_extension_override_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/ad_group_ad_service.rb +0 -36
- data/lib/adwords_api/v200909/ad_group_ad_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/ad_group_criterion_service.rb +0 -36
- data/lib/adwords_api/v200909/ad_group_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/ad_group_service.rb +0 -36
- data/lib/adwords_api/v200909/ad_group_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/ad_param_service.rb +0 -36
- data/lib/adwords_api/v200909/ad_param_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/bulk_mutate_job_service.rb +0 -36
- data/lib/adwords_api/v200909/bulk_mutate_job_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/campaign_ad_extension_service.rb +0 -36
- data/lib/adwords_api/v200909/campaign_ad_extension_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/campaign_criterion_service.rb +0 -36
- data/lib/adwords_api/v200909/campaign_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/campaign_service.rb +0 -36
- data/lib/adwords_api/v200909/campaign_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/campaign_target_service.rb +0 -36
- data/lib/adwords_api/v200909/campaign_target_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/geo_location_service.rb +0 -32
- data/lib/adwords_api/v200909/geo_location_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/info_service.rb +0 -32
- data/lib/adwords_api/v200909/info_service_registry.rb +0 -44
- data/lib/adwords_api/v200909/targeting_idea_service.rb +0 -36
- data/lib/adwords_api/v200909/targeting_idea_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/ad_extension_override_service.rb +0 -36
- data/lib/adwords_api/v201003/ad_extension_override_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/ad_group_ad_service.rb +0 -36
- data/lib/adwords_api/v201003/ad_group_ad_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/ad_group_criterion_service.rb +0 -36
- data/lib/adwords_api/v201003/ad_group_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/ad_group_service.rb +0 -36
- data/lib/adwords_api/v201003/ad_group_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/ad_param_service.rb +0 -36
- data/lib/adwords_api/v201003/ad_param_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/bid_landscape_service.rb +0 -32
- data/lib/adwords_api/v201003/bid_landscape_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/bulk_mutate_job_service.rb +0 -36
- data/lib/adwords_api/v201003/bulk_mutate_job_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/campaign_ad_extension_service.rb +0 -36
- data/lib/adwords_api/v201003/campaign_ad_extension_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/campaign_criterion_service.rb +0 -36
- data/lib/adwords_api/v201003/campaign_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/campaign_service.rb +0 -36
- data/lib/adwords_api/v201003/campaign_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/campaign_target_service.rb +0 -36
- data/lib/adwords_api/v201003/campaign_target_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/geo_location_service.rb +0 -32
- data/lib/adwords_api/v201003/geo_location_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/info_service.rb +0 -32
- data/lib/adwords_api/v201003/info_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/media_service.rb +0 -36
- data/lib/adwords_api/v201003/media_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/report_definition_service.rb +0 -49
- data/lib/adwords_api/v201003/report_definition_service_registry.rb +0 -44
- data/lib/adwords_api/v201003/targeting_idea_service.rb +0 -36
- data/lib/adwords_api/v201003/targeting_idea_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/ad_extension_override_service.rb +0 -36
- data/lib/adwords_api/v201008/ad_extension_override_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/ad_group_ad_service.rb +0 -36
- data/lib/adwords_api/v201008/ad_group_ad_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/ad_group_criterion_service.rb +0 -36
- data/lib/adwords_api/v201008/ad_group_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/ad_group_service.rb +0 -36
- data/lib/adwords_api/v201008/ad_group_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/ad_param_service.rb +0 -36
- data/lib/adwords_api/v201008/ad_param_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/alert_service.rb +0 -32
- data/lib/adwords_api/v201008/alert_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/bid_landscape_service.rb +0 -32
- data/lib/adwords_api/v201008/bid_landscape_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/bulk_mutate_job_service.rb +0 -36
- data/lib/adwords_api/v201008/bulk_mutate_job_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/campaign_ad_extension_service.rb +0 -36
- data/lib/adwords_api/v201008/campaign_ad_extension_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/campaign_criterion_service.rb +0 -36
- data/lib/adwords_api/v201008/campaign_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/campaign_service.rb +0 -36
- data/lib/adwords_api/v201008/campaign_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/campaign_target_service.rb +0 -36
- data/lib/adwords_api/v201008/campaign_target_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/customer_sync_service.rb +0 -32
- data/lib/adwords_api/v201008/customer_sync_service_registry.rb +0 -45
- data/lib/adwords_api/v201008/experiment_service.rb +0 -36
- data/lib/adwords_api/v201008/experiment_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/geo_location_service.rb +0 -32
- data/lib/adwords_api/v201008/geo_location_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/info_service.rb +0 -32
- data/lib/adwords_api/v201008/info_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/media_service.rb +0 -36
- data/lib/adwords_api/v201008/media_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/report_definition_service.rb +0 -49
- data/lib/adwords_api/v201008/report_definition_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/serviced_account_service.rb +0 -32
- data/lib/adwords_api/v201008/serviced_account_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/targeting_idea_service.rb +0 -36
- data/lib/adwords_api/v201008/targeting_idea_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/traffic_estimator_service.rb +0 -32
- data/lib/adwords_api/v201008/traffic_estimator_service_registry.rb +0 -44
- data/lib/adwords_api/v201008/user_list_service.rb +0 -36
- data/lib/adwords_api/v201008/user_list_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/ad_extension_override_service.rb +0 -36
- data/lib/adwords_api/v201101/ad_extension_override_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/ad_group_ad_service.rb +0 -36
- data/lib/adwords_api/v201101/ad_group_ad_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/ad_group_criterion_service.rb +0 -36
- data/lib/adwords_api/v201101/ad_group_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/ad_group_service.rb +0 -36
- data/lib/adwords_api/v201101/ad_group_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/ad_param_service.rb +0 -36
- data/lib/adwords_api/v201101/ad_param_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/alert_service.rb +0 -32
- data/lib/adwords_api/v201101/alert_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/bulk_mutate_job_service.rb +0 -36
- data/lib/adwords_api/v201101/bulk_mutate_job_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/bulk_opportunity_service.rb +0 -32
- data/lib/adwords_api/v201101/bulk_opportunity_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/campaign_ad_extension_service.rb +0 -36
- data/lib/adwords_api/v201101/campaign_ad_extension_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/campaign_criterion_service.rb +0 -36
- data/lib/adwords_api/v201101/campaign_criterion_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/campaign_service.rb +0 -36
- data/lib/adwords_api/v201101/campaign_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/campaign_target_service.rb +0 -36
- data/lib/adwords_api/v201101/campaign_target_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/conversion_tracker_service.rb +0 -36
- data/lib/adwords_api/v201101/conversion_tracker_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/customer_sync_service.rb +0 -32
- data/lib/adwords_api/v201101/customer_sync_service_registry.rb +0 -45
- data/lib/adwords_api/v201101/data_service.rb +0 -36
- data/lib/adwords_api/v201101/data_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/experiment_service.rb +0 -36
- data/lib/adwords_api/v201101/experiment_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/geo_location_service.rb +0 -32
- data/lib/adwords_api/v201101/geo_location_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/info_service.rb +0 -32
- data/lib/adwords_api/v201101/info_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/media_service.rb +0 -36
- data/lib/adwords_api/v201101/media_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/report_definition_service.rb +0 -49
- data/lib/adwords_api/v201101/report_definition_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/serviced_account_service.rb +0 -32
- data/lib/adwords_api/v201101/serviced_account_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/targeting_idea_service.rb +0 -36
- data/lib/adwords_api/v201101/targeting_idea_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/traffic_estimator_service.rb +0 -32
- data/lib/adwords_api/v201101/traffic_estimator_service_registry.rb +0 -44
- data/lib/adwords_api/v201101/user_list_service.rb +0 -36
- data/lib/adwords_api/v201101/user_list_service_registry.rb +0 -44
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -17,17 +18,17 @@
|
|
17
18
|
# See the License for the specific language governing permissions and
|
18
19
|
# limitations under the License.
|
19
20
|
#
|
20
|
-
# This example illustrates how to
|
21
|
-
#
|
21
|
+
# This example illustrates how to add text ads to a given ad group. To create an
|
22
|
+
# ad group, run add_ad_group.rb.
|
22
23
|
#
|
23
24
|
# Tags: AdGroupAdService.mutate
|
24
25
|
|
25
26
|
require 'rubygems'
|
26
27
|
require 'adwords_api'
|
27
28
|
|
28
|
-
API_VERSION = :
|
29
|
+
API_VERSION = :v201109
|
29
30
|
|
30
|
-
def
|
31
|
+
def add_text_ads()
|
31
32
|
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
32
33
|
# when called without parameters.
|
33
34
|
adwords = AdwordsApi::Api.new
|
@@ -39,34 +40,49 @@ def update_ad()
|
|
39
40
|
ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
|
40
41
|
|
41
42
|
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
42
|
-
ad_id = 'INSERT_AD_ID_HERE'.to_i
|
43
43
|
|
44
|
-
#
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
44
|
+
# Create text ads.
|
45
|
+
# The 'xsi_type' field allows you to specify the xsi:type of the object
|
46
|
+
# being created. It's only necessary when you must provide an explicit
|
47
|
+
# type that the client library can't infer.
|
48
|
+
text_ads = [
|
49
|
+
{:xsi_type => 'TextAd',
|
50
|
+
:headline => 'Luxury Cruise to Mars',
|
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
|
+
{:xsi_type => 'TextAd',
|
56
|
+
:headline => 'Luxury Cruise to Mars',
|
57
|
+
:description1 => 'Enjoy your stay at Red Planet.',
|
58
|
+
:description2 => 'Buy your tickets now!',
|
59
|
+
:url => 'http://www.example.com',
|
60
|
+
:display_url => 'www.example.com'}
|
61
|
+
]
|
55
62
|
|
56
|
-
#
|
57
|
-
|
63
|
+
# Create ad 'ADD' operations.
|
64
|
+
text_ad_operations = text_ads.map do |text_ad|
|
65
|
+
{:operator => 'ADD',
|
66
|
+
:operand => {:ad_group_id => ad_group_id, :ad => text_ad}}
|
67
|
+
end
|
68
|
+
|
69
|
+
# Add ads.
|
70
|
+
response = ad_group_ad_srv.mutate(text_ad_operations)
|
58
71
|
if response and response[:value]
|
59
|
-
|
60
|
-
puts
|
61
|
-
|
72
|
+
ads = response[:value]
|
73
|
+
puts "Added %d ad(s) to ad group ID %d:" % [ads.length, ad_group_id]
|
74
|
+
ads.each do |ad|
|
75
|
+
puts "\tAd ID %d, type '%s' and status '%s'" %
|
76
|
+
[ad[:ad][:id], ad[:ad][:ad_type], ad[:status]]
|
77
|
+
end
|
62
78
|
else
|
63
|
-
puts 'No ads were
|
79
|
+
puts 'No ads were added.'
|
64
80
|
end
|
65
81
|
end
|
66
82
|
|
67
83
|
if __FILE__ == $0
|
68
84
|
begin
|
69
|
-
|
85
|
+
add_text_ads()
|
70
86
|
|
71
87
|
# HTTP errors.
|
72
88
|
rescue AdsCommon::Errors::HttpError => e
|
@@ -1,4 +1,5 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
4
|
# Author:: api.sgomes@gmail.com (Sérgio Gomes)
|
4
5
|
#
|
@@ -17,8 +18,8 @@
|
|
17
18
|
# See the License for the specific language governing permissions and
|
18
19
|
# limitations under the License.
|
19
20
|
#
|
20
|
-
# This example deletes an ad using the 'REMOVE' operator. To get ads,
|
21
|
-
#
|
21
|
+
# This example deletes an ad using the 'REMOVE' operator. To get ads, run
|
22
|
+
# get_text_ads.rb.
|
22
23
|
#
|
23
24
|
# Tags: AdGroupAdService.mutate
|
24
25
|
|
@@ -57,7 +58,7 @@ def delete_ad()
|
|
57
58
|
response = ad_group_ad_srv.mutate([operation])
|
58
59
|
if response and response[:value]
|
59
60
|
ad = response[:value].first
|
60
|
-
puts
|
61
|
+
puts "Ad ID %d was successfully deleted." % ad[:ad][:id]
|
61
62
|
else
|
62
63
|
puts 'No ads were deleted.'
|
63
64
|
end
|
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -17,8 +18,8 @@
|
|
17
18
|
# See the License for the specific language governing permissions and
|
18
19
|
# limitations under the License.
|
19
20
|
#
|
20
|
-
# This example deletes an ad group by setting the status to 'DELETED'.
|
21
|
-
#
|
21
|
+
# This example deletes an ad group by setting the status to 'DELETED'. To get ad
|
22
|
+
# groups, run get_ad_groups.rb.
|
22
23
|
#
|
23
24
|
# Tags: AdGroupService.mutate
|
24
25
|
|
@@ -40,19 +41,44 @@ def delete_ad_group()
|
|
40
41
|
|
41
42
|
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
42
43
|
|
44
|
+
# Retrieve the ad group to obtain it's name. This is optional but recommended
|
45
|
+
# to keep deleted objects searchable. In production the name is already known
|
46
|
+
# in most cases.
|
47
|
+
selector = {
|
48
|
+
:fields => ['Id', 'Name'],
|
49
|
+
:predicates => [
|
50
|
+
{:field => 'Id', :operator => 'EQUALS', :values => [ad_group_id]}
|
51
|
+
]
|
52
|
+
}
|
53
|
+
result = ad_group_srv.get(selector)
|
54
|
+
|
55
|
+
if result.nil? or result[:entries].empty?
|
56
|
+
raise StandardError, "Ad group with ID %d was not found." % ad_group_id
|
57
|
+
end
|
58
|
+
|
59
|
+
# We recommend renaming object on delete to avoid name conflicts later.
|
60
|
+
ad_group_name = result[:entries].first[:name]
|
61
|
+
ad_group_name += Time.now.strftime(" (deleted on %Y-%m-%d %H:%M:%S)")
|
62
|
+
|
43
63
|
# Prepare for deleting ad group.
|
44
64
|
operation = {
|
45
65
|
:operator => 'SET',
|
46
66
|
:operand => {
|
47
|
-
:
|
48
|
-
:
|
67
|
+
:id => ad_group_id,
|
68
|
+
:name => ad_group_name,
|
69
|
+
:status => 'DELETED'
|
49
70
|
}
|
50
71
|
}
|
51
72
|
|
52
73
|
# Delete ad group.
|
53
74
|
response = ad_group_srv.mutate([operation])
|
54
|
-
|
55
|
-
|
75
|
+
if response and response[:value]
|
76
|
+
ad_group = response[:value].first
|
77
|
+
puts "Ad group ID %d was successfully deleted and renamed to '%s'." %
|
78
|
+
[ad_group[:id], ad_group[:name]]
|
79
|
+
else
|
80
|
+
puts 'No ad group was updated.'
|
81
|
+
end
|
56
82
|
end
|
57
83
|
|
58
84
|
if __FILE__ == $0
|
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -18,7 +19,7 @@
|
|
18
19
|
# limitations under the License.
|
19
20
|
#
|
20
21
|
# This example deletes a campaign by setting the status to 'DELETED'. To get
|
21
|
-
# campaigns, run
|
22
|
+
# campaigns, run get_campaigns.rb.
|
22
23
|
#
|
23
24
|
# Tags: CampaignService.mutate
|
24
25
|
|
@@ -40,20 +41,45 @@ def delete_campaign()
|
|
40
41
|
|
41
42
|
campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
|
42
43
|
|
44
|
+
# Retrieve the campaign to obtain it's name. This is optional but recommended
|
45
|
+
# to keep deleted objects searchable. In production the name is already known
|
46
|
+
# in most cases.
|
47
|
+
selector = {
|
48
|
+
:fields => ['Id', 'Name'],
|
49
|
+
:predicates => [
|
50
|
+
{:field => 'Id', :operator => 'EQUALS', :values => [campaign_id]}
|
51
|
+
]
|
52
|
+
}
|
53
|
+
result = campaign_srv.get(selector)
|
54
|
+
|
55
|
+
if result.nil? or result[:entries].empty?
|
56
|
+
raise StandardError, "Campaign with ID %d was not found." % campaign_id
|
57
|
+
end
|
58
|
+
|
59
|
+
# We recommend renaming object on delete to avoid name conflicts later.
|
60
|
+
campaign_name = result[:entries].first[:name]
|
61
|
+
campaign_name += Time.now.strftime(" (deleted on %Y-%m-%d %H:%M:%S)")
|
62
|
+
|
43
63
|
# Prepare for deleting campaign.
|
44
64
|
operation = {
|
45
65
|
:operator => 'SET',
|
46
66
|
:operand => {
|
47
67
|
:id => campaign_id,
|
68
|
+
:name => campaign_name,
|
48
69
|
:status => 'DELETED',
|
49
70
|
}
|
50
71
|
}
|
51
72
|
|
52
73
|
# Delete campaign.
|
53
74
|
response = campaign_srv.mutate([operation])
|
54
|
-
|
55
|
-
|
56
|
-
|
75
|
+
|
76
|
+
if response and response[:value]
|
77
|
+
campaign = response[:value].first
|
78
|
+
puts "Campaign ID %d was renamed to '%s' and deleted." %
|
79
|
+
[campaign[:id], campaign[:name]]
|
80
|
+
else
|
81
|
+
puts 'No campaign was updated.'
|
82
|
+
end
|
57
83
|
end
|
58
84
|
|
59
85
|
if __FILE__ == $0
|
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -17,8 +18,8 @@
|
|
17
18
|
# See the License for the specific language governing permissions and
|
18
19
|
# limitations under the License.
|
19
20
|
#
|
20
|
-
# This example deletes
|
21
|
-
#
|
21
|
+
# This example deletes a keyword using the 'REMOVE' operator. To get list of
|
22
|
+
# keywords, run get_keywords.rb.
|
22
23
|
#
|
23
24
|
# Tags: AdGroupCriterionService.mutate
|
24
25
|
|
@@ -27,7 +28,7 @@ require 'adwords_api'
|
|
27
28
|
|
28
29
|
API_VERSION = :v201109
|
29
30
|
|
30
|
-
def
|
31
|
+
def delete_keyword()
|
31
32
|
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
32
33
|
# when called without parameters.
|
33
34
|
adwords = AdwordsApi::Api.new
|
@@ -42,7 +43,7 @@ def delete_ad_group_criterion()
|
|
42
43
|
ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
|
43
44
|
criterion_id = 'INSERT_CRITERION_ID_HERE'.to_i
|
44
45
|
|
45
|
-
# Prepare for deleting
|
46
|
+
# Prepare for deleting keyword.
|
46
47
|
operation = {
|
47
48
|
:operator => 'REMOVE',
|
48
49
|
:operand => {
|
@@ -57,16 +58,20 @@ def delete_ad_group_criterion()
|
|
57
58
|
}
|
58
59
|
}
|
59
60
|
|
60
|
-
# Delete
|
61
|
+
# Delete keyword.
|
61
62
|
response = ad_group_criterion_srv.mutate([operation])
|
62
63
|
ad_group_criterion = response[:value].first
|
63
|
-
|
64
|
-
|
64
|
+
if ad_group_criterion
|
65
|
+
puts "Keyword ID %d was successfully deleted." %
|
66
|
+
ad_group_criterion[:criterion][:id]
|
67
|
+
else
|
68
|
+
puts 'No keywords were deleted.'
|
69
|
+
end
|
65
70
|
end
|
66
71
|
|
67
72
|
if __FILE__ == $0
|
68
73
|
begin
|
69
|
-
|
74
|
+
delete_keyword()
|
70
75
|
|
71
76
|
# HTTP errors.
|
72
77
|
rescue AdsCommon::Errors::HttpError => e
|
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -26,8 +27,9 @@ require 'rubygems'
|
|
26
27
|
require 'adwords_api'
|
27
28
|
|
28
29
|
API_VERSION = :v201109
|
30
|
+
PAGE_SIZE = 500
|
29
31
|
|
30
|
-
def
|
32
|
+
def get_ad_groups()
|
31
33
|
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
32
34
|
# when called without parameters.
|
33
35
|
adwords = AdwordsApi::Api.new
|
@@ -44,28 +46,40 @@ def get_all_ad_groups()
|
|
44
46
|
selector = {
|
45
47
|
:fields => ['Id', 'Name'],
|
46
48
|
:ordering => [{:field => 'Name', :sort_order => 'ASCENDING'}],
|
47
|
-
:predicates => [
|
48
|
-
:field => 'CampaignId',
|
49
|
-
|
50
|
-
|
51
|
-
|
49
|
+
:predicates => [
|
50
|
+
{:field => 'CampaignId', :operator => 'IN', :values => [campaign_id]}
|
51
|
+
],
|
52
|
+
:paging => {
|
53
|
+
:start_index => 0,
|
54
|
+
:number_results => PAGE_SIZE
|
55
|
+
}
|
52
56
|
}
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
57
|
+
|
58
|
+
# Set initial values.
|
59
|
+
offset, page = 0, {}
|
60
|
+
|
61
|
+
begin
|
62
|
+
page = ad_group_srv.get(selector)
|
63
|
+
if page[:entries]
|
64
|
+
page[:entries].each do |ad_group|
|
65
|
+
puts "Ad group name is '%s' and ID is %d" %
|
66
|
+
[ad_group[:name], ad_group[:id]]
|
67
|
+
end
|
68
|
+
# Increment values to request the next page.
|
69
|
+
offset += PAGE_SIZE
|
70
|
+
selector[:paging][:start_index] = offset
|
60
71
|
end
|
61
|
-
|
62
|
-
|
72
|
+
end while page[:total_num_entries] > offset
|
73
|
+
|
74
|
+
if page.include?(:total_num_entries)
|
75
|
+
puts "\tCampaign ID %d has %d ad group(s)." %
|
76
|
+
[campaign_id, page[:total_num_entries]]
|
63
77
|
end
|
64
78
|
end
|
65
79
|
|
66
80
|
if __FILE__ == $0
|
67
81
|
begin
|
68
|
-
|
82
|
+
get_ad_groups()
|
69
83
|
|
70
84
|
# HTTP errors.
|
71
85
|
rescue AdsCommon::Errors::HttpError => e
|
@@ -1,6 +1,7 @@
|
|
1
|
-
#!/usr/bin/ruby
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# Encoding: utf-8
|
2
3
|
#
|
3
|
-
# Author:: api.
|
4
|
+
# Author:: api.dklimkin@gmail.com (Danial Klimkin)
|
4
5
|
#
|
5
6
|
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
6
7
|
#
|
@@ -25,8 +26,9 @@ require 'rubygems'
|
|
25
26
|
require 'adwords_api'
|
26
27
|
|
27
28
|
API_VERSION = :v201109
|
29
|
+
PAGE_SIZE = 500
|
28
30
|
|
29
|
-
def
|
31
|
+
def get_campaigns()
|
30
32
|
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
31
33
|
# when called without parameters.
|
32
34
|
adwords = AdwordsApi::Api.new
|
@@ -37,27 +39,42 @@ def get_all_campaigns()
|
|
37
39
|
|
38
40
|
campaign_srv = adwords.service(:CampaignService, API_VERSION)
|
39
41
|
|
40
|
-
# Get all the campaigns for this account
|
42
|
+
# Get all the campaigns for this account.
|
41
43
|
selector = {
|
42
44
|
:fields => ['Id', 'Name', 'Status'],
|
43
|
-
:ordering => [
|
45
|
+
:ordering => [
|
46
|
+
{:field => 'Name', :sort_order => 'ASCENDING'}
|
47
|
+
],
|
48
|
+
:paging => {
|
49
|
+
:start_index => 0,
|
50
|
+
:number_results => PAGE_SIZE
|
51
|
+
}
|
44
52
|
}
|
45
|
-
response = campaign_srv.get(selector)
|
46
53
|
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
54
|
+
# Set initial values.
|
55
|
+
offset, page = 0, {}
|
56
|
+
|
57
|
+
begin
|
58
|
+
page = campaign_srv.get(selector)
|
59
|
+
if page[:entries]
|
60
|
+
page[:entries].each do |campaign|
|
61
|
+
puts "Campaign ID %d, name '%s' and status '%s'" %
|
62
|
+
[campaign[:id], campaign[:name], campaign[:status]]
|
63
|
+
end
|
64
|
+
# Increment values to request the next page.
|
65
|
+
offset += PAGE_SIZE
|
66
|
+
selector[:paging][:start_index] = offset
|
52
67
|
end
|
53
|
-
|
54
|
-
|
68
|
+
end while page[:total_num_entries] > offset
|
69
|
+
|
70
|
+
if page.include?(:total_num_entries)
|
71
|
+
puts "\tTotal number of campaigns found: %d." % [page[:total_num_entries]]
|
55
72
|
end
|
56
73
|
end
|
57
74
|
|
58
75
|
if __FILE__ == $0
|
59
76
|
begin
|
60
|
-
|
77
|
+
get_campaigns()
|
61
78
|
|
62
79
|
# HTTP errors.
|
63
80
|
rescue AdsCommon::Errors::HttpError => e
|