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.experiments API

The customers.experiments API from Google Ads — 6 operation(s) for customers.experiments.

Google Ads Customers.experiments 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 6 operations across 6 paths, and defines 17 schemas. It is described by OpenAPI 3.2.0, at version v25.

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

6 operations 6 paths 17 schemas 1 GET5 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.experiments 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 6

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

customers.experiments 6
POST
/v25/customers/{customersId}/experiments/{experimentsId}:scheduleExperiment
Schedule an experiment
googleads_customers_experiments_scheduleExperiment 12 params body → 200
POST
/v25/customers/{customersId}/experiments/{experimentsId}:graduateExperiment
Graduates an experiment to a full campaign
googleads_customers_experiments_graduateExperiment 12 params body → 200
POST
/v25/customers/{customersId}/experiments/{experimentsId}:promoteExperiment
Promotes the trial campaign thus applying changes in the trial campaign to the base campaign
googleads_customers_experiments_promoteExperiment 12 params body → 200
POST
/v25/customers/{customersId}/experiments:mutate
Creates, updates, or removes experiments
googleads_customers_experiments_mutate 12 params body → 200
POST
/v25/customers/{customersId}/experiments/{experimentsId}:endExperiment
Immediately ends an experiment, changing the experiment's scheduled end date and without waiting for end of day
googleads_customers_experiments_endExperiment 12 params body → 200
GET
/v25/customers/{customersId}/experiments/{experimentsId}:listExperimentAsyncErrors
Returns all errors that occurred during the last Experiment update (either scheduling or promotion)
googleads_customers_experiments_listExperimentAsyncErrors 14 params → 200

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are GoogleAdsGoogleadsV25Resources__Experiment (15 properties), GoogleLongrunning__Operation (5 properties), GoogleAdsGoogleadsV25Services__ExperimentOperation (4 properties), GoogleRpc__Status (3 properties). Each schema is shown below with its type and property counts.

GoogleLongrunning__Operation
object
This resource represents a long-running operation that is the result of a network API call.
5 properties
GoogleAdsGoogleadsV25Services__MutateExperimentsRequest
object
Request message for ExperimentService.MutateExperiments.
3 properties
GoogleAdsGoogleadsV25Services__GraduateExperimentRequest
object
Request message for ExperimentService.GraduateExperiment.
2 properties
GoogleAdsGoogleadsV25Services__ListExperimentAsyncErrorsResponse
object
Response message for ExperimentService.ListExperimentAsyncErrors.
2 properties
GoogleAdsGoogleadsV25Services__MutateExperimentsResponse
object
Response message for experiment mutate.
2 properties
GoogleAdsGoogleadsV25Services__MutateExperimentResult
object
The result for the campaign experiment mutate.
1 property
GoogleAdsGoogleadsV25Services__CampaignBudgetMapping
object
The mapping of experiment campaign and budget to be graduated.
2 properties
GoogleAdsGoogleadsV25Services__PromoteExperimentRequest
object
Request message for ExperimentService.PromoteExperiment.
1 property
GoogleAdsGoogleadsV25Common__VideoExperimentInfo
object
Configuration for a Video experiment.
1 property
GoogleAdsGoogleadsV25Common__OptimizeAssetsExperimentInfo
object
Configuration for an Optimize Assets experiment.
1 property
GoogleAdsGoogleadsV25Services__ScheduleExperimentRequest
object
Request message for ExperimentService.ScheduleExperiment.
1 property
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
GoogleAdsGoogleadsV25Services__ExperimentOperation
object
A single operation on an experiment.
4 properties
GoogleAdsGoogleadsV25Services__EndExperimentRequest
object
Request message for ExperimentService.EndExperiment.
1 property
GoogleAdsGoogleadsV25Common__MetricGoal
object
A metric goal for an experiment.
2 properties
GoogleAdsGoogleadsV25Resources__Experiment
object
A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.
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…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-ads-customers-experiments-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.experiments 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.