Learn more about migrating to the Google Ads API by watching our latest webinar

AdService

Service to manage ads.

GetAd

rpc GetAd(GetAdRequest) returns (Ad)

Returns the requested ad in full detail.

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAds

rpc MutateAds(MutateAdsRequest) returns (MutateAdsResponse)

Updates ads. Operation statuses are returned. Updating ads is not supported for TextAd, ExpandedDynamicSearchAd, GmailAd and ImageAd.

List of thrown errors: AdCustomizerError AdError AdSharingError AdxError AssetError AssetLinkError AuthenticationError AuthorizationError CollectionSizeError DatabaseError DateError DistinctError FeedAttributeReferenceError FieldError FieldMaskError FunctionError FunctionParsingError HeaderError IdError ImageError InternalError ListOperationError MediaBundleError MediaFileError MutateError NewResourceCreationError NotEmptyError NullError OperatorError PolicyFindingError PolicyViolationError QuotaError RangeError RequestError SizeLimitError StringFormatError StringLengthError UrlFieldError

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.