Module: AdwordsApi::ApiConfig

Extended by:
AdsCommon::ApiConfig
Defined in:
lib/adwords_api/api_config.rb,
lib/adwords_api/version.rb

Overview

Contains helper methods for loading and managing the available services.

Constant Summary collapse

CLIENT_LIB_VERSION = 
'0.20.0'
DEFAULT_VERSION =

Set defaults

:v201605
DEFAULT_ENVIRONMENT = 
:PRODUCTION
LATEST_VERSION = 
:v201605
API_NAME =

Set other constants

'AdwordsApi'
DEFAULT_CONFIG_FILENAME = 
'adwords_api.yml'
@@service_config =

Configure the services available to each version

{
  :v201601 => [
      :AccountLabelService,
      :AdCustomizerFeedService,
      :AdGroupAdService,
      :AdGroupBidModifierService,
      :AdGroupCriterionService,
      :AdGroupExtensionSettingService,
      :AdGroupFeedService,
      :AdGroupService,
      :AdParamService,
      :AdwordsUserListService,
      :BatchJobService,
      :BiddingStrategyService,
      :BudgetOrderService,
      :BudgetService,
      :CampaignCriterionService,
      :CampaignExtensionSettingService,
      :CampaignFeedService,
      :CampaignService,
      :CampaignSharedSetService,
      :ConstantDataService,
      :ConversionTrackerService,
      :CustomerExtensionSettingService,
      :CustomerFeedService,
      :CustomerService,
      :CustomerSyncService,
      :DataService,
      :ExperimentService,
      :FeedItemService,
      :FeedMappingService,
      :FeedService,
      :LabelService,
      :LocationCriterionService,
      :ManagedCustomerService,
      :MediaService,
      :MutateJobService,
      :OfflineConversionFeedService,
      :ReportDefinitionService,
      :SharedCriterionService,
      :SharedSetService,
      :TargetingIdeaService,
      :TrafficEstimatorService
  ],
  :v201603 => [
      :AccountLabelService,
      :AdCustomizerFeedService,
      :AdGroupAdService,
      :AdGroupBidModifierService,
      :AdGroupCriterionService,
      :AdGroupExtensionSettingService,
      :AdGroupFeedService,
      :AdGroupService,
      :AdParamService,
      :AdwordsUserListService,
      :BatchJobService,
      :BiddingStrategyService,
      :BudgetOrderService,
      :BudgetService,
      :CampaignCriterionService,
      :CampaignExtensionSettingService,
      :CampaignFeedService,
      :CampaignService,
      :CampaignSharedSetService,
      :ConstantDataService,
      :ConversionTrackerService,
      :CustomerExtensionSettingService,
      :CustomerFeedService,
      :CustomerService,
      :CustomerSyncService,
      :DataService,
      :DraftService,
      :DraftAsyncErrorService,
      :ExperimentService,
      :FeedItemService,
      :FeedMappingService,
      :FeedService,
      :LabelService,
      :LocationCriterionService,
      :ManagedCustomerService,
      :MediaService,
      :OfflineConversionFeedService,
      :ReportDefinitionService,
      :SharedCriterionService,
      :SharedSetService,
      :TargetingIdeaService,
      :TrafficEstimatorService,
      :TrialService,
      :TrialAsyncErrorService
  ],
  :v201605 => [
      :AccountLabelService,
      :AdCustomizerFeedService,
      :AdGroupAdService,
      :AdGroupBidModifierService,
      :AdGroupCriterionService,
      :AdGroupExtensionSettingService,
      :AdGroupFeedService,
      :AdGroupService,
      :AdParamService,
      :AdwordsUserListService,
      :BatchJobService,
      :BiddingStrategyService,
      :BudgetOrderService,
      :BudgetService,
      :CampaignCriterionService,
      :CampaignExtensionSettingService,
      :CampaignFeedService,
      :CampaignService,
      :CampaignSharedSetService,
      :ConstantDataService,
      :ConversionTrackerService,
      :CustomerExtensionSettingService,
      :CustomerFeedService,
      :CustomerService,
      :CustomerSyncService,
      :DataService,
      :DraftService,
      :DraftAsyncErrorService,
      :ExperimentService,
      :FeedItemService,
      :FeedMappingService,
      :FeedService,
      :LabelService,
      :LocationCriterionService,
      :ManagedCustomerService,
      :MediaService,
      :OfflineConversionFeedService,
      :ReportDefinitionService,
      :SharedCriterionService,
      :SharedSetService,
      :TargetingIdeaService,
      :TrafficEstimatorService,
      :TrialService,
      :TrialAsyncErrorService
  ]
}
@@environment_config =

