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

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

| ### MutateAdGroupAds |
|---|
| `` rpc MutateAdGroupAds(`MutateAdGroupAdsRequest`) returns (`MutateAdGroupAdsResponse`) `` Creates, updates, or removes ads. Operation statuses are returned. List of thrown errors: [AdCustomizerError](https://developers.google.com/google-ads/api/reference/rpc/v25/AdCustomizerErrorEnum.AdCustomizerError.md.txt) [AdError](https://developers.google.com/google-ads/api/reference/rpc/v25/AdErrorEnum.AdError.md.txt) [AdGroupAdError](https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroupAdErrorEnum.AdGroupAdError.md.txt) [AdSharingError](https://developers.google.com/google-ads/api/reference/rpc/v25/AdSharingErrorEnum.AdSharingError.md.txt) [AdxError](https://developers.google.com/google-ads/api/reference/rpc/v25/AdxErrorEnum.AdxError.md.txt) [AssetError](https://developers.google.com/google-ads/api/reference/rpc/v25/AssetErrorEnum.AssetError.md.txt) [AssetLinkError](https://developers.google.com/google-ads/api/reference/rpc/v25/AssetLinkErrorEnum.AssetLinkError.md.txt) [AuthenticationError](https://developers.google.com/google-ads/api/reference/rpc/v25/AuthenticationErrorEnum.AuthenticationError.md.txt) [AuthorizationError](https://developers.google.com/google-ads/api/reference/rpc/v25/AuthorizationErrorEnum.AuthorizationError.md.txt) [CollectionSizeError](https://developers.google.com/google-ads/api/reference/rpc/v25/CollectionSizeErrorEnum.CollectionSizeError.md.txt) [ContextError](https://developers.google.com/google-ads/api/reference/rpc/v25/ContextErrorEnum.ContextError.md.txt) [DatabaseError](https://developers.google.com/google-ads/api/reference/rpc/v25/DatabaseErrorEnum.DatabaseError.md.txt) [DateError](https://developers.google.com/google-ads/api/reference/rpc/v25/DateErrorEnum.DateError.md.txt) [DistinctError](https://developers.google.com/google-ads/api/reference/rpc/v25/DistinctErrorEnum.DistinctError.md.txt) [FeedAttributeReferenceError](https://developers.google.com/google-ads/api/reference/rpc/v25/FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError.md.txt) [FieldError](https://developers.google.com/google-ads/api/reference/rpc/v25/FieldErrorEnum.FieldError.md.txt) [FieldMaskError](https://developers.google.com/google-ads/api/reference/rpc/v25/FieldMaskErrorEnum.FieldMaskError.md.txt) [FunctionError](https://developers.google.com/google-ads/api/reference/rpc/v25/FunctionErrorEnum.FunctionError.md.txt) [FunctionParsingError](https://developers.google.com/google-ads/api/reference/rpc/v25/FunctionParsingErrorEnum.FunctionParsingError.md.txt) [HeaderError](https://developers.google.com/google-ads/api/reference/rpc/v25/HeaderErrorEnum.HeaderError.md.txt) [IdError](https://developers.google.com/google-ads/api/reference/rpc/v25/IdErrorEnum.IdError.md.txt) [ImageError](https://developers.google.com/google-ads/api/reference/rpc/v25/ImageErrorEnum.ImageError.md.txt) [InternalError](https://developers.google.com/google-ads/api/reference/rpc/v25/InternalErrorEnum.InternalError.md.txt) [ListOperationError](https://developers.google.com/google-ads/api/reference/rpc/v25/ListOperationErrorEnum.ListOperationError.md.txt) [MediaBundleError](https://developers.google.com/google-ads/api/reference/rpc/v25/MediaBundleErrorEnum.MediaBundleError.md.txt) [MediaFileError](https://developers.google.com/google-ads/api/reference/rpc/v25/MediaFileErrorEnum.MediaFileError.md.txt) [MutateError](https://developers.google.com/google-ads/api/reference/rpc/v25/MutateErrorEnum.MutateError.md.txt) [NewResourceCreationError](https://developers.google.com/google-ads/api/reference/rpc/v25/NewResourceCreationErrorEnum.NewResourceCreationError.md.txt) [NotEmptyError](https://developers.google.com/google-ads/api/reference/rpc/v25/NotEmptyErrorEnum.NotEmptyError.md.txt) [NullError](https://developers.google.com/google-ads/api/reference/rpc/v25/NullErrorEnum.NullError.md.txt) [OperationAccessDeniedError](https://developers.google.com/google-ads/api/reference/rpc/v25/OperationAccessDeniedErrorEnum.OperationAccessDeniedError.md.txt) [OperatorError](https://developers.google.com/google-ads/api/reference/rpc/v25/OperatorErrorEnum.OperatorError.md.txt) [PolicyFindingError](https://developers.google.com/google-ads/api/reference/rpc/v25/PolicyFindingErrorEnum.PolicyFindingError.md.txt) [PolicyValidationParameterError](https://developers.google.com/google-ads/api/reference/rpc/v25/PolicyValidationParameterErrorEnum.PolicyValidationParameterError.md.txt) [PolicyViolationError](https://developers.google.com/google-ads/api/reference/rpc/v25/PolicyViolationErrorEnum.PolicyViolationError.md.txt) [QuotaError](https://developers.google.com/google-ads/api/reference/rpc/v25/QuotaErrorEnum.QuotaError.md.txt) [RangeError](https://developers.google.com/google-ads/api/reference/rpc/v25/RangeErrorEnum.RangeError.md.txt) [RequestError](https://developers.google.com/google-ads/api/reference/rpc/v25/RequestErrorEnum.RequestError.md.txt) [ResourceCountLimitExceededError](https://developers.google.com/google-ads/api/reference/rpc/v25/ResourceCountLimitExceededErrorEnum.ResourceCountLimitExceededError.md.txt) [SizeLimitError](https://developers.google.com/google-ads/api/reference/rpc/v25/SizeLimitErrorEnum.SizeLimitError.md.txt) [StringFormatError](https://developers.google.com/google-ads/api/reference/rpc/v25/StringFormatErrorEnum.StringFormatError.md.txt) [StringLengthError](https://developers.google.com/google-ads/api/reference/rpc/v25/StringLengthErrorEnum.StringLengthError.md.txt) [UrlFieldError](https://developers.google.com/google-ads/api/reference/rpc/v25/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/v25/services/ad_group_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).