My favorites | English | Sign in

AdWords API v2009

v2009 Docs | v13 Docs

AdGroupAdService

Service for managing AdGroupAd entities. AdGroupAds maintain the relationships between AdGroups and Ads.

Namespace

  • https://adwords.google.com/api/adwords/cm/v200909

Operations

get

Returns a list of AdGroupAds based on an AdGroupAdSelector. The selector defines a specific set of AdGroupAds that are to be returned - an AdGroupAd must pass all the filters specified in the argument AdGroupAdSelector.

Parameters

Field Type Description
selector AdGroupAdSelector the selector specifying the query

Response

Field Type Description
rval AdGroupAdPage the AdGroupAds specified

mutate

Applies the list of mutate operations (ie. add, set, remove): Add - Creates a set of AdGroupAd entities, each effectively linking an AdGroup and an Ad. The adGroupId of each AdGroupAd must be that of an existing AdGroup. The Ad may either specify an existing Ad in the account library by id or be sufficiently specified for a new Ad to be created and added to the account library. Set - Updates a set of AdGroupAd entities. Except for status, AdGroupAd fields are not mutable. Status updates are straightforward - the status of the AdGroupAd is updated as specified. Remove - Removes the link between the specified AdGroup and Ad.

Parameters

Field Type Description
operations AdGroupAdOperation[] the operations to apply

Response

Field Type Description
rval AdGroupAdReturnValue a list of AdGroupAds where each entry in the list is the result of applying the operation in the input list with the same index. For an add/set operation, the return AdGroupAd will be what is saved to the db. In the case, of the remove operation, the return AdGroupAd will simply be an AdGroupAd containing an Ad with the id set to the Ad being deleted from the AdGroup.