Configure the different environments, with the base URL for each one

{
  :PRODUCTION => {
    :oauth_scope => 'https://www.googleapis.com/auth/adwords',
    :header_ns => 'https://adwords.google.com/api/adwords/cm/',
    :v201601 => 'https://adwords.google.com/api/adwords/',
    :v201603 => 'https://adwords.google.com/api/adwords/',
    :v201605 => 'https://adwords.google.com/api/adwords/'
  }
}
@@subdir_config =

Configure the subdirectories for each version / service pair. A missing pair means that only the base URL is used.

{
  # v201601
  [:v201601, :AccountLabelService] => 'mcm/',
  [:v201601, :AdCustomizerFeedService] => 'cm/',
  [:v201601, :AdGroupAdService] => 'cm/',
  [:v201601, :AdGroupBidModifierService] => 'cm/',
  [:v201601, :AdGroupCriterionService] => 'cm/',
  [:v201601, :AdGroupExtensionSettingService] => 'cm/',
  [:v201601, :AdGroupFeedService] => 'cm/',
  [:v201601, :AdGroupService] => 'cm/',
  [:v201601, :AdParamService] => 'cm/',
  [:v201601, :BatchJobService] => 'cm/',
  [:v201601, :BudgetOrderService] => 'billing/',
  [:v201601, :CampaignCriterionService] => 'cm/',
  [:v201601, :CampaignExtensionSettingService] => 'cm/',
  [:v201601, :CampaignFeedService] => 'cm/',
  [:v201601, :CampaignService] => 'cm/',
  [:v201601, :CampaignSharedSetService] => 'cm/',
  [:v201601, :ConstantDataService] => 'cm/',
  [:v201601, :ConversionTrackerService] => 'cm/',
  [:v201601, :CustomerExtensionSettingService] => 'cm/',
  [:v201601, :CustomerSyncService] => 'ch/',
  [:v201601, :DataService] => 'cm/',
  [:v201601, :ExperimentService] => 'cm/',
  [:v201601, :FeedItemService] => 'cm/',
  [:v201601, :FeedMappingService] => 'cm/',
  [:v201601, :FeedService] => 'cm/',
  [:v201601, :LocationCriterionService] => 'cm/',
  [:v201601, :MediaService] => 'cm/',
  [:v201601, :MutateJobService] => 'cm/',
  [:v201601, :OfflineConversionFeedService] => 'cm/',
  [:v201601, :ReportDefinitionService] => 'cm/',
  [:v201601, :SharedCriterionService] => 'cm/',
  [:v201601, :SharedSetService] => 'cm/',
  [:v201601, :TargetingIdeaService] => 'o/',
  [:v201601, :TrafficEstimatorService] => 'o/',
  [:v201601, :ManagedCustomerService] => 'mcm/',
  [:v201601, :CustomerService] => 'mcm/',
  [:v201601, :CustomerFeedService] => 'cm/',
  [:v201601, :BudgetService] => 'cm/',
  [:v201601, :BiddingStrategyService] => 'cm/',
  [:v201601, :AdwordsUserListService] => 'rm/',
  [:v201601, :LabelService] => 'cm/',
  # v201603
  [:v201603, :AccountLabelService] => 'mcm/',
  [:v201603, :AdCustomizerFeedService] => 'cm/',
  [:v201603, :AdGroupAdService] => 'cm/',
  [:v201603, :AdGroupBidModifierService] => 'cm/',
  [:v201603, :AdGroupCriterionService] => 'cm/',
  [:v201603, :AdGroupExtensionSettingService] => 'cm/',
  [:v201603, :AdGroupFeedService] => 'cm/',
  [:v201603, :AdGroupService] => 'cm/',
  [:v201603, :AdParamService] => 'cm/',
  [:v201603, :BatchJobService] => 'cm/',
  [:v201603, :BudgetOrderService] => 'billing/',
  [:v201603, :CampaignCriterionService] => 'cm/',
  [:v201603, :CampaignExtensionSettingService] => 'cm/',
  [:v201603, :CampaignFeedService] => 'cm/',
  [:v201603, :CampaignService] => 'cm/',
  [:v201603, :CampaignSharedSetService] => 'cm/',
  [:v201603, :ConstantDataService] => 'cm/',
  [:v201603, :ConversionTrackerService] => 'cm/',
  [:v201603, :CustomerExtensionSettingService] => 'cm/',
  [:v201603, :CustomerSyncService] => 'ch/',
  [:v201603, :DataService] => 'cm/',
  [:v201603, :ExperimentService] => 'cm/',
  [:v201603, :FeedItemService] => 'cm/',
  [:v201603, :FeedMappingService] => 'cm/',
  [:v201603, :FeedService] => 'cm/',
  [:v201603, :LocationCriterionService] => 'cm/',
  [:v201603, :MediaService] => 'cm/',
  [:v201603, :OfflineConversionFeedService] => 'cm/',
  [:v201603, :ReportDefinitionService] => 'cm/',
  [:v201603, :SharedCriterionService] => 'cm/',
  [:v201603, :SharedSetService] => 'cm/',
  [:v201603, :TargetingIdeaService] => 'o/',
  [:v201603, :TrafficEstimatorService] => 'o/',
  [:v201603, :ManagedCustomerService] => 'mcm/',
  [:v201603, :CustomerService] => 'mcm/',
  [:v201603, :CustomerFeedService] => 'cm/',
  [:v201603, :BudgetService] => 'cm/',
  [:v201603, :BiddingStrategyService] => 'cm/',
  [:v201603, :AdwordsUserListService] => 'rm/',
  [:v201603, :LabelService] => 'cm/',
  [:v201603, :DraftService] => 'cm/',
  [:v201603, :DraftAsyncErrorService] => 'cm/',
  [:v201603, :TrialService] => 'cm/',
  [:v201603, :TrialAsyncErrorService] => 'cm/',
  # v201605
  [:v201605, :AccountLabelService] => 'mcm/',
  [:v201605, :AdCustomizerFeedService] => 'cm/',
  [:v201605, :AdGroupAdService] => 'cm/',
  [:v201605, :AdGroupBidModifierService] => 'cm/',
  [:v201605, :AdGroupCriterionService] => 'cm/',
  [:v201605, :AdGroupExtensionSettingService] => 'cm/',
  [:v201605, :AdGroupFeedService] => 'cm/',
  [:v201605, :AdGroupService] => 'cm/',
  [:v201605, :AdParamService] => 'cm/',
  [:v201605, :BatchJobService] => 'cm/',
  [:v201605, :BudgetOrderService] => 'billing/',
  [:v201605, :CampaignCriterionService] => 'cm/',
  [:v201605, :CampaignExtensionSettingService] => 'cm/',
  [:v201605, :CampaignFeedService] => 'cm/',
  [:v201605, :CampaignService] => 'cm/',
  [:v201605, :CampaignSharedSetService] => 'cm/',
  [:v201605, :ConstantDataService] => 'cm/',
  [:v201605, :ConversionTrackerService] => 'cm/',
  [:v201605, :CustomerExtensionSettingService] => 'cm/',
  [:v201605, :CustomerSyncService] => 'ch/',
  [:v201605, :DataService] => 'cm/',
  [:v201605, :ExperimentService] => 'cm/',
  [:v201605, :FeedItemService] => 'cm/',
  [:v201605, :FeedMappingService] => 'cm/',
  [:v201605, :FeedService] => 'cm/',
  [:v201605, :LocationCriterionService] => 'cm/',
  [:v201605, :MediaService] => 'cm/',
  [:v201605, :OfflineConversionFeedService] => 'cm/',
  [:v201605, :ReportDefinitionService] => 'cm/',
  [:v201605, :SharedCriterionService] => 'cm/',
  [:v201605, :SharedSetService] => 'cm/',
  [:v201605, :TargetingIdeaService] => 'o/',
  [:v201605, :TrafficEstimatorService] => 'o/',
  [:v201605, :ManagedCustomerService] => 'mcm/',
  [:v201605, :CustomerService] => 'mcm/',
  [:v201605, :CustomerFeedService] => 'cm/',
  [:v201605, :BudgetService] => 'cm/',
  [:v201605, :BiddingStrategyService] => 'cm/',
  [:v201605, :AdwordsUserListService] => 'rm/',
  [:v201605, :LabelService] => 'cm/',
  [:v201605, :DraftService] => 'cm/',
  [:v201605, :DraftAsyncErrorService] => 'cm/',
  [:v201605, :TrialService] => 'cm/',
  [:v201605, :TrialAsyncErrorService] => 'cm/'
}

