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

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

Google Ads Customers.campaigns 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 77 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 77 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.campaigns 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.campaigns 2
POST
/v25/customers/{customersId}/campaigns:enablePMaxBrandGuidelines
Enables Brand Guidelines for Performance Max campaigns
googleads_customers_campaigns_enablePMaxBrandGuidelines 12 params body → 200
POST
/v25/customers/{customersId}/campaigns:mutate
Creates, updates, or removes campaigns
googleads_customers_campaigns_mutate 12 params body → 200

Schemas 77

The contract defines 77 schemas that model the data the API accepts and returns. The most detailed are GoogleAdsGoogleadsV25Resources__Campaign (78 properties), GoogleAdsGoogleadsV25Resources_Campaign_ShoppingSetting (8 properties), GoogleAdsGoogleadsV25Services__EnableOperation (7 properties), GoogleAdsGoogleadsV25Resources_Campaign_NetworkSettings (6 properties). Each schema is shown below with its type and property counts.

GoogleAdsGoogleadsV25Common__ManualCpc
object
Manual click-based bidding where user pays per click.
1 property
GoogleAdsGoogleadsV25Common__TargetingSetting
object
Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.co…
2 properties
GoogleAdsGoogleadsV25Common__ManualCpm
object
Manual impression-based bidding where user pays per thousand impressions.
GoogleAdsGoogleadsV25Resources_Campaign_VanityPharma
object
Describes how unbranded pharma ads will be displayed.
2 properties
GoogleAdsGoogleadsV25Services__CampaignOperation
object
A single operation (create, update, remove) on a campaign.
4 properties
GoogleAdsGoogleadsV25Resources_Campaign_AssetAutomationSetting
object
Asset automation setting contains pair of AssetAutomationType and the asset automation opt-in/out status
2 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_VideoAdSequenceStep
object
Information about a step within a video sequence.
5 properties
GoogleAdsGoogleadsV25Services__BrandCampaignAssets
object
Assets linked at the campaign level. A businessname and at least one logoasset are required.
3 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_NonSkippableInStreamRestrictions
object
Restrictions for non-skippable format.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_TravelCampaignSettings
object
Settings for Travel campaign.
1 property
GoogleAdsGoogleadsV25Common__CampaignThirdPartyIntegrationPartners
object
Container for Campaign level third party integration partners.
5 properties
GoogleAdsGoogleadsV25Common__FixedCpm
object
Fixed CPM (cost per thousand impression) bidding strategy. A manual bidding strategy with a fixed CPM.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_LocalServicesCampaignSettings
object
Settings for LocalServicesCampaign subresource.
1 property
GoogleAdsGoogleadsV25Resources_Campaign_SelectiveOptimization
object
Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to ap…
1 property
GoogleAdsGoogleadsV25Services__EnableOperation
object
A single enable operation of a campaign.
7 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_BookingDetails
object
Container for booking details for campaigns with the FIXEDCPM or FIXEDSHAREOFVOICE bidding strategies.
3 properties
GoogleAdsGoogleadsV25Common__RealTimeBiddingSetting
object
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
1 property
GoogleAdsGoogleadsV25Resources_Campaign_AppCampaignSetting
object
Campaign-level settings for App Campaigns.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_AudienceSetting
object
Settings for the audience targeting.
1 property
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_VideoAdInventoryControl
object
For campaigns using video responsive ads inventory controls determine on which inventories the ads can be shown. This only applies for campaigns with the biddi…
4 properties
GoogleAdsGoogleadsV25Common__ManualCpa
object
Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
GoogleAdsGoogleadsV25Services__MutateCampaignsRequest
object
Request message for CampaignService.MutateCampaigns.
4 properties
GoogleAdsGoogleadsV25Resources_Campaign_LocalCampaignSetting
object
Campaign setting for local campaigns.
1 property
GoogleAdsGoogleadsV25Common__Commission
object
Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
1 property
GoogleAdsGoogleadsV25Common__TargetImpressionShare
object
An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_GeoTargetTypeSetting
object
Represents a collection of settings related to ads geotargeting.
2 properties
GoogleAdsGoogleadsV25Common__PercentCpc
object
A bidding strategy where bids are a fraction of the advertised price for some good or service.
2 properties
GoogleAdsGoogleadsV25Common__TargetCpa
object
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
3 properties
GoogleAdsGoogleadsV25Common__TargetCpc
object
An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set.
1 property
GoogleAdsGoogleadsV25Common__CampaignThirdPartyViewabilityIntegrationPartner
object
Container for third party viewability integration data for Campaign.
3 properties
GoogleAdsGoogleadsV25Common__TargetSpend
object
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
2 properties
GoogleAdsGoogleadsV25Common__FrequencyCapEntry
object
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_VideoCampaignSettings
object
Settings for Video campaign.
5 properties
GoogleAdsGoogleadsV25Common__CampaignThirdPartyReachIntegrationPartner
object
Container for third party reach integration data for Campaign.
3 properties
GoogleAdsGoogleadsV25Common__TargetCpv
object
Target CPV (cost per view) bidding strategy. An automated bidding strategy that sets bids to optimize performance given the target CPV you set.
GoogleAdsGoogleadsV25Common__CampaignThirdPartyBrandLiftIntegrationPartner
object
Container for third party Brand Lift integration data for Campaign.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_PerformanceMaxUpgrade
object
Information about a campaign being upgraded to Performance Max.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_DemandGenCampaignSettings
object
Settings for Demand Gen campaign.
1 property
GoogleAdsGoogleadsV25Services__MutateCampaignResult
object
The result for the campaign mutate.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_CategoryBid
object
Category bids in LocalServicesReportingCampaignSettings.
3 properties
GoogleAdsGoogleadsV25Services__EnablePMaxBrandGuidelinesRequest
object
Request to enable Brand Guidelines for a Performance Max campaign.
1 property
GoogleAdsGoogleadsV25Resources_Campaign_NetworkSettings
object
The network settings for the campaign.
6 properties
GoogleAdsGoogleadsV25Resources_Campaign_DynamicSearchAdsSetting
object
The setting for controlling Dynamic Search Ads (DSA).
3 properties
GoogleAdsGoogleadsV25Common__TargetCpmTargetFrequencyGoal
object
Target Frequency bidding goal details.
2 properties
GoogleAdsGoogleadsV25Common__LocalServicesPhoneNumber
object
Phone number associated with the provider.
3 properties
GoogleAdsGoogleadsV25Common__CampaignThirdPartyConversionAttributionIntegrationPartner
object
Container for third party YouTube conversion attribution integration data for Campaign.
2 properties
GoogleAdsGoogleadsV25Services__EnablePMaxBrandGuidelinesResponse
object
Brand Guidelines campaign enablement response.
1 property
GoogleAdsGoogleadsV25Common__CustomParameter
object
A mapping that can be used by custom parameter tags in a trackingurltemplate, finalurls, or mobilefinalurls.
2 properties
GoogleAdsGoogleadsV25Common__TargetRoas
object
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
4 properties
GoogleAdsGoogleadsV25Resources_Campaign_BrandGuidelines
object
Settings that control the visual appearance of your brand in a campaign's automatically generated assets and formats. Only applicable to Performance Max campai…
3 properties
GoogleAdsGoogleadsV25Resources__Campaign
object
A campaign.
78 properties
GoogleAdsGoogleadsV25Services__MutateCampaignsResponse
object
Response message for campaign mutate.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_PmaxCampaignSettings
object
Settings for Performance Max campaigns.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_AiMaxSetting
object
Settings for AI Max in Search and Shopping campaigns.
2 properties
GoogleAdsGoogleadsV25Common__FrequencyCapKey
object
A group of fields used as keys for a frequency cap. There can be no more than one frequency cap with the same key.
4 properties
GoogleAdsGoogleadsV25Common__TargetRestrictionOperation
object
Operation to be performed on a target restriction list in a mutate.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_LocalServicesPmaxCampaignSettings
object
Settings for Local Services Performance Max Campaign subresource.
4 properties
GoogleAdsGoogleadsV25Common__MaximizeConversionValue
object
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
4 properties
GoogleAdsGoogleadsV25Common__CampaignThirdPartyBrandSafetyIntegrationPartner
object
Container for third party brand safety integration data for Campaign.
2 properties
GoogleAdsGoogleadsV25Resources_CampaignPmaxCampaignSettings_BrandTargetingOverrides
object
Overrides of brand targeting for various ad types.
1 property
GoogleAdsGoogleadsV25Common__FixedCpmTargetFrequencyGoalInfo
object
Target frequency bidding goal details for Fixed CPM bidding strategy. Only relevant if the goal of the bidding strategy is TARGETFREQUENCY.
2 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_VideoAdFormatControl
object
Format-restricting control enabling usage of video responsive ads in format defined Video campaigns (for example, non-skippable).
2 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
GoogleAdsGoogleadsV25Resources_Campaign_TrackingSetting
object
Campaign-level settings for tracking information.
1 property
GoogleAdsGoogleadsV25Services__EnablementResult
object
A single enablement result of a campaign.
2 properties
GoogleAdsGoogleadsV25Common__TargetRestriction
object
The list of per-targeting-dimension targeting settings.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_MessagingRestriction
object
Freeform instructions that will be used to guide text asset generation using LLM inference.
2 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_ReservationAdCategorySelfDisclosure
object
Container for ad category self-disclosure for campaigns with the FIXEDCPM or FIXEDSHAREOFVOICE bidding strategies.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_HotelSettingInfo
object
Campaign-level settings for hotel ads.
2 properties
GoogleAdsGoogleadsV25Common__MaximizeConversions
object
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
3 properties
GoogleAdsGoogleadsV25Resources_Campaign_ShoppingSetting
object
The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shoppin…
8 properties
GoogleAdsGoogleadsV25Resources_Campaign_TextGuidelines
object
Settings to control automatically generated text assets.
2 properties
GoogleAdsGoogleadsV25Common__ThirdPartyIntegrationPartnerData
object
Contains third party measurement partner related data for video campaigns.
2 properties
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_VideoAdSequence
object
Container for video ads sequencing definition.
2 properties
GoogleAdsGoogleadsV25Resources_Campaign_OptimizationGoalSetting
object
Optimization goal setting for this campaign, which includes a set of optimization goal types.
1 property
GoogleAdsGoogleadsV25Common__TargetCpm
object
Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.
1 property
GoogleAdsGoogleadsV25Common__ManualCpv
object
View based bidding where user pays per video view.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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