> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v24** . 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/v24/AdCustomizerErrorEnum.AdCustomizerError.md.txt) [AdError](https://developers.google.com/google-ads/api/reference/rpc/v24/AdErrorEnum.AdError.md.txt) [AdGroupAdError](https://developers.google.com/google-ads/api/reference/rpc/v24/AdGroupAdErrorEnum.AdGroupAdError.md.txt) [AdSharingError](https://developers.google.com/google-ads/api/reference/rpc/v24/AdSharingErrorEnum.AdSharingError.md.txt) [AdxError](https://developers.google.com/google-ads/api/reference/rpc/v24/AdxErrorEnum.AdxError.md.txt) [AssetError](https://developers.google.com/google-ads/api/reference/rpc/v24/AssetErrorEnum.AssetError.md.txt) [AssetLinkError](https://developers.google.com/google-ads/api/reference/rpc/v24/AssetLinkErrorEnum.AssetLinkError.md.txt) [AuthenticationError](https://developers.google.com/google-ads/api/reference/rpc/v24/AuthenticationErrorEnum.AuthenticationError.md.txt) [AuthorizationError](https://developers.google.com/google-ads/api/reference/rpc/v24/AuthorizationErrorEnum.AuthorizationError.md.txt) [CollectionSizeError](https://developers.google.com/google-ads/api/reference/rpc/v24/CollectionSizeErrorEnum.CollectionSizeError.md.txt) [ContextError](https://developers.google.com/google-ads/api/reference/rpc/v24/ContextErrorEnum.ContextError.md.txt) [DatabaseError](https://developers.google.com/google-ads/api/reference/rpc/v24/DatabaseErrorEnum.DatabaseError.md.txt) [DateError](https://developers.google.com/google-ads/api/reference/rpc/v24/DateErrorEnum.DateError.md.txt) [DistinctError](https://developers.google.com/google-ads/api/reference/rpc/v24/DistinctErrorEnum.DistinctError.md.txt) [FeedAttributeReferenceError](https://developers.google.com/google-ads/api/reference/rpc/v24/FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError.md.txt) [FieldError](https://developers.google.com/google-ads/api/reference/rpc/v24/FieldErrorEnum.FieldError.md.txt) [FieldMaskError](https://developers.google.com/google-ads/api/reference/rpc/v24/FieldMaskErrorEnum.FieldMaskError.md.txt) [FunctionError](https://developers.google.com/google-ads/api/reference/rpc/v24/FunctionErrorEnum.FunctionError.md.txt) [FunctionParsingError](https://developers.google.com/google-ads/api/reference/rpc/v24/FunctionParsingErrorEnum.FunctionParsingError.md.txt) [HeaderError](https://developers.google.com/google-ads/api/reference/rpc/v24/HeaderErrorEnum.HeaderError.md.txt) [IdError](https://developers.google.com/google-ads/api/reference/rpc/v24/IdErrorEnum.IdError.md.txt) [ImageError](https://developers.google.com/google-ads/api/reference/rpc/v24/ImageErrorEnum.ImageError.md.txt) [InternalError](https://developers.google.com/google-ads/api/reference/rpc/v24/InternalErrorEnum.InternalError.md.txt) [ListOperationError](https://developers.google.com/google-ads/api/reference/rpc/v24/ListOperationErrorEnum.ListOperationError.md.txt) [MediaBundleError](https://developers.google.com/google-ads/api/reference/rpc/v24/MediaBundleErrorEnum.MediaBundleError.md.txt) [MediaFileError](https://developers.google.com/google-ads/api/reference/rpc/v24/MediaFileErrorEnum.MediaFileError.md.txt) [MutateError](https://developers.google.com/google-ads/api/reference/rpc/v24/MutateErrorEnum.MutateError.md.txt) [NewResourceCreationError](https://developers.google.com/google-ads/api/reference/rpc/v24/NewResourceCreationErrorEnum.NewResourceCreationError.md.txt) [NotEmptyError](https://developers.google.com/google-ads/api/reference/rpc/v24/NotEmptyErrorEnum.NotEmptyError.md.txt) [NullError](https://developers.google.com/google-ads/api/reference/rpc/v24/NullErrorEnum.NullError.md.txt) [OperationAccessDeniedError](https://developers.google.com/google-ads/api/reference/rpc/v24/OperationAccessDeniedErrorEnum.OperationAccessDeniedError.md.txt) [OperatorError](https://developers.google.com/google-ads/api/reference/rpc/v24/OperatorErrorEnum.OperatorError.md.txt) [PolicyFindingError](https://developers.google.com/google-ads/api/reference/rpc/v24/PolicyFindingErrorEnum.PolicyFindingError.md.txt) [PolicyValidationParameterError](https://developers.google.com/google-ads/api/reference/rpc/v24/PolicyValidationParameterErrorEnum.PolicyValidationParameterError.md.txt) [PolicyViolationError](https://developers.google.com/google-ads/api/reference/rpc/v24/PolicyViolationErrorEnum.PolicyViolationError.md.txt) [QuotaError](https://developers.google.com/google-ads/api/reference/rpc/v24/QuotaErrorEnum.QuotaError.md.txt) [RangeError](https://developers.google.com/google-ads/api/reference/rpc/v24/RangeErrorEnum.RangeError.md.txt) [RequestError](https://developers.google.com/google-ads/api/reference/rpc/v24/RequestErrorEnum.RequestError.md.txt) [ResourceCountLimitExceededError](https://developers.google.com/google-ads/api/reference/rpc/v24/ResourceCountLimitExceededErrorEnum.ResourceCountLimitExceededError.md.txt) [SizeLimitError](https://developers.google.com/google-ads/api/reference/rpc/v24/SizeLimitErrorEnum.SizeLimitError.md.txt) [StringFormatError](https://developers.google.com/google-ads/api/reference/rpc/v24/StringFormatErrorEnum.StringFormatError.md.txt) [StringLengthError](https://developers.google.com/google-ads/api/reference/rpc/v24/StringLengthErrorEnum.StringLengthError.md.txt) [UrlFieldError](https://developers.google.com/google-ads/api/reference/rpc/v24/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/v24/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).