google-adwords-api 0.22.0 → 0.23.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/ChangeLog +7 -0
- data/README.md +5 -0
- data/adwords_api.yml +1 -1
- data/lib/adwords_api/api_config.rb +96 -4
- data/lib/adwords_api/batch_job_utils.rb +1 -0
- data/lib/adwords_api/v201702/account_label_service.rb +46 -0
- data/lib/adwords_api/v201702/account_label_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_customizer_feed_service.rb +46 -0
- data/lib/adwords_api/v201702/ad_customizer_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_ad_service.rb +70 -0
- data/lib/adwords_api/v201702/ad_group_ad_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_bid_modifier_service.rb +54 -0
- data/lib/adwords_api/v201702/ad_group_bid_modifier_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_criterion_service.rb +62 -0
- data/lib/adwords_api/v201702/ad_group_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_extension_setting_service.rb +54 -0
- data/lib/adwords_api/v201702/ad_group_extension_setting_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_feed_service.rb +54 -0
- data/lib/adwords_api/v201702/ad_group_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_group_service.rb +62 -0
- data/lib/adwords_api/v201702/ad_group_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/ad_param_service.rb +46 -0
- data/lib/adwords_api/v201702/ad_param_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/adwords_user_list_service.rb +62 -0
- data/lib/adwords_api/v201702/adwords_user_list_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/batch_job_service.rb +54 -0
- data/lib/adwords_api/v201702/batch_job_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/bidding_strategy_service.rb +54 -0
- data/lib/adwords_api/v201702/bidding_strategy_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/budget_order_service.rb +54 -0
- data/lib/adwords_api/v201702/budget_order_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/budget_service.rb +54 -0
- data/lib/adwords_api/v201702/budget_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/campaign_criterion_service.rb +54 -0
- data/lib/adwords_api/v201702/campaign_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/campaign_extension_setting_service.rb +54 -0
- data/lib/adwords_api/v201702/campaign_extension_setting_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/campaign_feed_service.rb +54 -0
- data/lib/adwords_api/v201702/campaign_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/campaign_service.rb +62 -0
- data/lib/adwords_api/v201702/campaign_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/campaign_shared_set_service.rb +54 -0
- data/lib/adwords_api/v201702/campaign_shared_set_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/constant_data_service.rb +110 -0
- data/lib/adwords_api/v201702/constant_data_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/conversion_tracker_service.rb +54 -0
- data/lib/adwords_api/v201702/conversion_tracker_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/customer_extension_setting_service.rb +54 -0
- data/lib/adwords_api/v201702/customer_extension_setting_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/customer_feed_service.rb +54 -0
- data/lib/adwords_api/v201702/customer_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/customer_service.rb +62 -0
- data/lib/adwords_api/v201702/customer_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/customer_sync_service.rb +38 -0
- data/lib/adwords_api/v201702/customer_sync_service_registry.rb +47 -0
- data/lib/adwords_api/v201702/data_service.rb +94 -0
- data/lib/adwords_api/v201702/data_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/draft_async_error_service.rb +46 -0
- data/lib/adwords_api/v201702/draft_async_error_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/draft_service.rb +54 -0
- data/lib/adwords_api/v201702/draft_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/feed_item_service.rb +54 -0
- data/lib/adwords_api/v201702/feed_item_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/feed_mapping_service.rb +54 -0
- data/lib/adwords_api/v201702/feed_mapping_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/feed_service.rb +54 -0
- data/lib/adwords_api/v201702/feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/label_service.rb +54 -0
- data/lib/adwords_api/v201702/label_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/location_criterion_service.rb +46 -0
- data/lib/adwords_api/v201702/location_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/managed_customer_service.rb +78 -0
- data/lib/adwords_api/v201702/managed_customer_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/media_service.rb +54 -0
- data/lib/adwords_api/v201702/media_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/offline_call_conversion_feed_service.rb +38 -0
- data/lib/adwords_api/v201702/offline_call_conversion_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/offline_conversion_feed_service.rb +38 -0
- data/lib/adwords_api/v201702/offline_conversion_feed_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/report_definition_service.rb +38 -0
- data/lib/adwords_api/v201702/report_definition_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/shared_criterion_service.rb +54 -0
- data/lib/adwords_api/v201702/shared_criterion_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/shared_set_service.rb +54 -0
- data/lib/adwords_api/v201702/shared_set_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/targeting_idea_service.rb +38 -0
- data/lib/adwords_api/v201702/targeting_idea_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/traffic_estimator_service.rb +38 -0
- data/lib/adwords_api/v201702/traffic_estimator_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/trial_async_error_service.rb +46 -0
- data/lib/adwords_api/v201702/trial_async_error_service_registry.rb +46 -0
- data/lib/adwords_api/v201702/trial_service.rb +54 -0
- data/lib/adwords_api/v201702/trial_service_registry.rb +46 -0
- data/lib/adwords_api/version.rb +1 -1
- data/test/suite_unittests.rb +0 -4
- metadata +104 -267
- data/examples/v201605/account_management/create_account.rb +0 -88
- data/examples/v201605/account_management/get_account_changes.rb +0 -135
- data/examples/v201605/account_management/get_account_hierarchy.rb +0 -132
- data/examples/v201605/advanced_operations/add_ad_customizers.rb +0 -184
- data/examples/v201605/advanced_operations/add_ad_group_bid_modifier.rb +0 -101
- data/examples/v201605/advanced_operations/add_click_to_download_ad.rb +0 -133
- data/examples/v201605/advanced_operations/add_html5_ad.rb +0 -137
- data/examples/v201605/advanced_operations/add_responsive_display_ad.rb +0 -130
- data/examples/v201605/advanced_operations/add_text_ad_with_upgraded_urls.rb +0 -134
- data/examples/v201605/advanced_operations/create_and_attach_shared_keyword_set.rb +0 -141
- data/examples/v201605/advanced_operations/find_and_remove_criteria_from_shared_set.rb +0 -174
- data/examples/v201605/advanced_operations/get_ad_group_bid_modifiers.rb +0 -102
- data/examples/v201605/advanced_operations/use_portfolio_bidding_strategy.rb +0 -146
- data/examples/v201605/basic_operations/add_ad_groups.rb +0 -142
- data/examples/v201605/basic_operations/add_campaigns.rb +0 -138
- data/examples/v201605/basic_operations/add_expanded_text_ads.rb +0 -108
- data/examples/v201605/basic_operations/add_keywords.rb +0 -114
- data/examples/v201605/basic_operations/add_text_ads.rb +0 -109
- data/examples/v201605/basic_operations/get_ad_groups.rb +0 -102
- data/examples/v201605/basic_operations/get_campaigns.rb +0 -97
- data/examples/v201605/basic_operations/get_campaigns_with_awql.rb +0 -89
- data/examples/v201605/basic_operations/get_expanded_text_ads.rb +0 -122
- data/examples/v201605/basic_operations/get_keywords.rb +0 -109
- data/examples/v201605/basic_operations/get_text_ads.rb +0 -110
- data/examples/v201605/basic_operations/pause_ad.rb +0 -88
- data/examples/v201605/basic_operations/remove_ad.rb +0 -89
- data/examples/v201605/basic_operations/remove_ad_group.rb +0 -85
- data/examples/v201605/basic_operations/remove_campaign.rb +0 -87
- data/examples/v201605/basic_operations/remove_keyword.rb +0 -94
- data/examples/v201605/basic_operations/update_ad_group.rb +0 -85
- data/examples/v201605/basic_operations/update_campaign.rb +0 -86
- data/examples/v201605/basic_operations/update_keyword.rb +0 -106
- data/examples/v201605/campaign_management/add_campaign_labels.rb +0 -82
- data/examples/v201605/campaign_management/add_complete_campaigns_using_batch_job.rb +0 -355
- data/examples/v201605/campaign_management/add_draft.rb +0 -114
- data/examples/v201605/campaign_management/add_experiment.rb +0 -162
- data/examples/v201605/campaign_management/add_keywords_using_incremental_batch_job.rb +0 -210
- data/examples/v201605/campaign_management/add_trial.rb +0 -142
- data/examples/v201605/campaign_management/get_all_disapproved_ads.rb +0 -97
- data/examples/v201605/campaign_management/get_all_disapproved_ads_with_awql.rb +0 -89
- data/examples/v201605/campaign_management/get_campaigns_by_label.rb +0 -108
- data/examples/v201605/campaign_management/graduate_trial.rb +0 -106
- data/examples/v201605/campaign_management/promote_experiment.rb +0 -81
- data/examples/v201605/campaign_management/set_ad_parameters.rb +0 -118
- data/examples/v201605/campaign_management/set_criterion_bid_modifier.rb +0 -104
- data/examples/v201605/campaign_management/validate_text_ad.rb +0 -110
- data/examples/v201605/error_handling/handle_partial_failures.rb +0 -130
- data/examples/v201605/error_handling/handle_policy_violation_error.rb +0 -141
- data/examples/v201605/extensions/add_google_my_business_location_extensions.rb +0 -193
- data/examples/v201605/extensions/add_site_links.rb +0 -184
- data/examples/v201605/extensions/add_site_links_using_feeds.rb +0 -281
- data/examples/v201605/migration/migrate_to_extension_settings.rb +0 -386
- data/examples/v201605/misc/get_all_images_and_videos.rb +0 -104
- data/examples/v201605/misc/setup_oauth2.rb +0 -84
- data/examples/v201605/misc/upload_image.rb +0 -93
- data/examples/v201605/misc/upload_media_bundle.rb +0 -90
- data/examples/v201605/misc/use_oauth2_jwt.rb +0 -93
- data/examples/v201605/misc/use_runtime_config.rb +0 -92
- data/examples/v201605/optimization/estimate_keyword_traffic.rb +0 -191
- data/examples/v201605/optimization/get_campaign_criterion_bid_modifier_simulations.rb +0 -128
- data/examples/v201605/optimization/get_keyword_bid_simulations.rb +0 -95
- data/examples/v201605/optimization/get_keyword_ideas.rb +0 -136
- data/examples/v201605/remarketing/add_audience.rb +0 -118
- data/examples/v201605/remarketing/add_conversion_tracker.rb +0 -97
- data/examples/v201605/remarketing/add_crm_based_user_list.rb +0 -116
- data/examples/v201605/remarketing/add_rule_based_user_lists.rb +0 -167
- data/examples/v201605/remarketing/upload_offline_conversions.rb +0 -98
- data/examples/v201605/reporting/download_criteria_report.rb +0 -92
- data/examples/v201605/reporting/download_criteria_report_with_awql.rb +0 -93
- data/examples/v201605/reporting/get_report_fields.rb +0 -75
- data/examples/v201605/reporting/parallel_report_download.rb +0 -164
- data/examples/v201605/reporting/stream_criteria_report_results.rb +0 -97
- data/examples/v201605/shopping_campaigns/add_product_partition_tree.rb +0 -267
- data/examples/v201605/shopping_campaigns/add_product_scope.rb +0 -130
- data/examples/v201605/shopping_campaigns/add_shopping_campaign.rb +0 -129
- data/examples/v201605/shopping_campaigns/get_product_category_taxonomy.rb +0 -115
- data/examples/v201605/targeting/add_campaign_targeting_criteria.rb +0 -180
- data/examples/v201605/targeting/add_demographic_targeting_criteria.rb +0 -112
- data/examples/v201605/targeting/get_campaign_targeting_criteria.rb +0 -106
- data/examples/v201605/targeting/get_targetable_languages_and_carriers.rb +0 -89
- data/examples/v201605/targeting/lookup_location.rb +0 -108
- data/examples/v201607/account_management/create_account.rb +0 -88
- data/examples/v201607/account_management/get_account_changes.rb +0 -135
- data/examples/v201607/account_management/get_account_hierarchy.rb +0 -132
- data/examples/v201607/advanced_operations/add_ad_customizers.rb +0 -184
- data/examples/v201607/advanced_operations/add_ad_group_bid_modifier.rb +0 -101
- data/examples/v201607/advanced_operations/add_click_to_download_ad.rb +0 -148
- data/examples/v201607/advanced_operations/add_html5_ad.rb +0 -137
- data/examples/v201607/advanced_operations/add_responsive_display_ad.rb +0 -130
- data/examples/v201607/advanced_operations/add_text_ad_with_upgraded_urls.rb +0 -134
- data/examples/v201607/advanced_operations/create_and_attach_shared_keyword_set.rb +0 -141
- data/examples/v201607/advanced_operations/find_and_remove_criteria_from_shared_set.rb +0 -174
- data/examples/v201607/advanced_operations/get_ad_group_bid_modifiers.rb +0 -102
- data/examples/v201607/advanced_operations/use_portfolio_bidding_strategy.rb +0 -146
- data/examples/v201607/basic_operations/add_ad_groups.rb +0 -142
- data/examples/v201607/basic_operations/add_campaigns.rb +0 -138
- data/examples/v201607/basic_operations/add_expanded_text_ads.rb +0 -108
- data/examples/v201607/basic_operations/add_keywords.rb +0 -114
- data/examples/v201607/basic_operations/add_text_ads.rb +0 -109
- data/examples/v201607/basic_operations/get_ad_groups.rb +0 -102
- data/examples/v201607/basic_operations/get_campaigns.rb +0 -97
- data/examples/v201607/basic_operations/get_campaigns_with_awql.rb +0 -89
- data/examples/v201607/basic_operations/get_expanded_text_ads.rb +0 -122
- data/examples/v201607/basic_operations/get_keywords.rb +0 -109
- data/examples/v201607/basic_operations/get_text_ads.rb +0 -110
- data/examples/v201607/basic_operations/pause_ad.rb +0 -88
- data/examples/v201607/basic_operations/remove_ad.rb +0 -89
- data/examples/v201607/basic_operations/remove_ad_group.rb +0 -85
- data/examples/v201607/basic_operations/remove_campaign.rb +0 -87
- data/examples/v201607/basic_operations/remove_keyword.rb +0 -94
- data/examples/v201607/basic_operations/update_ad_group.rb +0 -85
- data/examples/v201607/basic_operations/update_campaign.rb +0 -86
- data/examples/v201607/basic_operations/update_keyword.rb +0 -106
- data/examples/v201607/campaign_management/add_campaign_labels.rb +0 -82
- data/examples/v201607/campaign_management/add_complete_campaigns_using_batch_job.rb +0 -355
- data/examples/v201607/campaign_management/add_draft.rb +0 -113
- data/examples/v201607/campaign_management/add_experiment.rb +0 -162
- data/examples/v201607/campaign_management/add_keywords_using_incremental_batch_job.rb +0 -210
- data/examples/v201607/campaign_management/add_trial.rb +0 -141
- data/examples/v201607/campaign_management/get_all_disapproved_ads.rb +0 -97
- data/examples/v201607/campaign_management/get_all_disapproved_ads_with_awql.rb +0 -89
- data/examples/v201607/campaign_management/get_campaigns_by_label.rb +0 -108
- data/examples/v201607/campaign_management/graduate_trial.rb +0 -106
- data/examples/v201607/campaign_management/promote_experiment.rb +0 -81
- data/examples/v201607/campaign_management/set_ad_parameters.rb +0 -118
- data/examples/v201607/campaign_management/set_criterion_bid_modifier.rb +0 -104
- data/examples/v201607/campaign_management/validate_text_ad.rb +0 -110
- data/examples/v201607/error_handling/handle_partial_failures.rb +0 -130
- data/examples/v201607/error_handling/handle_policy_violation_error.rb +0 -141
- data/examples/v201607/extensions/add_google_my_business_location_extensions.rb +0 -193
- data/examples/v201607/extensions/add_prices.rb +0 -162
- data/examples/v201607/extensions/add_site_links.rb +0 -199
- data/examples/v201607/extensions/add_site_links_using_feeds.rb +0 -286
- data/examples/v201607/migration/migrate_to_extension_settings.rb +0 -386
- data/examples/v201607/misc/get_all_images_and_videos.rb +0 -104
- data/examples/v201607/misc/setup_oauth2.rb +0 -84
- data/examples/v201607/misc/upload_image.rb +0 -93
- data/examples/v201607/misc/upload_media_bundle.rb +0 -90
- data/examples/v201607/misc/use_oauth2_jwt.rb +0 -93
- data/examples/v201607/misc/use_runtime_config.rb +0 -92
- data/examples/v201607/optimization/estimate_keyword_traffic.rb +0 -191
- data/examples/v201607/optimization/get_campaign_criterion_bid_modifier_simulations.rb +0 -128
- data/examples/v201607/optimization/get_keyword_bid_simulations.rb +0 -95
- data/examples/v201607/optimization/get_keyword_ideas.rb +0 -136
- data/examples/v201607/remarketing/add_audience.rb +0 -118
- data/examples/v201607/remarketing/add_conversion_tracker.rb +0 -97
- data/examples/v201607/remarketing/add_crm_based_user_list.rb +0 -116
- data/examples/v201607/remarketing/add_rule_based_user_lists.rb +0 -167
- data/examples/v201607/remarketing/upload_offline_conversions.rb +0 -98
- data/examples/v201607/reporting/download_criteria_report.rb +0 -92
- data/examples/v201607/reporting/download_criteria_report_with_awql.rb +0 -93
- data/examples/v201607/reporting/get_report_fields.rb +0 -75
- data/examples/v201607/reporting/parallel_report_download.rb +0 -164
- data/examples/v201607/reporting/stream_criteria_report_results.rb +0 -97
- data/examples/v201607/shopping_campaigns/add_product_partition_tree.rb +0 -267
- data/examples/v201607/shopping_campaigns/add_product_scope.rb +0 -130
- data/examples/v201607/shopping_campaigns/add_shopping_campaign.rb +0 -129
- data/examples/v201607/shopping_campaigns/get_product_category_taxonomy.rb +0 -115
- data/examples/v201607/targeting/add_campaign_targeting_criteria.rb +0 -166
- data/examples/v201607/targeting/add_demographic_targeting_criteria.rb +0 -112
- data/examples/v201607/targeting/get_campaign_targeting_criteria.rb +0 -106
- data/examples/v201607/targeting/get_targetable_languages_and_carriers.rb +0 -89
- data/examples/v201607/targeting/lookup_location.rb +0 -108
- data/examples/v201609/account_management/accept_service_link.rb +0 -91
- data/examples/v201609/account_management/create_account.rb +0 -88
- data/examples/v201609/account_management/get_account_changes.rb +0 -135
- data/examples/v201609/account_management/get_account_hierarchy.rb +0 -132
- data/examples/v201609/advanced_operations/add_ad_customizers.rb +0 -183
- data/examples/v201609/advanced_operations/add_ad_group_bid_modifier.rb +0 -101
- data/examples/v201609/advanced_operations/add_click_to_download_ad.rb +0 -148
- data/examples/v201609/advanced_operations/add_expanded_text_ad_with_upgraded_urls.rb +0 -132
- data/examples/v201609/advanced_operations/add_html5_ad.rb +0 -137
- data/examples/v201609/advanced_operations/add_responsive_display_ad.rb +0 -130
- data/examples/v201609/advanced_operations/add_universal_app_campaign.rb +0 -218
- data/examples/v201609/advanced_operations/create_and_attach_shared_keyword_set.rb +0 -141
- data/examples/v201609/advanced_operations/find_and_remove_criteria_from_shared_set.rb +0 -174
- data/examples/v201609/advanced_operations/get_ad_group_bid_modifiers.rb +0 -102
- data/examples/v201609/advanced_operations/use_portfolio_bidding_strategy.rb +0 -149
- data/examples/v201609/basic_operations/add_ad_groups.rb +0 -142
- data/examples/v201609/basic_operations/add_campaigns.rb +0 -141
- data/examples/v201609/basic_operations/add_expanded_text_ads.rb +0 -108
- data/examples/v201609/basic_operations/add_keywords.rb +0 -114
- data/examples/v201609/basic_operations/get_ad_groups.rb +0 -102
- data/examples/v201609/basic_operations/get_campaigns.rb +0 -97
- data/examples/v201609/basic_operations/get_campaigns_with_awql.rb +0 -89
- data/examples/v201609/basic_operations/get_expanded_text_ads.rb +0 -122
- data/examples/v201609/basic_operations/get_keywords.rb +0 -109
- data/examples/v201609/basic_operations/get_text_ads.rb +0 -109
- data/examples/v201609/basic_operations/pause_ad.rb +0 -87
- data/examples/v201609/basic_operations/remove_ad.rb +0 -89
- data/examples/v201609/basic_operations/remove_ad_group.rb +0 -85
- data/examples/v201609/basic_operations/remove_campaign.rb +0 -87
- data/examples/v201609/basic_operations/remove_keyword.rb +0 -94
- data/examples/v201609/basic_operations/update_ad_group.rb +0 -85
- data/examples/v201609/basic_operations/update_campaign.rb +0 -86
- data/examples/v201609/basic_operations/update_keyword.rb +0 -106
- data/examples/v201609/campaign_management/add_campaign_labels.rb +0 -82
- data/examples/v201609/campaign_management/add_complete_campaigns_using_batch_job.rb +0 -357
- data/examples/v201609/campaign_management/add_draft.rb +0 -113
- data/examples/v201609/campaign_management/add_keywords_using_incremental_batch_job.rb +0 -210
- data/examples/v201609/campaign_management/add_trial.rb +0 -141
- data/examples/v201609/campaign_management/get_all_disapproved_ads.rb +0 -97
- data/examples/v201609/campaign_management/get_all_disapproved_ads_with_awql.rb +0 -89
- data/examples/v201609/campaign_management/get_campaigns_by_label.rb +0 -108
- data/examples/v201609/campaign_management/graduate_trial.rb +0 -106
- data/examples/v201609/campaign_management/set_ad_parameters.rb +0 -118
- data/examples/v201609/campaign_management/set_criterion_bid_modifier.rb +0 -104
- data/examples/v201609/campaign_management/validate_text_ad.rb +0 -109
- data/examples/v201609/error_handling/handle_partial_failures.rb +0 -130
- data/examples/v201609/error_handling/handle_policy_violation_error.rb +0 -141
- data/examples/v201609/extensions/add_google_my_business_location_extensions.rb +0 -193
- data/examples/v201609/extensions/add_prices.rb +0 -162
- data/examples/v201609/extensions/add_site_links.rb +0 -199
- data/examples/v201609/extensions/add_site_links_using_feeds.rb +0 -286
- data/examples/v201609/migration/migrate_to_extension_settings.rb +0 -386
- data/examples/v201609/misc/get_all_images_and_videos.rb +0 -104
- data/examples/v201609/misc/setup_oauth2.rb +0 -84
- data/examples/v201609/misc/upload_image.rb +0 -93
- data/examples/v201609/misc/upload_media_bundle.rb +0 -90
- data/examples/v201609/misc/use_oauth2_jwt.rb +0 -93
- data/examples/v201609/misc/use_runtime_config.rb +0 -92
- data/examples/v201609/optimization/estimate_keyword_traffic.rb +0 -191
- data/examples/v201609/optimization/get_campaign_criterion_bid_modifier_simulations.rb +0 -128
- data/examples/v201609/optimization/get_keyword_bid_simulations.rb +0 -95
- data/examples/v201609/optimization/get_keyword_ideas.rb +0 -136
- data/examples/v201609/remarketing/add_audience.rb +0 -118
- data/examples/v201609/remarketing/add_conversion_tracker.rb +0 -97
- data/examples/v201609/remarketing/add_crm_based_user_list.rb +0 -116
- data/examples/v201609/remarketing/add_rule_based_user_lists.rb +0 -167
- data/examples/v201609/remarketing/upload_offline_call_conversions.rb +0 -111
- data/examples/v201609/remarketing/upload_offline_conversions.rb +0 -98
- data/examples/v201609/reporting/download_criteria_report.rb +0 -92
- data/examples/v201609/reporting/download_criteria_report_with_awql.rb +0 -93
- data/examples/v201609/reporting/get_report_fields.rb +0 -75
- data/examples/v201609/reporting/parallel_report_download.rb +0 -164
- data/examples/v201609/reporting/stream_criteria_report_results.rb +0 -97
- data/examples/v201609/shopping_campaigns/add_product_partition_tree.rb +0 -267
- data/examples/v201609/shopping_campaigns/add_product_scope.rb +0 -130
- data/examples/v201609/shopping_campaigns/add_shopping_campaign.rb +0 -133
- data/examples/v201609/shopping_campaigns/get_product_category_taxonomy.rb +0 -115
- data/examples/v201609/targeting/add_campaign_targeting_criteria.rb +0 -166
- data/examples/v201609/targeting/add_demographic_targeting_criteria.rb +0 -112
- data/examples/v201609/targeting/get_campaign_targeting_criteria.rb +0 -106
- data/examples/v201609/targeting/get_targetable_languages_and_carriers.rb +0 -89
- data/examples/v201609/targeting/lookup_location.rb +0 -108
- data/test/adwords_api/test_adwords_api.rb +0 -92
- data/test/adwords_api/test_api_config.rb +0 -56
- data/test/adwords_api/test_batch_job_utils.rb +0 -121
- data/test/adwords_api/test_choices.rb +0 -199
- data/test/adwords_api/test_credential_handler.rb +0 -119
- data/test/adwords_api/test_report_stream.rb +0 -65
- data/test/adwords_api/test_report_utils.rb +0 -267
- data/test/adwords_api/test_utils.rb +0 -48
- data/test/coverage.rb +0 -36
- data/test/suite_integration.rb +0 -38
- data/test/templates/v201605/basic_operations_get_campaigns.def +0 -116
- data/test/templates/v201605/basic_operations_update_keyword.def +0 -125
- data/test/templates/v201605/misc_use_oauth2_jwt.def +0 -131
- data/test/templates/v201607/basic_operations_get_campaigns.def +0 -116
- data/test/templates/v201607/basic_operations_update_keyword.def +0 -125
- data/test/templates/v201607/misc_use_oauth2_jwt.def +0 -131
- data/test/templates/v201609/basic_operations_get_campaigns.def +0 -116
- data/test/templates/v201609/basic_operations_update_keyword.def +0 -125
- data/test/templates/v201609/misc_use_oauth2_jwt.def +0 -131
- data/test/test_utils.rb +0 -106
@@ -1,92 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
# Encoding: utf-8
|
3
|
-
#
|
4
|
-
# Copyright:: Copyright 2014, Google Inc. All Rights Reserved.
|
5
|
-
#
|
6
|
-
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
7
|
-
# you may not use this file except in compliance with the License.
|
8
|
-
# You may obtain a copy of the License at
|
9
|
-
#
|
10
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
11
|
-
#
|
12
|
-
# Unless required by applicable law or agreed to in writing, software
|
13
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
14
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
15
|
-
# implied.
|
16
|
-
# See the License for the specific language governing permissions and
|
17
|
-
# limitations under the License.
|
18
|
-
#
|
19
|
-
# This example demonstrates how to make AdWords queries without using the
|
20
|
-
# adwords_api.yml file.
|
21
|
-
|
22
|
-
require 'adwords_api'
|
23
|
-
require 'date'
|
24
|
-
|
25
|
-
def use_runtime_config(client_id, client_secret, refresh_token,
|
26
|
-
developer_token, client_customer_id, user_agent)
|
27
|
-
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
28
|
-
# when called without parameters.
|
29
|
-
adwords = AdwordsApi::Api.new({
|
30
|
-
:authentication => {
|
31
|
-
:method => 'OAuth2',
|
32
|
-
:oauth2_client_id => client_id,
|
33
|
-
:oauth2_client_secret => client_secret,
|
34
|
-
:developer_token => developer_token,
|
35
|
-
:client_customer_id => client_customer_id,
|
36
|
-
:user_agent => user_agent,
|
37
|
-
:oauth2_token => {
|
38
|
-
:refresh_token => refresh_token
|
39
|
-
}
|
40
|
-
},
|
41
|
-
:service => {
|
42
|
-
:environment => 'PRODUCTION'
|
43
|
-
}
|
44
|
-
})
|
45
|
-
|
46
|
-
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
47
|
-
# the hash above or provide your own logger:
|
48
|
-
# adwords.logger = Logger.new('adwords_xml.log')
|
49
|
-
|
50
|
-
customer_srv = adwords.service(:CustomerService, API_VERSION)
|
51
|
-
customer = customer_srv.get()
|
52
|
-
puts "You are logged in as customer: %d" % customer[:id]
|
53
|
-
end
|
54
|
-
|
55
|
-
if __FILE__ == $0
|
56
|
-
API_VERSION = :v201609
|
57
|
-
|
58
|
-
begin
|
59
|
-
client_id = 'INSERT_CLIENT_ID_HERE'
|
60
|
-
client_secret = 'INSERT_CLIENT_SECRET_HERE'
|
61
|
-
refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
|
62
|
-
developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
|
63
|
-
client_customer_id = 'INSERT_CLIENT_CUSTOMER_ID_HERE'
|
64
|
-
user_agent = 'INSERT_USER_AGENT_HERE'
|
65
|
-
|
66
|
-
use_runtime_config(client_id, client_secret, refresh_token,
|
67
|
-
developer_token, client_customer_id, user_agent)
|
68
|
-
|
69
|
-
# Authorization error.
|
70
|
-
rescue AdsCommon::Errors::OAuth2VerificationRequired => e
|
71
|
-
puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
|
72
|
-
"OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
|
73
|
-
"to retrieve and store OAuth2 tokens."
|
74
|
-
puts "See this wiki page for more details:\n\n " +
|
75
|
-
'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
|
76
|
-
|
77
|
-
# HTTP errors.
|
78
|
-
rescue AdsCommon::Errors::HttpError => e
|
79
|
-
puts "HTTP Error: %s" % e
|
80
|
-
|
81
|
-
# API errors.
|
82
|
-
rescue AdwordsApi::Errors::ApiException => e
|
83
|
-
puts "Message: %s" % e.message
|
84
|
-
puts 'Errors:'
|
85
|
-
e.errors.each_with_index do |error, index|
|
86
|
-
puts "\tError [%d]:" % (index + 1)
|
87
|
-
error.each do |field, value|
|
88
|
-
puts "\t\t%s: %s" % [field, value]
|
89
|
-
end
|
90
|
-
end
|
91
|
-
end
|
92
|
-
end
|
@@ -1,191 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
# Encoding: utf-8
|
3
|
-
#
|
4
|
-
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
5
|
-
#
|
6
|
-
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
7
|
-
# you may not use this file except in compliance with the License.
|
8
|
-
# You may obtain a copy of the License at
|
9
|
-
#
|
10
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
11
|
-
#
|
12
|
-
# Unless required by applicable law or agreed to in writing, software
|
13
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
14
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
15
|
-
# implied.
|
16
|
-
# See the License for the specific language governing permissions and
|
17
|
-
# limitations under the License.
|
18
|
-
#
|
19
|
-
# This example gets keyword traffic estimates.
|
20
|
-
|
21
|
-
require 'adwords_api'
|
22
|
-
|
23
|
-
def estimate_keyword_traffic()
|
24
|
-
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
25
|
-
# when called without parameters.
|
26
|
-
adwords = AdwordsApi::Api.new
|
27
|
-
|
28
|
-
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
29
|
-
# the configuration file or provide your own logger:
|
30
|
-
# adwords.logger = Logger.new('adwords_xml.log')
|
31
|
-
|
32
|
-
traffic_estimator_srv = adwords.service(:TrafficEstimatorService, API_VERSION)
|
33
|
-
|
34
|
-
# Create keywords. Up to 2000 keywords can be passed in a single request.
|
35
|
-
keywords = [
|
36
|
-
# The 'xsi_type' field allows you to specify the xsi:type of the object
|
37
|
-
# being created. It's only necessary when you must provide an explicit
|
38
|
-
# type that the client library can't infer.
|
39
|
-
{:xsi_type => 'Keyword', :text => 'mars cruise', :match_type => 'BROAD'},
|
40
|
-
{:xsi_type => 'Keyword', :text => 'cheap cruise', :match_type => 'PHRASE'},
|
41
|
-
{:xsi_type => 'Keyword', :text => 'cruise', :match_type => 'EXACT'},
|
42
|
-
{:xsi_type => 'Keyword', :text => 'moon walk', :match_type => 'BROAD'}
|
43
|
-
]
|
44
|
-
|
45
|
-
# Create a keyword estimate request for each keyword.
|
46
|
-
keyword_requests = keywords.map {|keyword| {:keyword => keyword}}
|
47
|
-
|
48
|
-
# Negative keywords don't return estimates, but adjust the estimates of the
|
49
|
-
# other keywords in the hypothetical ad group. To specify a negative keyword
|
50
|
-
# set the is_negative field to true.
|
51
|
-
keyword_requests[3][:is_negative] = true
|
52
|
-
|
53
|
-
# Create ad group estimate requests.
|
54
|
-
ad_group_request = {
|
55
|
-
:keyword_estimate_requests => keyword_requests,
|
56
|
-
:max_cpc => {
|
57
|
-
:micro_amount => 1000000
|
58
|
-
}
|
59
|
-
}
|
60
|
-
|
61
|
-
# Create campaign estimate requests.
|
62
|
-
campaign_request = {
|
63
|
-
:ad_group_estimate_requests => [ad_group_request],
|
64
|
-
# Set targeting criteria. Only locations and languages are supported.
|
65
|
-
:criteria => [
|
66
|
-
{:xsi_type => 'Location', :id => 2840}, # United States
|
67
|
-
{:xsi_type => 'Language', :id => 1000} # English
|
68
|
-
]
|
69
|
-
}
|
70
|
-
|
71
|
-
# Create a selector.
|
72
|
-
selector = {
|
73
|
-
:campaign_estimate_requests => [campaign_request],
|
74
|
-
# Optional: Request a list of campaign level estimates segmented by
|
75
|
-
# platform.
|
76
|
-
:platform_estimate_requested => true
|
77
|
-
}
|
78
|
-
|
79
|
-
# Execute the request.
|
80
|
-
response = traffic_estimator_srv.get(selector)
|
81
|
-
|
82
|
-
# Display traffic estimates.
|
83
|
-
if response and response[:campaign_estimates] and
|
84
|
-
response[:campaign_estimates].size > 0
|
85
|
-
campaign_estimate = response[:campaign_estimates].first
|
86
|
-
|
87
|
-
unless campaign_estimate[:platform_estimates].nil?
|
88
|
-
# Display the campaign level estimates segmented by platform.
|
89
|
-
campaign_estimate[:platform_estimates].each do |platform_estimate|
|
90
|
-
platform_message = ('Results for the platform with ID %d and name ' +
|
91
|
-
'"%s":') % [platform_estimate[:platform][:id],
|
92
|
-
platform_estimate[:platform][:platform_name]]
|
93
|
-
display_mean_estimates(
|
94
|
-
platform_message,
|
95
|
-
platform_estimate[:min_estimate],
|
96
|
-
platform_estimate[:max_estimate]
|
97
|
-
)
|
98
|
-
end
|
99
|
-
end
|
100
|
-
|
101
|
-
# Display the keyword estimates.
|
102
|
-
keyword_estimates =
|
103
|
-
campaign_estimate[:ad_group_estimates].first[:keyword_estimates]
|
104
|
-
keyword_estimates.each_with_index do |keyword_estimate, index|
|
105
|
-
next if keyword_requests[index][:is_negative]
|
106
|
-
keyword = keyword_requests[index][:keyword]
|
107
|
-
|
108
|
-
keyword_message = ('Results for the keyword with text "%s" and match ' +
|
109
|
-
'type "%s":') % [keyword[:text], keyword[:match_type]]
|
110
|
-
display_mean_estimates(
|
111
|
-
keyword_message,
|
112
|
-
keyword_estimate[:min],
|
113
|
-
keyword_estimate[:max]
|
114
|
-
)
|
115
|
-
end
|
116
|
-
else
|
117
|
-
puts 'No traffic estimates were returned.'
|
118
|
-
end
|
119
|
-
end
|
120
|
-
|
121
|
-
def display_mean_estimates(message, min_estimate, max_estimate)
|
122
|
-
mean_average_cpc = nil
|
123
|
-
unless min_estimate[:average_cpc].nil? || max_estimate[:average_cpc].nil?
|
124
|
-
mean_average_cpc = calculate_mean(
|
125
|
-
min_estimate[:average_cpc][:micro_amount],
|
126
|
-
max_estimate[:average_cpc][:micro_amount]
|
127
|
-
)
|
128
|
-
end
|
129
|
-
mean_average_position = calculate_mean(
|
130
|
-
min_estimate[:average_position],
|
131
|
-
max_estimate[:average_position]
|
132
|
-
)
|
133
|
-
mean_clicks = calculate_mean(
|
134
|
-
min_estimate[:clicks_per_day],
|
135
|
-
max_estimate[:clicks_per_day]
|
136
|
-
)
|
137
|
-
mean_total_cost = nil
|
138
|
-
unless min_estimate[:total_cost].nil? || max_estimate[:total_cost].nil?
|
139
|
-
mean_total_cost = calculate_mean(
|
140
|
-
min_estimate[:total_cost][:micro_amount],
|
141
|
-
max_estimate[:total_cost][:micro_amount]
|
142
|
-
)
|
143
|
-
end
|
144
|
-
|
145
|
-
puts message
|
146
|
-
puts "\tEstimated average CPC: %s" % format_mean(mean_average_cpc)
|
147
|
-
puts "\tEstimated ad position: %s" % format_mean(mean_average_position)
|
148
|
-
puts "\tEstimated daily clicks: %s" % format_mean(mean_clicks)
|
149
|
-
puts "\tEstimated daily cost: %s" % format_mean(mean_total_cost)
|
150
|
-
end
|
151
|
-
|
152
|
-
def format_mean(mean)
|
153
|
-
return "nil" if mean.nil?
|
154
|
-
return "%.2f" % (mean / 1000000)
|
155
|
-
end
|
156
|
-
|
157
|
-
def calculate_mean(min_money, max_money)
|
158
|
-
return nil if min_money.nil? || max_money.nil?
|
159
|
-
return (min_money.to_f + max_money.to_f) / 2.0
|
160
|
-
end
|
161
|
-
|
162
|
-
if __FILE__ == $0
|
163
|
-
API_VERSION = :v201609
|
164
|
-
|
165
|
-
begin
|
166
|
-
estimate_keyword_traffic()
|
167
|
-
|
168
|
-
# Authorization error.
|
169
|
-
rescue AdsCommon::Errors::OAuth2VerificationRequired => e
|
170
|
-
puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
|
171
|
-
"OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
|
172
|
-
"to retrieve and store OAuth2 tokens."
|
173
|
-
puts "See this wiki page for more details:\n\n " +
|
174
|
-
'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
|
175
|
-
|
176
|
-
# HTTP errors.
|
177
|
-
rescue AdsCommon::Errors::HttpError => e
|
178
|
-
puts "HTTP Error: %s" % e
|
179
|
-
|
180
|
-
# API errors.
|
181
|
-
rescue AdwordsApi::Errors::ApiException => e
|
182
|
-
puts "Message: %s" % e.message
|
183
|
-
puts 'Errors:'
|
184
|
-
e.errors.each_with_index do |error, index|
|
185
|
-
puts "\tError [%d]:" % (index + 1)
|
186
|
-
error.each do |field, value|
|
187
|
-
puts "\t\t%s: %s" % [field, value]
|
188
|
-
end
|
189
|
-
end
|
190
|
-
end
|
191
|
-
end
|
@@ -1,128 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
# Encoding: utf-8
|
3
|
-
#
|
4
|
-
# Copyright:: Copyright 2016, Google Inc. All Rights Reserved.
|
5
|
-
#
|
6
|
-
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
7
|
-
# you may not use this file except in compliance with the License.
|
8
|
-
# You may obtain a copy of the License at
|
9
|
-
#
|
10
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
11
|
-
#
|
12
|
-
# Unless required by applicable law or agreed to in writing, software
|
13
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
14
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
15
|
-
# implied.
|
16
|
-
# See the License for the specific language governing permissions and
|
17
|
-
# limitations under the License.
|
18
|
-
#
|
19
|
-
# This example gets all available campaign criterion bid modifier landscapes
|
20
|
-
# for a given campaign.
|
21
|
-
# To get campaigns, run basic_operations/get_campaigns.rb.
|
22
|
-
|
23
|
-
require 'adwords_api'
|
24
|
-
|
25
|
-
def get_campaign_criterion_bid_modifier_simulations(campaign_id)
|
26
|
-
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
27
|
-
# when called without parameters.
|
28
|
-
adwords = AdwordsApi::Api.new
|
29
|
-
|
30
|
-
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
31
|
-
# the configuration file or provide your own logger:
|
32
|
-
# adwords.logger = Logger.new('adwords_xml.log')
|
33
|
-
|
34
|
-
data_srv = adwords.service(:DataService, API_VERSION)
|
35
|
-
|
36
|
-
# Get all the campaigns for this account.
|
37
|
-
selector = {
|
38
|
-
:fields => [
|
39
|
-
'CampaignId',
|
40
|
-
'CriterionId',
|
41
|
-
'StartDate',
|
42
|
-
'EndDate',
|
43
|
-
'BidModifier',
|
44
|
-
'LocalClicks',
|
45
|
-
'LocalCost',
|
46
|
-
'LocalImpressions',
|
47
|
-
'TotalLocalImpressions',
|
48
|
-
'TotalLocalClicks',
|
49
|
-
'TotalLocalCost',
|
50
|
-
'RequiredBudget'
|
51
|
-
],
|
52
|
-
:paging => {
|
53
|
-
:start_index => 0,
|
54
|
-
:number_results => PAGE_SIZE
|
55
|
-
}
|
56
|
-
}
|
57
|
-
|
58
|
-
# Set initial values.
|
59
|
-
offset, page = 0, {}
|
60
|
-
|
61
|
-
begin
|
62
|
-
page = data_srv.get_campaign_criterion_bid_landscape(selector)
|
63
|
-
if page[:entries]
|
64
|
-
page[:entries].each do |bid_modifier_landscape|
|
65
|
-
puts ("Found campaign-level criterion bid modifier landscapes for " +
|
66
|
-
"criterion with id '%d', start date '%s', end date '%s', and " +
|
67
|
-
"landscape points:") % [
|
68
|
-
bid_modifier_landscape[:criterion_id],
|
69
|
-
bid_modifier_landscape[:start_date],
|
70
|
-
bid_modifier_landscape[:end_date]
|
71
|
-
]
|
72
|
-
bid_modifier_landscape[:landscape_points].each do |landscape_point|
|
73
|
-
puts (" bid modifier: %f => clicks: %d, cost: %d, impressions: %d" +
|
74
|
-
" total clicks: %d, total cost: %d, total impressions: %d" +
|
75
|
-
" and required budget: %f") % [
|
76
|
-
landscape_point[:bid_modifier],
|
77
|
-
landscape_point[:clicks],
|
78
|
-
landscape_point[:cost][:micro_amount],
|
79
|
-
landscape_point[:impressions],
|
80
|
-
landscape_point[:total_local_clicks],
|
81
|
-
landscape_point[:total_local_cost][:micro_amount],
|
82
|
-
landscape_point[:total_local_impressions],
|
83
|
-
landscape_point[:required_budget][:micro_amount]
|
84
|
-
]
|
85
|
-
end
|
86
|
-
puts
|
87
|
-
end
|
88
|
-
|
89
|
-
# Increment values to request the next page.
|
90
|
-
offset += PAGE_SIZE
|
91
|
-
selector[:paging][:start_index] = offset
|
92
|
-
end
|
93
|
-
end while page[:total_num_entries] > offset
|
94
|
-
end
|
95
|
-
|
96
|
-
if __FILE__ == $0
|
97
|
-
API_VERSION = :v201609
|
98
|
-
PAGE_SIZE = 500
|
99
|
-
|
100
|
-
begin
|
101
|
-
campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
|
102
|
-
|
103
|
-
get_campaign_criterion_bid_modifier_simulations(campaign_id)
|
104
|
-
|
105
|
-
# Authorization error.
|
106
|
-
rescue AdsCommon::Errors::OAuth2VerificationRequired => e
|
107
|
-
puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
|
108
|
-
"OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
|
109
|
-
"to retrieve and store OAuth2 tokens."
|
110
|
-
puts "See this wiki page for more details:\n\n " +
|
111
|
-
'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
|
112
|
-
|
113
|
-
# HTTP errors.
|
114
|
-
rescue AdsCommon::Errors::HttpError => e
|
115
|
-
puts "HTTP Error: %s" % e
|
116
|
-
|
117
|
-
# API errors.
|
118
|
-
rescue AdwordsApi::Errors::ApiException => e
|
119
|
-
puts "Message: %s" % e.message
|
120
|
-
puts 'Errors:'
|
121
|
-
e.errors.each_with_index do |error, index|
|
122
|
-
puts "\tError [%d]:" % (index + 1)
|
123
|
-
error.each do |field, value|
|
124
|
-
puts "\t\t%s: %s" % [field, value]
|
125
|
-
end
|
126
|
-
end
|
127
|
-
end
|
128
|
-
end
|
@@ -1,95 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
# Encoding: utf-8
|
3
|
-
#
|
4
|
-
# Copyright:: Copyright 2011, Google Inc. All Rights Reserved.
|
5
|
-
#
|
6
|
-
# License:: Licensed under the Apache License, Version 2.0 (the "License");
|
7
|
-
# you may not use this file except in compliance with the License.
|
8
|
-
# You may obtain a copy of the License at
|
9
|
-
#
|
10
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
11
|
-
#
|
12
|
-
# Unless required by applicable law or agreed to in writing, software
|
13
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
14
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
15
|
-
# implied.
|
16
|
-
# See the License for the specific language governing permissions and
|
17
|
-
# limitations under the License.
|
18
|
-
#
|
19
|
-
# This example gets bid landscapes for a keyword. To get keywords, run
|
20
|
-
# get_keywords.rb.
|
21
|
-
|
22
|
-
require 'adwords_api'
|
23
|
-
|
24
|
-
def get_criterion_bid_landscapes(ad_group_id, keyword_id)
|
25
|
-
# AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
|
26
|
-
# when called without parameters.
|
27
|
-
adwords = AdwordsApi::Api.new
|
28
|
-
|
29
|
-
# To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
|
30
|
-
# the configuration file or provide your own logger:
|
31
|
-
# adwords.logger = Logger.new('adwords_xml.log')
|
32
|
-
|
33
|
-
data_srv = adwords.service(:DataService, API_VERSION)
|
34
|
-
|
35
|
-
# Get keyword bid landscape.
|
36
|
-
selector = {
|
37
|
-
:fields => ['AdGroupId', 'CriterionId', 'StartDate', 'EndDate', 'Bid',
|
38
|
-
'LocalClicks', 'LocalCost', 'LocalImpressions'],
|
39
|
-
:predicates => [
|
40
|
-
{:field => 'AdGroupId', :operator => 'IN', :values => [ad_group_id]},
|
41
|
-
{:field => 'CriterionId', :operator => 'IN', :values => [keyword_id]},
|
42
|
-
]
|
43
|
-
}
|
44
|
-
page = data_srv.get_criterion_bid_landscape(selector)
|
45
|
-
if page and page[:entries]
|
46
|
-
puts "Bid landscape(s) retrieved: %d." % [page[:entries].length]
|
47
|
-
page[:entries].each do |bid_landscape|
|
48
|
-
puts ("Retrieved keyword bid landscape with ad group ID %d" +
|
49
|
-
", keyword ID %d, start date '%s', end date '%s'" +
|
50
|
-
", with landscape points:") %
|
51
|
-
[bid_landscape[:ad_group_id], bid_landscape[:criterion_id],
|
52
|
-
bid_landscape[:start_date], bid_landscape[:end_date]]
|
53
|
-
bid_landscape[:landscape_points].each do |point|
|
54
|
-
puts "\t%d => clicks: %d, cost: %d, impressions: %d" %
|
55
|
-
[point[:bid][:micro_amount], point.clicks,
|
56
|
-
point[:cost][:micro_amount], point[:impressions]]
|
57
|
-
end
|
58
|
-
end
|
59
|
-
else
|
60
|
-
puts 'No bid landscapes retrieved.'
|
61
|
-
end
|
62
|
-
end
|
63
|
-
|
64
|
-
if __FILE__ == $0
|
65
|
-
API_VERSION = :v201609
|
66
|
-
|
67
|
-
begin
|
68
|
-
ad_group_id = 'INSERT_ADGROUP_ID_HERE'.to_i
|
69
|
-
keyword_id = 'INSERT_KEYWORD_ID_HERE'.to_i
|
70
|
-
get_criterion_bid_landscapes(ad_group_id, keyword_id)
|
71
|
-
|
72
|
-
# Authorization error.
|
73
|
-
rescue AdsCommon::Errors::OAuth2VerificationRequired => e
|
74
|
-
puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
|
75
|
-
"OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
|
76
|
-
"to retrieve and store OAuth2 tokens."
|
77
|
-
puts "See this wiki page for more details:\n\n " +
|
78
|
-
'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
|
79
|
-
|
80
|
-
# HTTP errors.
|
81
|
-
rescue AdsCommon::Errors::HttpError => e
|
82
|
-
puts "HTTP Error: %s" % e
|
83
|
-
|
84
|
-
# API errors.
|
85
|
-
rescue AdwordsApi::Errors::ApiException => e
|
86
|
-
puts "Message: %s" % e.message
|
87
|
-
puts 'Errors:'
|
88
|
-
e.errors.each_with_index do |error, index|
|
89
|
-
puts "\tError [%d]:" % (index + 1)
|
90
|
-
error.each do |field, value|
|
91
|
-
puts "\t\t%s: %s" % [field, value]
|
92
|
-
end
|
93
|
-
end
|
94
|
-
end
|
95
|
-
end
|