Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

type AdGroupEstimateRequest (v201809)

Represents an ad group that will be estimated. Ad groups may be all new or all existing, or a mixture of new and existing. Only existing campaigns can contain estimates for existing ad groups.

To make a keyword estimates request in which estimates do not consider existing account information (e.g. historical ad group performance), set both adGroupId and the enclosing CampaignEstimateRequest's campaignId to null.

For more details on usage, refer to document at CampaignEstimateRequest.



EstimateRequest (inherited)



Indicates that this instance is a subtype of EstimateRequest. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.




The adGroupId for an ad group that belongs to the containing campaign from CampaignEstimateRequest or null.

For usage, refer to document from CampaignEstimateRequest.



The keywords to estimate.

This field must contain distinct elements.
This field must not contain null elements.
This field is required and should not be null.



The max CPC bid to use for estimates for this ad group.

This value overrides the max CPC of AdGroup specified by adGroupId.