Class Method Summary collapse

Class Method Details

.adhoc_report_download_url(environment, version) ⇒ Object

Get the download URL for Ad Hoc reports.

Args:

  • environment: the service environment to be used

  • version: the API version (as a symbol)

Returns:

  • The endpoint URL (as a string)



380
381
382
383
384
385
386
 
# File 'lib/adwords_api/api_config.rb', line 380

def self.adhoc_report_download_url(environment, version)
  base = get_wsdl_base(environment, version)
  if base
    base += 'reportdownload/%s' % version.to_s
  end
  return base
end

.api_name ⇒ Object 



346
347
348
 
# File 'lib/adwords_api/api_config.rb', line 346

def self.api_name
  API_NAME
end

.default_config_filename ⇒ Object 



363
364
365
 
# File 'lib/adwords_api/api_config.rb', line 363

def self.default_config_filename
  DEFAULT_CONFIG_FILENAME
end

.default_environment ⇒ Object 



338
339
340
 
# File 'lib/adwords_api/api_config.rb', line 338

def self.default_environment
  DEFAULT_ENVIRONMENT
end

.default_version ⇒ Object

Getters for constants and module variables.



334
335
336
 
# File 'lib/adwords_api/api_config.rb', line 334

def self.default_version
  DEFAULT_VERSION
end

.environment_config(environment, key) ⇒ Object 



354
355
356
357
 
# File 'lib/adwords_api/api_config.rb', line 354

def self.environment_config(environment, key)
  return @@environment_config.include?(environment) ?
      @@environment_config[environment][key] : nil
end

.headers_config ⇒ Object 



367
368
369
 
# File 'lib/adwords_api/api_config.rb', line 367

def self.headers_config
  @@headers_config
end

.latest_version ⇒ Object 



342
343
344
 
# File 'lib/adwords_api/api_config.rb', line 342

def self.latest_version
  LATEST_VERSION
end

.service_config ⇒ Object 



350
351
352
 
# File 'lib/adwords_api/api_config.rb', line 350

def self.service_config
  @@service_config
end

.subdir_config ⇒ Object 



359
360
361
 
# File 'lib/adwords_api/api_config.rb', line 359

def self.subdir_config
  @@subdir_config
end