How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Google Ads Customers.ad Group Ads API

The customers.adGroupAds API from Google Ads — 2 operation(s) for customers.adgroupads.

Google Ads Customers.ad Group Ads API is one of 109 APIs that Google Ads publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, and rate-limit docs.

This API exposes 2 operations across 2 paths, and defines 73 schemas. It is described by OpenAPI 3.2.0, at version v25.

Requests are made against a single base URL, https://googleads.googleapis.com.

2 operations 2 paths 73 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v25
Base URL
https://googleads.googleapis.com
Authentication
OAuth 2.0
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Google Ads Customers.ad Group Ads API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope. By default, every request must be authenticated.

  • oauth2 — Google OAuth 2.0. Google Ads API additionally requires a developer token in the developer-token header.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

customers.adGroupAds 2
POST
/v25/customers/{customersId}/adGroupAds/{adGroupAdsId}:removeAutomaticallyCreatedAssets
Remove automatically created assets from an ad
googleads_customers_adGroupAds_removeAutomaticallyCreatedAssets 12 params body → 200
POST
/v25/customers/{customersId}/adGroupAds:mutate
Creates, updates, or removes ads
googleads_customers_adGroupAds_mutate 12 params body → 200

Schemas 73

The contract defines 73 schemas that model the data the API accepts and returns. The most detailed are GoogleAdsGoogleadsV25Resources__Ad (41 properties), GoogleAdsGoogleadsV25Common__ResponsiveDisplayAdInfo (17 properties), GoogleAdsGoogleadsV25Common__LegacyResponsiveDisplayAdInfo (15 properties), GoogleAdsGoogleadsV25Resources__AdGroupAd (13 properties). Each schema is shown below with its type and property counts.

GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_WebsiteList
object
A list of websites that caused a policy finding. Used for ONEWEBSITEPERADGROUP policy topic, for example. In case there are more than five websites, only the t…
1 property
GoogleAdsGoogleadsV25Common__PolicyTopicConstraint
object
Describes the effect on serving that a policy topic entry will have.
4 properties
GoogleAdsGoogleadsV25Common__AppAdInfo
object
An app ad.
7 properties
GoogleAdsGoogleadsV25Common__ShoppingSmartAdInfo
object
A Smart Shopping ad.
GoogleAdsGoogleadsV25Common__InFeedVideoAdInfo
object
Representation of In-feed video ad format.
4 properties
GoogleAdsGoogleadsV25Resources__AdGroupAd
object
An ad group ad.
13 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_TextList
object
A list of fragments of text that violated a policy.
1 property
GoogleAdsGoogleadsV25Common__PolicyViolationKey
object
Key of the violation. The key is used for referring to a violation when filing an exemption request.
2 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationNotWorking
object
Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
5 properties
GoogleAdsGoogleadsV25Common__DisplayUploadAdInfo
object
A generic type of display ad. The exact ad format is controlled by the displayuploadproducttype field, which determines what kinds of data need to be included…
2 properties
GoogleAdsGoogleadsV25Common__UrlCollection
object
Collection of urls that is tagged with a unique identifier.
4 properties
GoogleRpc__Status
object
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](h…
3 properties
GoogleAdsGoogleadsV25Common__YouTubeAudioAdInfo
object
Representation of YouTube Audio ad format.
GoogleAdsGoogleadsV25Resources__AdGroupAdAssetAutomationSetting
object
Asset automation setting for an AdGroupAd.
2 properties
GoogleAdsGoogleadsV25Common__PolicyTopicEvidence
object
Additional information that explains a policy finding.
6 properties
GoogleAdsGoogleadsV25Common__ExpandedTextAdInfo
object
An expanded text ad. Expanded text ads are deprecated.
7 properties
GoogleAdsGoogleadsV25Common__CustomParameter
object
A mapping that can be used by custom parameter tags in a trackingurltemplate, finalurls, or mobilefinalurls.
2 properties
GoogleAdsGoogleadsV25Common__AdVideoAsset
object
A video asset used inside an ad.
2 properties
GoogleAdsGoogleadsV25Common__LegacyResponsiveDisplayAdInfo
object
A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI.
15 properties
GoogleProtobuf__Empty
object
A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the resp…
GoogleAdsGoogleadsV25Common__AdDemandGenCarouselCardAsset
object
A Demand Gen carousel card asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__SyntheticContentInfo
object
Container for synthetic content attestations from different sources, such as the advertiser and Google systems.
2 properties
GoogleAdsGoogleadsV25Common__DemandGenCarouselAdInfo
object
A Demand Gen carousel ad.
6 properties
GoogleAdsGoogleadsV25Common__PolicyValidationParameter
object
Parameter for controlling how policy exemption is done.
2 properties
GoogleAdsGoogleadsV25Services__AssetsWithFieldType
object
The combination of system asset and field type to remove.
2 properties
GoogleAdsGoogleadsV25Common__LocalAdInfo
object
A local ad.
8 properties
GoogleAdsGoogleadsV25Common__AppPreRegistrationAdInfo
object
App pre-registration ads link to your app or game listing on Google Play, and can run on Google Play, on YouTube (in-stream only), and within other apps and mo…
4 properties
GoogleAdsGoogleadsV25Common__VideoTrueViewInStreamAdInfo
object
Representation of video TrueView in-stream ad format (ad shown during video playback, often at beginning, which displays a skip button a few seconds into the v…
3 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationMismatch
object
Evidence of mismatches between the URLs of a resource.
1 property
GoogleAdsGoogleadsV25Services__RemoveAutomaticallyCreatedAssetsRequest
object
Request message for AdGroupAdService.RemoveAutomaticallyCreatedAssets.
1 property
GoogleAdsGoogleadsV25Common__PolicyTopicEntry
object
Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates…
4 properties
GoogleAdsGoogleadsV25Common__FinalAppUrl
object
A URL for deep linking into an app for the given operating system.
2 properties
GoogleAdsGoogleadsV25Common__AdVideoAssetLinkFeatureControl
object
YouTube Video Asset feature controls.
1 property
GoogleAdsGoogleadsV25Services__MutateAdGroupAdResult
object
The result for the ad mutate.
2 properties
GoogleAdsGoogleadsV25Services__MutateAdGroupAdsResponse
object
Response message for an ad group ad mutate.
2 properties
GoogleAdsGoogleadsV25Resources__Ad
object
An ad.
41 properties
GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraintList
object
A list of countries where a resource's serving is constrained.
2 properties
GoogleAdsGoogleadsV25Common__TravelAdInfo
object
A travel ad.
GoogleAdsGoogleadsV25Common__AppEngagementAdInfo
object
App engagement ads allow you to write text encouraging a specific action in the app, like checking in, making a purchase, or booking a flight. They allow you t…
4 properties
GoogleAdsGoogleadsV25Services__AdGroupAdOperation
object
A single operation (create, update, remove) on an ad group ad.
5 properties
GoogleAdsGoogleadsV25Common__ResponsiveSearchAdInfo
object
A responsive search ad. Responsive search ads let you create an ad that adapts to show more text, and more relevant messages, to your customers. Enter multiple…
4 properties
GoogleAdsGoogleadsV25Common__AdImageAsset
object
An image asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__AdTextAsset
object
A text asset used inside an ad.
4 properties
GoogleAdsGoogleadsV25Common__AdAssetPolicySummary
object
Contains policy information for an asset inside an ad.
3 properties
GoogleAdsGoogleadsV25Common__LegacyAppInstallAdInfo
object
A legacy app install ad that only can be used by a few select customers.
5 properties
GoogleAdsGoogleadsV25Common__SyntheticContentAttestation
object
Represents an attestation about synthetic content from a single source.
2 properties
GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_ResellerConstraint
object
Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes.
GoogleAdsGoogleadsV25Common__ResponsiveDisplayAdInfo
object
A responsive display ad.
17 properties
GoogleAdsGoogleadsV25Common__ShoppingComparisonListingAdInfo
object
A Shopping Comparison Listing ad.
1 property
GoogleAdsGoogleadsV25Resources__AdGroupAdPolicySummary
object
Contains policy information for an ad.
3 properties
GoogleAdsGoogleadsV25Common__VideoAdInfo
object
A video ad.
7 properties
GoogleAdsGoogleadsV25Common__ShoppingProductAdInfo
object
A standard Shopping ad.
GoogleAdsGoogleadsV25Common__VideoBumperInStreamAdInfo
object
Representation of video bumper in-stream ad format (very short in-stream non-skippable video ad).
3 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationTextList
object
A list of strings found in a destination page that caused a policy finding.
1 property
GoogleAdsGoogleadsV25Common__SmartCampaignAdInfo
object
A Smart campaign ad.
2 properties
GoogleAdsGoogleadsV25Common__VideoNonSkippableInStreamAdInfo
object
Representation of video non-skippable in-stream ad format (15 second in-stream non-skippable video ad).
3 properties
GoogleAdsGoogleadsV25Common__DemandGenProductAdInfo
object
A Demand Gen product ad.
7 properties
GoogleAdsGoogleadsV25Common__ExpandedDynamicSearchAdInfo
object
An expanded dynamic search ad.
2 properties
GoogleAdsGoogleadsV25Common__AdMediaBundleAsset
object
A media bundle asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__ImageAdInfo
object
An image ad.
11 properties
GoogleAdsGoogleadsV25Common__HotelAdInfo
object
A hotel ad.
GoogleAdsGoogleadsV25Common__DemandGenVideoResponsiveAdInfo
object
A Demand Gen video responsive ad.
10 properties
GoogleAdsGoogleadsV25Common__AdAppDeepLinkAsset
object
An app deep link used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__TextAdInfo
object
A text ad.
3 properties
GoogleAdsGoogleadsV25Common__VideoOutstreamAdInfo
object
Representation of video out-stream ad format (ad shown alongside a feed with automatic playback, without sound).
2 properties
GoogleAdsGoogleadsV25Common__ResponsiveDisplayAdControlSpec
object
Specification for various creative controls for a responsive display ad.
2 properties
GoogleAdsGoogleadsV25Services__MutateAdGroupAdsRequest
object
Request message for AdGroupAdService.MutateAdGroupAds.
4 properties
GoogleAdsGoogleadsV25Common__AdCallToActionAsset
object
A call to action asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__AdVideoAssetInventoryPreferences
object
YouTube Video Asset inventory preferences.
3 properties
GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraint
object
Indicates that a resource's ability to serve in a particular country is constrained.
1 property
GoogleAdsGoogleadsV25Common__DemandGenMultiAssetAdInfo
object
A Demand Gen multi asset ad.
10 properties
GoogleAdsGoogleadsV25Common__AdVideoAssetInfo
object
Contains info fields for AdVideoAssets.
2 properties
GoogleAdsGoogleadsV25Common__VideoResponsiveAdInfo
object
A video responsive ad.
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-ads-customers-adgroupads-api-openapi.yml Raw ↑

Other APIs Google Ads publishes across the network.

Google Ads Scripts
Google Ads Ad Groups API
Google Ads Ads API
Google Ads Bidding Strategies API
Google Ads Campaigns API
Google Ads Customers API
Google Ads Keywords API
Google Ads Reporting API
Google Ads Audience Insights API
Google Ads Customers.account Budget Proposals API
Google Ads Customers.account Links API
Google Ads Customers.ad Group Ad Labels API
Where this information came from

This is an independent, third-party profile of Google Ads Customers.ad Group Ads API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.