AdGroupRequest (AdWords API Developer's Guide)

Note: JavaScript must be enabled for you to properly view versions. It seems JavaScript is either disabled or is not supported by your browser, which causes all versions of text to be simultaneously displayed. Enable JavaScript in your browser options, then try again.

Skip to main content Skip to main menu

Introduction
Release Notes
Web Services
Sandbox
API Reference

Close all submenus

Open all submenus
- AccountService
  - AccountInfo
    - Address
    - EmailPromotions
      Preferences
- AdGroupService
  - AdGroup
- AdService
  - Business
  - CommerceAd sandbox
  - ImageAd
    - Image
  - LocalBusinessAd
  - MobileAd
  - TextAd
  - VideoAd
    - Video
- CampaignService
  - Campaign
    - AdSchedule
      - SchedulingInterval
    - BudgetOptimizerSettings
    - ConversionOptimizer Settings +V12
    - GeoTarget
      - CityTargets +V10
      - CountryTargets +V10
      - MetroTargets +V10
      - RegionTargets +V10
      - ProximityTargets +V10
        
        Circle +v10
    - LanguageTarget
    - NetworkTarget
  - ConversionOptimizer Eligibility +V12
- CriterionService
  - Keyword
  - Website
- InfoService
  - ClientUsageRecord
- KeywordToolService
- ReportService
  - DefinedReportJob +V11
  - AccountReportJob −V11
  - AdImageReportJob −V11
  - AdGroupReportJob −V11
  - AdTextReportJob −V11
  - CampaignReportJob −V11
  - CustomReportJob −V11
  - KeywordReportJob −V11
  - UrlReportJob −V11
- SiteSuggestionService +V10
  - DemographicsTarget +V10
  - Language GeoTargeting +V10
  - SiteSuggestion +V10
- TrafficEstimatorService
  - CampaignEstimate
    - AdGroupEstimate
      - KeywordEstimate
  - CampaignRequest
    - AdGroupRequest
      - KeywordRequest
- General Data Types
  - StatsRecord
- Exception Types
  - ApiError
  - ApiException
International Codes
Report Rules +V11
- Account +V11
- Account Structure +V11
- Ad +V11
- Ad Group +V11
- Campaign +V11
- Placement +V11
- Placement / Keyword +V11
- Reach and Frequency +V11
- Url +V11
Error Codes
API Rate Sheet
Index

AdWords API Resources

Developer Forum

AdWords API Blog

AdGroupRequest

Represents an ad group whose keywords are to be estimated.

To get traffic estimates for keywords in one or more ad groups, create an AdGroupRequest object for each ad group whose keywords are to be estimated. See TrafficEstimatorService for details of how to submit the request for estimation.

The results of the estimation are returned as AdGroupEstimate objects which each contain KeywordEstimate objects.

Fields

id
keywordRequests
maxCpc

Field name	Field type	Field description
`id`	`int`	The id of the ad group to be estimated. All keywords in the ad group will be estimated. Optional - if omitted indicates a new ad group.
`keywordRequests`	`KeywordRequest[]`	The keywords to be estimated. This list must contain at least one `KeywordRequest`. If this is a new ad group, all `KeywordRequest` instances must represent new keywords (that is, the id of each `KeywordRequest` must be unspecified.) If this is an existing ad group, the `KeywordRequest`s can be for new keywords or for keywords that already exist in the ad group.
`maxCpc`	`long`	The bid for this ad group in micros. See Monetary Units for information about micros. The maxCpc for the AdGroupRequest is required unless an existing ad group id has been specified. The rules determining which value of maxCpc the TrafficEstimatorService uses in the estimation calculation are (in order of preference): maxCpc on the KeywordRequest is used, if any maxCpc on the existing keyword is used, if any maxCpc on the AdGroupRequest is used, if any maxCpc on the existing AdGroup is used as the last resort