Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/google-ads-customers-campaigns-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Google Ads Customers.campaigns API
description: Manage your Google Ads accounts, campaigns, and reports with this API.
version: v25
x-discovery-revision: '20260721'
contact:
name: Google
url: https://developers.google.com/google-ads/api/
termsOfService: https://developers.google.com/terms
servers:
- url: https://googleads.googleapis.com
description: Google Ads API production server
security:
- oauth2:
- https://www.googleapis.com/auth/adwords
tags:
- name: customers.campaigns
paths:
/v25/customers/{customersId}/campaigns:enablePMaxBrandGuidelines:
parameters:
- name: upload_protocol
in: query
required: false
schema:
type: string
description: Upload protocol for media (e.g. "raw", "multipart").
- name: quotaUser
in: query
required: false
schema:
type: string
description: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
- name: fields
in: query
required: false
schema:
type: string
description: Selector specifying which fields to include in a partial response.
- name: $.xgafv
in: query
required: false
schema:
type: string
enum:
- '1'
- '2'
x-enumDescriptions:
- v1 error format
- v2 error format
description: V1 error format.
- name: callback
in: query
required: false
schema:
type: string
description: JSONP
- name: prettyPrint
in: query
required: false
schema:
type: boolean
default: 'true'
description: Returns response with indentations and line breaks.
- name: access_token
in: query
required: false
schema:
type: string
description: OAuth access token.
- name: uploadType
in: query
required: false
schema:
type: string
description: Legacy upload protocol for media (e.g. "media", "multipart").
- name: key
in: query
required: false
schema:
type: string
description: API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- name: oauth_token
in: query
required: false
schema:
type: string
description: OAuth 2.0 token for the current user.
- name: alt
in: query
required: false
schema:
x-enumDescriptions:
- Responses with Content-Type of application/json
- Media download with context-dependent Content-Type
- Responses with Content-Type of application/x-protobuf
type: string
default: json
enum:
- json
- media
- proto
description: Data format for response.
post:
operationId: googleads_customers_campaigns_enablePMaxBrandGuidelines
summary: Enables Brand Guidelines for Performance Max campaigns
tags:
- customers.campaigns
description: 'Enables Brand Guidelines for Performance Max campaigns. List of thrown errors: [AuthenticationError]() [AssetError]() [AssetLinkError]() [AuthorizationError]() [BrandGuidelinesMigrationError]() [CampaignError]() [HeaderError]() [InternalError]() [MutateError]() [QuotaError]() [RequestError]() [ResourceCountLimitExceededError]()'
parameters:
- name: customerId
in: path
required: true
schema:
pattern: ^[^/]+$
type: string
description: Required. The ID of the customer whose campaigns are being enabled.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__EnablePMaxBrandGuidelinesRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__EnablePMaxBrandGuidelinesResponse'
security:
- oauth2:
- https://www.googleapis.com/auth/adwords
/v25/customers/{customersId}/campaigns:mutate:
parameters:
- name: upload_protocol
in: query
required: false
schema:
type: string
description: Upload protocol for media (e.g. "raw", "multipart").
- name: quotaUser
in: query
required: false
schema:
type: string
description: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
- name: fields
in: query
required: false
schema:
type: string
description: Selector specifying which fields to include in a partial response.
- name: $.xgafv
in: query
required: false
schema:
type: string
enum:
- '1'
- '2'
x-enumDescriptions:
- v1 error format
- v2 error format
description: V1 error format.
- name: callback
in: query
required: false
schema:
type: string
description: JSONP
- name: prettyPrint
in: query
required: false
schema:
type: boolean
default: 'true'
description: Returns response with indentations and line breaks.
- name: access_token
in: query
required: false
schema:
type: string
description: OAuth access token.
- name: uploadType
in: query
required: false
schema:
type: string
description: Legacy upload protocol for media (e.g. "media", "multipart").
- name: key
in: query
required: false
schema:
type: string
description: API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
- name: oauth_token
in: query
required: false
schema:
type: string
description: OAuth 2.0 token for the current user.
- name: alt
in: query
required: false
schema:
x-enumDescriptions:
- Responses with Content-Type of application/json
- Media download with context-dependent Content-Type
- Responses with Content-Type of application/x-protobuf
type: string
default: json
enum:
- json
- media
- proto
description: Data format for response.
post:
operationId: googleads_customers_campaigns_mutate
summary: Creates, updates, or removes campaigns
tags:
- customers.campaigns
description: 'Creates, updates, or removes campaigns. Operation statuses are returned. List of thrown errors: [AdxError]() [AuthenticationError]() [AuthorizationError]() [BiddingError]() [BiddingStrategyError]() [CampaignBudgetError]() [CampaignError]() [ContextError]() [DatabaseError]() [DateError]() [DateRangeError]() [DistinctError]() [FieldError]() [FieldMaskError]() [HeaderError]() [IdError]() [InternalError]() [ListOperationError]() [MutateError]() [NewResourceCreationError]() [NotAllowlistedError]() [NotEmptyError]() [NullError]() [OperationAccessDeniedError]() [OperatorError]() [QuotaError]() [RangeError]() [RegionCodeError]() [RequestError]() [ResourceCountLimitExceededError]() [SettingError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]() [UrlFieldError]()'
parameters:
- name: customerId
in: path
required: true
schema:
type: string
pattern: ^[^/]+$
description: Required. The ID of the customer whose campaigns are being modified.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__MutateCampaignsRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__MutateCampaignsResponse'
security:
- oauth2:
- https://www.googleapis.com/auth/adwords
components:
schemas:
GoogleAdsGoogleadsV25Common__ManualCpc:
description: Manual click-based bidding where user pays per click.
type: object
properties:
enhancedCpcEnabled:
type: boolean
description: Whether bids are to be enhanced based on conversion optimizer data.
GoogleAdsGoogleadsV25Common__TargetingSetting:
description: Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594
type: object
properties:
targetRestrictions:
type: array
description: The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__TargetRestriction'
targetRestrictionOperations:
description: The list of operations changing the target restrictions. Adding a target restriction with a targeting dimension that already exists causes the existing target restriction to be replaced with the new value.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__TargetRestrictionOperation'
type: array
GoogleAdsGoogleadsV25Common__ManualCpm:
type: object
properties: {}
description: Manual impression-based bidding where user pays per thousand impressions.
GoogleAdsGoogleadsV25Resources_Campaign_VanityPharma:
type: object
properties:
vanityPharmaText:
description: The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
type: string
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Prescription treatment website with website content in English.
- Prescription treatment website with website content in Spanish (Sitio de tratamientos con receta).
- Prescription device website with website content in English.
- Prescription device website with website content in Spanish (Sitio de dispositivos con receta).
- Medical device website with website content in English.
- Medical device website with website content in Spanish (Sitio de dispositivos médicos).
- Preventative treatment website with website content in English.
- Preventative treatment website with website content in Spanish (Sitio de tratamientos preventivos).
- Prescription contraception website with website content in English.
- Prescription contraception website with website content in Spanish (Sitio de anticonceptivos con receta).
- Prescription vaccine website with website content in English.
- Prescription vaccine website with website content in Spanish (Sitio de vacunas con receta).
enum:
- UNSPECIFIED
- UNKNOWN
- PRESCRIPTION_TREATMENT_WEBSITE_EN
- PRESCRIPTION_TREATMENT_WEBSITE_ES
- PRESCRIPTION_DEVICE_WEBSITE_EN
- PRESCRIPTION_DEVICE_WEBSITE_ES
- MEDICAL_DEVICE_WEBSITE_EN
- MEDICAL_DEVICE_WEBSITE_ES
- PREVENTATIVE_TREATMENT_WEBSITE_EN
- PREVENTATIVE_TREATMENT_WEBSITE_ES
- PRESCRIPTION_CONTRACEPTION_WEBSITE_EN
- PRESCRIPTION_CONTRACEPTION_WEBSITE_ES
- PRESCRIPTION_VACCINE_WEBSITE_EN
- PRESCRIPTION_VACCINE_WEBSITE_ES
vanityPharmaDisplayUrlMode:
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Replace vanity pharma URL with manufacturer website url.
- Replace vanity pharma URL with description of the website.
enum:
- UNSPECIFIED
- UNKNOWN
- MANUFACTURER_WEBSITE_URL
- WEBSITE_DESCRIPTION
type: string
description: The display mode for vanity pharma URLs.
description: Describes how unbranded pharma ads will be displayed.
GoogleAdsGoogleadsV25Services__CampaignOperation:
description: A single operation (create, update, remove) on a campaign.
type: object
properties:
updateMask:
type: string
description: FieldMask that determines which resource fields are modified in an update.
format: google-fieldmask
create:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Resources__Campaign'
description: 'Create operation: No resource name is expected for the new campaign.'
update:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Resources__Campaign'
description: 'Update operation: The campaign is expected to have a valid resource name.'
remove:
description: 'Remove operation: A resource name for the removed campaign is expected, in this format: `customers/{customer_id}/campaigns/{campaign_id}`'
type: string
GoogleAdsGoogleadsV25Resources_Campaign_AssetAutomationSetting:
description: Asset automation setting contains pair of AssetAutomationType and the asset automation opt-in/out status
type: object
properties:
assetAutomationType:
x-enumDescriptions:
- Not specified.
- Used as a return value only. Represents value unknown in this version.
- Text asset automation (text customization) includes headlines and descriptions, allowing Google to create customized text assets using your existing ads, landing page copy, and generative AI across your campaign's ads. By default, advertisers are opted-in for Performance Max and opted-out for Search. Contrast this with `FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION`, which dynamically generates text assets to match the content of dynamically selected landing pages when final URL expansion is active.
- Converts horizontal video assets to vertical orientation using content-aware technology. By default, advertisers are opted in for DemandGenVideoResponsiveAdInfo.
- Shortens video assets to better capture user attention using content-aware technology. By default, advertisers are opted in for DemandGenVideoResponsiveAdInfo.
- Generates a preview of the landing page shown in the engagement panel. By using this feature, you confirm that you own all legal rights to the images on the landing page used by this account (or you have permission to share the images with Google). You hereby instruct Google to publish these images on your behalf for advertising or other commercial purposes.
- Generates text information from the landing page to be shown in the engagement panel. Opted in by default for DemandGenVideoResponsiveAdInfo.
- Generates video enhancements (vertical and shorter videos) for PMax campaigns. Opted in by default.
- Generates image enhancements (AutoCrop and AutoEnhance). Opted in by default for pmax.
- Generates image extraction. It defaults to account level Dynamic Image Extension control value.
- Adds design elements and embeds text assets into image assets to create images with different aspect ratios. By default, advertisers are opted in for DemandGenMultiAssetAd.
- Controls automation for text assets related to Final URL expansion. This includes automatically creating dynamic landing pages from the final URL and generating text assets from the content of those landing pages. This setting is turned OFF by default for Search campaigns, but it is turned ON by default for Performance Max campaigns. Enabling final URL expansion also enables text asset automation. There is no way to opt out of text asset automation and still use final URL expansion. Contrast this with standard `TEXT_ASSET_AUTOMATION` (text customization), which customizes copy across all ads in the campaign even when final URL expansion does not occur.
- Generates videos using other Assets as input, such as images and text. By default, advertisers are opted in for DemandGenMultiAssetAd.
- Generates animated images using other Assets as input, such as images and text. By default, advertisers are opted in for DemandGenMultiAssetAd.
enum:
- UNSPECIFIED
- UNKNOWN
- TEXT_ASSET_AUTOMATION
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
- GENERATE_LANDING_PAGE_PREVIEW
- GENERATE_LANDING_PAGE_TEXT
- GENERATE_ENHANCED_YOUTUBE_VIDEOS
- GENERATE_IMAGE_ENHANCEMENT
- GENERATE_IMAGE_EXTRACTION
- GENERATE_DESIGN_VERSIONS_FOR_IMAGES
- FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
- GENERATE_VIDEOS_FROM_OTHER_ASSETS
- GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS
type: string
description: The asset automation type advertiser would like to opt-in/out.
assetAutomationStatus:
description: The opt-in/out status of asset automation type.
type: string
x-enumDescriptions:
- Not specified.
- Used as a return value only. Represents value unknown in this version.
- Opted-in will enable generating and serving an asset automation type.
- Opted-out will stop generating and serving an asset automation type.
enum:
- UNSPECIFIED
- UNKNOWN
- OPTED_IN
- OPTED_OUT
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_VideoAdSequenceStep:
description: Information about a step within a video sequence.
type: object
properties:
videoAdSequenceStepId:
description: The ID of this sequence step.
type: string
format: int64
previousStepId:
type: string
description: The ID of the previous step. This field is required for all steps except the first one. It must point to a step that appears in the step definition list before this step.
format: int64
previousStepInteractionType:
type: string
description: Type of interaction *on the previous step* required in order for the user to advance to this step. As with the previous step ID, it's required for every step except for the first one.
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- The viewer engaged with or watched at least 30 seconds of the ad (or the entire ad, if it was less than 30 seconds). Only available for campaigns using Target CPM as the bidding strategy and skippable in-stream ads as the ad format.
- The viewer skipped the ad. Only available for campaigns using Target CPM as the bidding strategy and skippable in-stream ads as the ad format.
- The ad was shown to the viewer.
- An ad impression that was not immediately skipped, but didn't reach the billable event either.
enum:
- UNSPECIFIED
- UNKNOWN
- PAID_VIEW
- SKIP
- IMPRESSION
- ENGAGED_IMPRESSION
adGroupType:
description: The ad group type for this step (denoting the video format).
type: string
x-enumDescriptions:
- The type has not been specified.
- The received value is not known in this version. This is a response-only value.
- The default ad group type for Search campaigns.
- The default ad group type for Display campaigns.
- The ad group type for Shopping campaigns serving standard product ads.
- The default ad group type for Hotel campaigns.
- The type for ad groups in Smart Shopping campaigns.
- Short unskippable in-stream video ads.
- TrueView (skippable) in-stream video ads.
- TrueView in-display video ads.
- Unskippable in-stream video ads.
- Ad group type for Dynamic Search Ads ad groups.
- The type for ad groups in Shopping Comparison Listing campaigns.
- The ad group type for Promoted Hotel ad groups.
- Video responsive ad groups.
- Video efficient reach ad groups.
- Ad group type for Smart campaigns.
- Ad group type for Travel campaigns.
- Ad group type for YouTube Audio campaigns.
enum:
- UNSPECIFIED
- UNKNOWN
- SEARCH_STANDARD
- DISPLAY_STANDARD
- SHOPPING_PRODUCT_ADS
- HOTEL_ADS
- SHOPPING_SMART_ADS
- VIDEO_BUMPER
- VIDEO_TRUE_VIEW_IN_STREAM
- VIDEO_TRUE_VIEW_IN_DISPLAY
- VIDEO_NON_SKIPPABLE_IN_STREAM
- SEARCH_DYNAMIC_ADS
- SHOPPING_COMPARISON_LISTING_ADS
- PROMOTED_HOTEL_ADS
- VIDEO_RESPONSIVE
- VIDEO_EFFICIENT_REACH
- SMART_CAMPAIGN_ADS
- TRAVEL_ADS
- YOUTUBE_AUDIO
assetId:
type: string
description: The ID of the Asset for this step. The asset must be type YOUTUBE_VIDEO.
format: int64
GoogleAdsGoogleadsV25Services__BrandCampaignAssets:
type: object
properties:
businessNameAsset:
type: string
description: Required. The resource name of the business name text asset.
logoAsset:
type: array
description: Required. The resource name of square logo assets.
items:
type: string
landscapeLogoAsset:
type: array
description: Optional. The resource name of landscape logo assets.
items:
type: string
description: Assets linked at the campaign level. A business_name and at least one logo_asset are required.
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_NonSkippableInStreamRestrictions:
description: Restrictions for non-skippable format.
type: object
properties:
minDuration:
description: The minimum allowed duration for non-skippable ads.
type: string
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Indicates that non-skippable ads must be at least 5 seconds long.
- Indicates that non-skippable ads must be at least 7 seconds long.
- Indicates that non-skippable ads must be at least 16 seconds long.
- Indicates that non-skippable ads must be at least 31 seconds long.
enum:
- UNSPECIFIED
- UNKNOWN
- MIN_DURATION_FIVE_SECONDS
- MIN_DURATION_SEVEN_SECONDS
- MIN_DURATION_SIXTEEN_SECONDS
- MIN_DURATION_THIRTY_ONE_SECONDS
maxDuration:
type: string
description: The maximum allowed duration for non-skippable ads.
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Indicates that non-skippable ads must be at most 15 seconds long.
- Indicates that non-skippable ads must be at most 30 seconds long.
- Indicates that non-skippable ads must be at most 60 seconds long.
enum:
- UNSPECIFIED
- UNKNOWN
- MAX_DURATION_FIFTEEN_SECONDS
- MAX_DURATION_THIRTY_SECONDS
- MAX_DURATION_SIXTY_SECONDS
GoogleAdsGoogleadsV25Resources_Campaign_TravelCampaignSettings:
type: object
properties:
travelAccountId:
description: Immutable. The Travel account ID associated with the Travel campaign.
type: string
format: int64
description: Settings for Travel campaign.
GoogleAdsGoogleadsV25Common__CampaignThirdPartyIntegrationPartners:
type: object
properties:
brandSafetyIntegrationPartners:
type: array
description: Third party integration partners for brand safety verification for this Campaign.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__CampaignThirdPartyBrandSafetyIntegrationPartner'
conversionAttributionIntegrationPartners:
type: array
description: Third party integration partners for YouTube conversion attribution verification for this Campaign.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__CampaignThirdPartyConversionAttributionIntegrationPartner'
brandLiftIntegrationPartners:
description: Third party integration partners for Brand Lift verification for this Campaign.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__CampaignThirdPartyBrandLiftIntegrationPartner'
type: array
viewabilityIntegrationPartners:
type: array
description: Third party integration partners for YouTube viewability verification for this Campaign.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__CampaignThirdPartyViewabilityIntegrationPartner'
reachIntegrationPartners:
description: Third party integration partners for reach verification for this Campaign.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__CampaignThirdPartyReachIntegrationPartner'
type: array
description: Container for Campaign level third party integration partners.
GoogleAdsGoogleadsV25Common__FixedCpm:
type: object
properties:
goal:
type: string
description: Fixed CPM bidding goal. Determines the exact bidding optimization parameters.
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Maximize reach, that is the number of users who saw the ads in this campaign.
- Target Frequency CPM bidder. Optimize bidding to reach a single user with the requested frequency.
enum:
- UNSPECIFIED
- UNKNOWN
- REACH
- TARGET_FREQUENCY
targetFrequencyInfo:
description: Target frequency bidding goal details.
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__FixedCpmTargetFrequencyGoalInfo'
description: Fixed CPM (cost per thousand impression) bidding strategy. A manual bidding strategy with a fixed CPM.
GoogleAdsGoogleadsV25Resources_Campaign_LocalServicesCampaignSettings:
description: Settings for LocalServicesCampaign subresource.
type: object
properties:
categoryBids:
type: array
description: Categorical level bids associated with MANUAL_CPA bidding strategy.
items:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Resources_Campaign_CategoryBid'
GoogleAdsGoogleadsV25Resources_Campaign_SelectiveOptimization:
description: Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
type: object
properties:
conversionActions:
description: The selected set of resource names for conversion actions for optimizing this campaign.
items:
type: string
type: array
GoogleAdsGoogleadsV25Services__EnableOperation:
type: object
properties:
campaign:
description: Required. The resource name of the campaign to enable.
type: string
accentColor:
description: 'Optional. Hex code representation of the accent brand color, for example #00ff00. accent_color is required when main_color is specified.'
type: string
brandAssets:
$ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__BrandCampaignAssets'
description: Optional. The brand assets linked to the campaign. This field is required when the value of auto_populate_brand_assets is false.
fontFamily:
type: string
description: 'Optional. The font family is specified as a string, and must be one of the following: "Open Sans", "Roboto", "Roboto Slab", "Montserrat", "Poppins", "Lato", "Oswald", or "Playfair Display".'
autoPopulateBrandAssets:
description: Required. The switch to automatically populate top-performing brand assets. This field is required. If true, top-performing brand assets will be automatically populated. If false, the brand_assets field is required.
type: boolean
mainColor:
type: string
description: 'Optional. Hex code representation of the main brand color, for example #00ff00. main_color is required when accent color is specified.'
finalUriDomain:
description: Optional. The domain of the final uri.
type: string
description: A single enable operation of a campaign.
GoogleAdsGoogleadsV25Resources_CampaignVideoCampaignSettings_BookingDetails:
description: Container for booking details for campaigns with the FIXED_CPM or FIXED_SHARE_OF_VOICE bidding strategies.
type: object
properties:
holdExpirationDateTime:
type: string
description: Output only. Time until which booked inventory will be held or has been held for this campaign. Available for status HELD and HOLD_EXPIRED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone.
cancellationDateTime:
description: Output only. Time when the booked inventory of this campaign will be cancelled or has been cancelled. Available for primary status NOT_ELIGIBLE if the campaign will be cancelled and for primary status reason BOOKING_CANCELLED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone.
type: string
status:
description: Output only. The status of the booking.
type: string
enum:
- UNSPECIFIED
- UNKNOWN
- BOOKED
- HELD
- CAMPAIGN_ENDED
- HOLD_EXPIRED
- BOOKING_CANCELLED
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- The booking is active and holds inventory for the campaign.
- The campaign is holding inventory, but the booking is not confirmed.
- The campaign has ended and is no longer holding inventory.
- The hold on the inventory has expired.
- The campaign was booked, but was in a non-servable state for too long and the booking was cancelled by the system.
GoogleAdsGoogleadsV25Common__RealTimeBiddingSetting:
description: Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
type: object
properties:
optIn:
type: boolean
description: Whether the campaign is opted in to real-time bidding.
GoogleAdsGoogleadsV25Resources_Campaign_AppCampaignSetting:
description: Campaign-level settings for App Campaigns.
type: object
properties:
biddingStrategyGoalType:
x-enumDescriptions:
- Not specified.
- Used for return value only. Represents value unknown in this version.
- Aim to maximize the number of app installs. The cpa bid is the target cost per install.
- Aim to maximize the long term number of selected in-app conversions from app installs. The cpa bid is the target cost per install.
- Aim to maximize the long term number of selected in-app conversions from app installs. The cpa bid is the target cost per in-app conversion. Note that the actual cpa may seem higher than the target cpa at first, since the long term conversions haven't happened yet.
- Aim to maximize all conversions' value, for example, install + selected in-app conversions while achieving or exc
# --- truncated at 32 KB (134 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google-ads/refs/heads/main/openapi/google-ads-customers-campaigns-api-openapi.yml