> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/AdService/MutateAds).

<button default="" value="grpc">gRPC</button> <button value="rest">REST</button>

| ### 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](https://developers.google.com/google-ads/api/reference/rpc/v23/AdCustomizerErrorEnum.AdCustomizerError.md.txt) [AdError](https://developers.google.com/google-ads/api/reference/rpc/v23/AdErrorEnum.AdError.md.txt) [AdSharingError](https://developers.google.com/google-ads/api/reference/rpc/v23/AdSharingErrorEnum.AdSharingError.md.txt) [AdxError](https://developers.google.com/google-ads/api/reference/rpc/v23/AdxErrorEnum.AdxError.md.txt) [AssetError](https://developers.google.com/google-ads/api/reference/rpc/v23/AssetErrorEnum.AssetError.md.txt) [AssetLinkError](https://developers.google.com/google-ads/api/reference/rpc/v23/AssetLinkErrorEnum.AssetLinkError.md.txt) [AuthenticationError](https://developers.google.com/google-ads/api/reference/rpc/v23/AuthenticationErrorEnum.AuthenticationError.md.txt) [AuthorizationError](https://developers.google.com/google-ads/api/reference/rpc/v23/AuthorizationErrorEnum.AuthorizationError.md.txt) [CollectionSizeError](https://developers.google.com/google-ads/api/reference/rpc/v23/CollectionSizeErrorEnum.CollectionSizeError.md.txt) [DatabaseError](https://developers.google.com/google-ads/api/reference/rpc/v23/DatabaseErrorEnum.DatabaseError.md.txt) [DateError](https://developers.google.com/google-ads/api/reference/rpc/v23/DateErrorEnum.DateError.md.txt) [DistinctError](https://developers.google.com/google-ads/api/reference/rpc/v23/DistinctErrorEnum.DistinctError.md.txt) [FeedAttributeReferenceError](https://developers.google.com/google-ads/api/reference/rpc/v23/FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError.md.txt) [FieldError](https://developers.google.com/google-ads/api/reference/rpc/v23/FieldErrorEnum.FieldError.md.txt) [FieldMaskError](https://developers.google.com/google-ads/api/reference/rpc/v23/FieldMaskErrorEnum.FieldMaskError.md.txt) [FunctionError](https://developers.google.com/google-ads/api/reference/rpc/v23/FunctionErrorEnum.FunctionError.md.txt) [FunctionParsingError](https://developers.google.com/google-ads/api/reference/rpc/v23/FunctionParsingErrorEnum.FunctionParsingError.md.txt) [HeaderError](https://developers.google.com/google-ads/api/reference/rpc/v23/HeaderErrorEnum.HeaderError.md.txt) [IdError](https://developers.google.com/google-ads/api/reference/rpc/v23/IdErrorEnum.IdError.md.txt) [ImageError](https://developers.google.com/google-ads/api/reference/rpc/v23/ImageErrorEnum.ImageError.md.txt) [InternalError](https://developers.google.com/google-ads/api/reference/rpc/v23/InternalErrorEnum.InternalError.md.txt) [ListOperationError](https://developers.google.com/google-ads/api/reference/rpc/v23/ListOperationErrorEnum.ListOperationError.md.txt) [MediaBundleError](https://developers.google.com/google-ads/api/reference/rpc/v23/MediaBundleErrorEnum.MediaBundleError.md.txt) [MediaFileError](https://developers.google.com/google-ads/api/reference/rpc/v23/MediaFileErrorEnum.MediaFileError.md.txt) [MutateError](https://developers.google.com/google-ads/api/reference/rpc/v23/MutateErrorEnum.MutateError.md.txt) [NewResourceCreationError](https://developers.google.com/google-ads/api/reference/rpc/v23/NewResourceCreationErrorEnum.NewResourceCreationError.md.txt) [NotEmptyError](https://developers.google.com/google-ads/api/reference/rpc/v23/NotEmptyErrorEnum.NotEmptyError.md.txt) [NullError](https://developers.google.com/google-ads/api/reference/rpc/v23/NullErrorEnum.NullError.md.txt) [OperatorError](https://developers.google.com/google-ads/api/reference/rpc/v23/OperatorErrorEnum.OperatorError.md.txt) [PolicyFindingError](https://developers.google.com/google-ads/api/reference/rpc/v23/PolicyFindingErrorEnum.PolicyFindingError.md.txt) [PolicyViolationError](https://developers.google.com/google-ads/api/reference/rpc/v23/PolicyViolationErrorEnum.PolicyViolationError.md.txt) [QuotaError](https://developers.google.com/google-ads/api/reference/rpc/v23/QuotaErrorEnum.QuotaError.md.txt) [RangeError](https://developers.google.com/google-ads/api/reference/rpc/v23/RangeErrorEnum.RangeError.md.txt) [RequestError](https://developers.google.com/google-ads/api/reference/rpc/v23/RequestErrorEnum.RequestError.md.txt) [SizeLimitError](https://developers.google.com/google-ads/api/reference/rpc/v23/SizeLimitErrorEnum.SizeLimitError.md.txt) [StringFormatError](https://developers.google.com/google-ads/api/reference/rpc/v23/StringFormatErrorEnum.StringFormatError.md.txt) [StringLengthError](https://developers.google.com/google-ads/api/reference/rpc/v23/StringLengthErrorEnum.StringLengthError.md.txt) [UrlFieldError](https://developers.google.com/google-ads/api/reference/rpc/v23/UrlFieldErrorEnum.UrlFieldError.md.txt) [Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/services/ad_service.proto) |

Authorization scopes

:   Requires the following OAuth scope:

    - `https://www.googleapis.com/auth/adwords`

    For more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).