# Google Ads Customers API

**Canonical:** https://apis.io/apis/google-ads/google-ads-customers-api/  
**Provider:** Google Ads — https://apis.io/providers/google-ads/  
**Base URL:** https://googleads.googleapis.com  
**Documentation:** https://developers.google.com/google-ads/api

Google Ads Customers API is one of 109 APIs that [Google Ads](https://apis.io/providers/google-ads/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, best-practice docs, rate-limit docs, and release notes.

Access and manage Google Ads customer account information

## Operations (33)

| Method | Path | Summary |
|---|---|---|
| POST | `/v25/customers/{customersId}:generateShareablePreviews` | Returns the requested Shareable Preview. |
| GET | `/v25/customers:listAccessibleCustomers` | Returns resource names of customers directly accessible by the user authenticating the call |
| POST | `/v25/customers/{customersId}:generateKeywordHistoricalMetrics` | Returns a list of keyword historical metrics |
| POST | `/v25/customers/{customersId}:suggestKeywordThemes` | Suggests keyword themes to advertise on. |
| POST | `/v25/customers/{customersId}:generateAudienceDefinition` | Returns a collection of audience attributes using generative AI based on the provided audience description |
| POST | `/v25/customers/{customersId}:generateTrendingInsights` | Returns insights for trending content on YouTube |
| POST | `/v25/customers/{customersId}:generateAudienceOverlapInsights` | Returns a collection of audience attributes along with estimates of the overlap between their potential YouTube reach and that of a given input attribute |
| POST | `/v25/customers/{customersId}:suggestSmartCampaignBudgetOptions` | Returns BudgetOption suggestions. |
| POST | `/v25/customers/{customersId}:generateSuggestedTargetingInsights` | Returns a collection of targeting insights (e.g |
| POST | `/v25/customers/{customersId}:generateKeywordForecastMetrics` | Returns metrics (such as impressions, clicks, total cost) of a keyword forecast for the given campaign |
| POST | `/v25/customers/{customersId}:generateCreatorInsights` | Returns insights for a collection of YouTube Creators and Channels |
| POST | `/v25/customers/{customersId}:uploadClickConversions` | Processes the given click conversions |
| POST | `/v25/customers/{customersId}:suggestTravelAssets` | Returns Travel Asset suggestions |
| POST | `/v25/customers/{customersId}:uploadUserData` | Uploads the given user data |
| POST | `/v25/customers/{customersId}:uploadConversionAdjustments` | Processes the given conversion adjustments |
| POST | `/v25/customers/{customersId}:removeCampaignAutomaticallyCreatedAsset` | Removes automatically created assets from a campaign |
| POST | `/v25/customers/{customersId}:generateAudienceCompositionInsights` | Returns a collection of attributes that are represented in an audience of interest, with metrics that compare each attribute's share of the audience with its... |
| POST | `/v25/customers/{customersId}:suggestSmartCampaignAd` | Suggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and the business to advertise. |
| POST | `/v25/customers/{customersId}:startIdentityVerification` | Starts Identity Verification for a given verification program type |
| POST | `/v25/customers/{customersId}:generateReachForecast` | Generates a reach forecast for a given targeting / product mix |
| GET | `/v25/customers/{customersId}/getIdentityVerification` | Returns Identity Verification information |
| POST | `/v25/customers/{customersId}:suggestBrands` | Rpc to return a list of matching brands based on a prefix for this customer. |
| POST | `/v25/customers/{customersId}:mutate` | Updates a customer |
| POST | `/v25/customers/{customersId}:generateKeywordIdeas` | Returns a list of keyword ideas |
| POST | `/v25/customers/{customersId}:generateInsightsFinderReport` | Creates a saved report that can be viewed in the Insights Finder tool |
| POST | `/v25/customers/{customersId}:uploadCallConversions` | Processes the given call conversions |
| POST | `/v25/customers/{customersId}:generateAdGroupThemes` | Returns a list of suggested AdGroups and suggested modifications (text, match type) for the given keywords |
| POST | `/v25/customers/{customersId}:createCustomerClient` | Creates a new client under manager |
| POST | `/v25/customers/{customersId}:generateBenchmarksMetrics` | Returns YouTube advertisement metrics for the given client against industry benchmarks |
| POST | `/v25/customers/{customersId}:searchAudienceInsightsAttributes` | Searches for audience attributes that can be used to generate insights |
| POST | `/v25/customers/{customersId}:generateTargetingSuggestionMetrics` | Returns potential reach metrics for targetable audiences |
| GET | `/v18/customers/{customerId}` | Google Ads Get Customer Account Details |
| GET | `/v18/customers:listAccessibleCustomers` | Google Ads List Accessible Customer Accounts |

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/google-ads/refs/heads/main/openapi/google-ads-customers-api-openapi.yml
- **Documentation** — https://developers.google.com/google-ads/api/docs/start
- **Authentication** — https://developers.google.com/google-ads/api/docs/oauth/overview
- **SDKs** — https://developers.google.com/google-ads/api/docs/client-libs
- **Migration Guide** — https://developers.google.com/google-ads/api/docs/migration
- **Best Practices** — https://developers.google.com/google-ads/api/docs/best-practices
- **RateLimits** — https://developers.google.com/google-ads/api/docs/rate-limits
- **ReleaseNotes** — https://developers.google.com/google-ads/api/docs/release-notes
- **Support** — https://developers.google.com/google-ads/api/support
- **Forums** — https://groups.google.com/g/adwords-api
- **Client Libraries** — https://developers.google.com/google-ads/api/docs/client-libs
- **ChangeLog** — https://developers.google.com/google-ads/api/docs/release-notes
- **GettingStarted** — https://developers.google.com/google-ads/api/docs/first-call/overview
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/google-ads/refs/heads/main/graphql/google-ads-graphql.md

## Other Google Ads APIs (12)

- [Google Ads Scripts](https://apis.io/apis/google-ads/google-ads-scripts/)
- [Google Ads Ad Groups API](https://apis.io/apis/google-ads/google-ads-ad-groups-api/)
- [Google Ads Ads API](https://apis.io/apis/google-ads/google-ads-ads-api/)
- [Google Ads Bidding Strategies API](https://apis.io/apis/google-ads/google-ads-bidding-strategies-api/)
- [Google Ads Campaigns API](https://apis.io/apis/google-ads/google-ads-campaigns-api/)
- [Google Ads Keywords API](https://apis.io/apis/google-ads/google-ads-keywords-api/)
- [Google Ads Reporting API](https://apis.io/apis/google-ads/google-ads-reporting-api/)
- [Google Ads Audience Insights API](https://apis.io/apis/google-ads/google-ads-audienceinsights-api/)
- [Google Ads Customers.account Budget Proposals API](https://apis.io/apis/google-ads/google-ads-customers-accountbudgetproposals-api/)
- [Google Ads Customers.account Links API](https://apis.io/apis/google-ads/google-ads-customers-accountlinks-api/)
- [Google Ads Customers.ad Group Ad Labels API](https://apis.io/apis/google-ads/google-ads-customers-adgroupadlabels-api/)
- [Google Ads Customers.ad Group Ads API](https://apis.io/apis/google-ads/google-ads-customers-adgroupads-api/)

## Tags

Customers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/google-ads/google-ads-customers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/google-ads/.