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

The customers.recommendations API from Google Ads — 3 operation(s) for customers.recommendations.

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

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

3 operations 3 paths 207 schemas 3 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.recommendations 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 3

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

customers.recommendations 3
POST
/v25/customers/{customersId}/recommendations:apply
Applies given recommendations with corresponding apply parameters
googleads_customers_recommendations_apply 12 params body → 200
POST
/v25/customers/{customersId}/recommendations:generate
Generates Recommendations based off the requested recommendationtypes
googleads_customers_recommendations_generate 12 params body → 200
POST
/v25/customers/{customersId}/recommendations:dismiss
Dismisses given recommendations
googleads_customers_recommendations_dismiss 12 params body → 200

Schemas 207

The contract defines 207 schemas that model the data the API accepts and returns. The most detailed are GoogleAdsGoogleadsV25Resources__Recommendation (62 properties), GoogleAdsGoogleadsV25Resources__Asset (44 properties), GoogleAdsGoogleadsV25Resources__Ad (41 properties), GoogleAdsGoogleadsV25Services__ApplyRecommendationOperation (25 properties). Each schema is shown below with its type and property counts.

GoogleAdsGoogleadsV25Resources_Recommendation_MerchantInfo
object
The Merchant Center account details.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_RecommendationImpact
object
The impact of making the change as described in the recommendation. Some types of recommendations may not have impact information.
2 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_CalloutAssetParameters
object
Parameters to use when applying callout asset recommendations.
1 property
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_TextList
object
A list of fragments of text that violated a policy.
1 property
GoogleAdsGoogleadsV25Common__UrlCollection
object
Collection of urls that is tagged with a unique identifier.
4 properties
GoogleAdsGoogleadsV25Resources_Recommendation_EnhancedCpcOptInRecommendation
object
The Enhanced Cost-Per-Click Opt-In recommendation.
GoogleAdsGoogleadsV25Common__YouTubeAudioAdInfo
object
Representation of YouTube Audio ad format.
GoogleAdsGoogleadsV25Common__PriceOffering
object
A single price offering within a PriceAsset.
6 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
GoogleAdsGoogleadsV25Resources__AssetFieldTypePolicySummary
object
Contains policy information for an asset under AssetFieldType context.
3 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_ForecastingSetTargetCpaParameters
object
Parameters to use when applying a set target CPA recommendation.
2 properties
GoogleAdsGoogleadsV25Common__DemandGenCarouselAdInfo
object
A Demand Gen carousel ad.
6 properties
GoogleAdsGoogleadsV25Common__DemandGenCarouselCardAsset
object
A Demand Gen Carousel Card asset.
5 properties
GoogleAdsGoogleadsV25Resources_RecommendationKeywordRecommendation_SearchTerm
object
Information about a search term as related to a keyword recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_MoveUnusedBudgetRecommendation
object
The move unused budget recommendation.
2 properties
GoogleAdsGoogleadsV25Common__WhatsappBusinessMessageInfo
object
Whatsapp information to use for messaging.
2 properties
GoogleAdsGoogleadsV25Services__DismissRecommendationRequest
object
Request message for RecommendationService.DismissRecommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_RaiseTargetCpaBidTooLowRecommendation
object
The raise target CPA bid too low recommendation.
2 properties
GoogleAdsGoogleadsV25Common__LeadFormDeliveryMethod
object
A configuration of how leads are delivered to the advertiser.
1 property
GoogleAdsGoogleadsV25Common__DynamicTravelAsset
object
A dynamic travel asset.
17 properties
GoogleAdsGoogleadsV25Common__Money
object
Represents a price in a particular currency.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_LeadFormAssetRecommendation
object
The lead form asset recommendation.
GoogleAdsGoogleadsV25Common__YoutubeVideoAsset
object
A YouTube asset.
2 properties
GoogleAdsGoogleadsV25Common__PriceAsset
object
An asset representing a list of price offers.
4 properties
GoogleAdsGoogleadsV25Common__LegacyAppInstallAdInfo
object
A legacy app install ad that only can be used by a few select customers.
5 properties
GoogleAdsGoogleadsV25Services__GenerateRecommendationsRequest
object
Request message for RecommendationService.GenerateRecommendations.
19 properties
GoogleAdsGoogleadsV25Resources__Recommendation
object
A recommendation.
62 properties
GoogleAdsGoogleadsV25Common__TextAsset
object
A Text asset.
1 property
GoogleAdsGoogleadsV25Common__ExpandedDynamicSearchAdInfo
object
An expanded dynamic search ad.
2 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_MoveUnusedBudgetParameters
object
Parameters to use when applying move unused budget recommendation.
1 property
GoogleAdsGoogleadsV25Common__HotelAdInfo
object
A hotel ad.
GoogleAdsGoogleadsV25Common__DemandGenVideoResponsiveAdInfo
object
A Demand Gen video responsive ad.
10 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_KeywordParameters
object
Parameters to use when applying keyword recommendation.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingMerchantCenterAccountSuspensionRecommendation
object
The shopping recommendation to fix Merchant Center account suspension issues.
2 properties
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
GoogleAdsGoogleadsV25Resources__AssetPolicySummary
object
Contains policy information for an asset.
3 properties
GoogleAdsGoogleadsV25Common__HotelCalloutAsset
object
An asset representing a hotel callout.
2 properties
GoogleAdsGoogleadsV25Common__PromotionAsset
object
A Promotion asset.
17 properties
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__LeadFormField
object
One input field instance within a form.
3 properties
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_BudgetInfo
object
Current budget information of the campaign.
1 property
GoogleAdsGoogleadsV25Common__FacebookMessengerBusinessMessageInfo
object
Facebook Messenger information to use for messaging.
1 property
GoogleAdsGoogleadsV25Common__StructuredSnippetAsset
object
A Structured Snippet asset.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ForecastingSetTargetRoasRecommendation
object
The forecasting set target ROAS recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_SearchPartnersOptInRecommendation
object
The Search Partners Opt-In recommendation.
GoogleAdsGoogleadsV25Common__VideoResponsiveAdInfo
object
A video responsive ad.
10 properties
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__AdScheduleInfo
object
Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSched…
5 properties
GoogleAdsGoogleadsV25Common__CallAsset
object
A Call asset.
5 properties
GoogleAdsGoogleadsV25Common__InFeedVideoAdInfo
object
Representation of In-feed video ad format.
4 properties
GoogleAdsGoogleadsV25Common__BusinessMessageCallToActionInfo
object
Display information that encourages the user to take action.
2 properties
GoogleAdsGoogleadsV25Services__ApplyRecommendationOperation
object
Information about the operation to apply a recommendation and any parameters to customize it.
25 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_RaiseTargetCpaParameters
object
Parameters to use when applying raise Target CPA recommendations.
1 property
GoogleAdsGoogleadsV25Common__DynamicLocalAsset
object
A dynamic local asset.
16 properties
GoogleAdsGoogleadsV25Resources_Recommendation_MaximizeConversionValueOptInRecommendation
object
Recommendation to opt into Maximize Conversion Value bidding strategy.
GoogleAdsGoogleadsV25Common__LegacyResponsiveDisplayAdInfo
object
A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI.
15 properties
GoogleAdsGoogleadsV25Common__PageFeedAsset
object
A Page Feed asset.
2 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_UseBroadMatchKeywordParameters
object
Parameters to use when applying a use broad match keyword recommendation.
1 property
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_TargetCpaOptInParameters
object
Parameters to use when applying Target CPA recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_RecommendationTargetCpaOptInRecommendation_TargetCpaOptInRecommendationOption
object
The Target CPA opt-in option with impact estimate.
4 properties
GoogleAdsGoogleadsV25Common__DynamicFlightsAsset
object
A dynamic flights asset.
15 properties
GoogleAdsGoogleadsV25Common__PromotionQrCodeInfo
object
QR code info to generate promotion QR code.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_AccountInfo
object
Wrapper for information about a Google Ads account.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_RecommendationMetrics
object
Weekly account performance metrics. For some recommendation types, these are averaged over the past 90-day period and hence can be fractional.
6 properties
GoogleAdsGoogleadsV25Common__FinalAppUrl
object
A URL for deep linking into an app for the given operating system.
2 properties
GoogleAdsGoogleadsV25Common__ImageDimension
object
Metadata for an image at a certain size, either original or resized.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ImproveGoogleTagCoverageRecommendation
object
Recommendation to deploy Google Tag on more pages.
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_CampaignBudgetParameters
object
Parameters to use when applying a campaign budget recommendation.
1 property
GoogleAdsGoogleadsV25Common__CallFeedItem
object
Represents a Call extension.
6 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ResponsiveSearchAdAssetRecommendation
object
The add responsive search ad asset recommendation.
2 properties
GoogleAdsGoogleadsV25Common__AdTextAsset
object
A text asset used inside an ad.
4 properties
GoogleAdsGoogleadsV25Resources_Recommendation_TargetAdjustmentInfo
object
Information of a target adjustment recommendation.
3 properties
GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_ResellerConstraint
object
Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes.
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_CallAssetParameters
object
Parameters to use when applying call asset recommendations.
1 property
GoogleAdsGoogleadsV25Common__ShoppingProductAdInfo
object
A standard Shopping ad.
GoogleAdsGoogleadsV25Common__SmartCampaignAdInfo
object
A Smart campaign ad.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingOfferAttributeRecommendation
object
The shopping recommendation to add an attribute to offers that are demoted because it is missing.
4 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationTextList
object
A list of strings found in a destination page that caused a policy finding.
1 property
GoogleAdsGoogleadsV25Common__LocationAsset
object
A location asset.
3 properties
GoogleAdsGoogleadsV25Common__DemandGenProductAdInfo
object
A Demand Gen product ad.
7 properties
GoogleAdsGoogleadsV25Common__BusinessMessageAsset
object
A business message asset.
6 properties
GoogleAdsGoogleadsV25Common__ResponsiveDisplayAdControlSpec
object
Specification for various creative controls for a responsive display ad.
2 properties
GoogleAdsGoogleadsV25Services__DismissRecommendationResponse
object
Response message for RecommendationService.DismissRecommendation.
2 properties
GoogleAdsGoogleadsV25Common__AdCallToActionAsset
object
A call to action asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__MediaBundleAsset
object
A MediaBundle asset.
1 property
GoogleAdsGoogleadsV25Common__DynamicJobsAsset
object
A dynamic jobs asset.
14 properties
GoogleAdsGoogleadsV25Resources_Recommendation_CampaignBudgetRecommendation
object
The budget recommendation for budget constrained campaigns.
3 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_LeadFormAssetParameters
object
Parameters to use when applying a lead form asset recommendation.
2 properties
GoogleAdsGoogleadsV25Common__VideoNonSkippableInStreamAdInfo
object
Representation of video non-skippable in-stream ad format (15 second in-stream non-skippable video ad).
3 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_ResponsiveSearchAdParameters
object
Parameters to use when applying a responsive search ad recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_ResponsiveSearchAdImproveAdStrengthRecommendation
object
The responsive search ad improve ad strength recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ImprovePerformanceMaxAdStrengthRecommendation
object
Recommendation to improve the asset group strength of a Performance Max campaign to an "Excellent" rating.
2 properties
GoogleAdsGoogleadsV25Common__PolicyTopicConstraint
object
Describes the effect on serving that a policy topic entry will have.
4 properties
GoogleAdsGoogleadsV25Resources_Recommendation_OptimizeAdRotationRecommendation
object
The Optimize Ad Rotation recommendation.
GoogleAdsGoogleadsV25Common__AppAdInfo
object
An app ad.
7 properties
GoogleAdsGoogleadsV25Services__ApplyRecommendationRequest
object
Request message for RecommendationService.ApplyRecommendation.
2 properties
GoogleAdsGoogleadsV25Common__PromotionBarcodeInfo
object
Barcode info to generate promotion barcode.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_KeywordMatchTypeRecommendation
object
The keyword match type recommendation.
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
GoogleAdsGoogleadsV25Services_DismissRecommendationResponse_DismissRecommendationResult
object
The result of dismissing a recommendation.
1 property
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
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_LowerTargetRoasParameters
object
Parameters to use when applying lower Target ROAS recommendations.
1 property
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
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_TargetRoasOptInParameters
object
Parameters to use when applying a Target ROAS opt-in recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_MaximizeConversionsOptInRecommendation
object
The Maximize Conversions Opt-In recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_TextAdRecommendation
object
The text ad recommendation.
3 properties
GoogleAdsGoogleadsV25Common__AppDeepLinkAsset
object
An app deep link asset
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_DisplayExpansionOptInRecommendation
object
The Display Expansion opt-in recommendation.
GoogleAdsGoogleadsV25Common__LocalAdInfo
object
A local ad.
8 properties
GoogleAdsGoogleadsV25Resources_RecommendationCampaignBudgetRecommendation_CampaignBudgetRecommendationOption
object
The impact estimates for a given budget amount.
2 properties
GoogleAdsGoogleadsV25Common__KeywordInfo
object
A keyword criterion.
2 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__MobileAppAsset
object
An asset representing a mobile app.
5 properties
GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationMismatch
object
Evidence of mismatches between the URLs of a resource.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_CustomAudienceOptInRecommendation
object
The Custom Audience Opt In recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_TargetRoasOptInRecommendation
object
The Target ROAS opt-in recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingFixDisapprovedProductsRecommendation
object
The shopping recommendation to fix disapproved products in a Shopping Campaign Inventory.
4 properties
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__WebhookDelivery
object
Google notifies the advertiser of leads by making HTTP calls to an endpoint they specify. The requests contain JSON matching a schema that Google publishes as…
3 properties
GoogleAdsGoogleadsV25Common__DynamicCustomAsset
object
A dynamic custom asset.
17 properties
GoogleAdsGoogleadsV25Common__CalloutAsset
object
A Callout asset.
4 properties
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_BiddingInfo
object
Current bidding information of the campaign. Provides a wrapper for bidding-related signals that inform recommendations.
4 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ImproveDemandGenAdStrengthRecommendation
object
The improve Demand Gen ad strength recommendation.
3 properties
GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraintList
object
A list of countries where a resource's serving is constrained.
2 properties
GoogleAdsGoogleadsV25Services__ApplyRecommendationResult
object
The result of applying a recommendation.
1 property
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
GoogleAdsGoogleadsV25Resources_Recommendation_RaiseTargetCpaRecommendation
object
Recommendation to raise Target CPA.
2 properties
GoogleAdsGoogleadsV25Common__LeadFormAsset
object
A Lead Form asset.
15 properties
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_AdGroupInfo
object
Current AdGroup Information of the campaign.
2 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
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_CalloutExtensionParameters
object
Parameters to use when applying callout extension recommendation.
1 property
GoogleAdsGoogleadsV25Services_DismissRecommendationRequest_DismissRecommendationOperation
object
Operation to dismiss a single recommendation identified by resourcename.
1 property
GoogleAdsGoogleadsV25Common__ZaloBusinessMessageInfo
object
Zalo information to use for messaging.
2 properties
GoogleAdsGoogleadsV25Common__AdAssetPolicySummary
object
Contains policy information for an asset inside an ad.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ForecastingSetTargetCpaRecommendation
object
The set target CPA recommendations.
2 properties
GoogleAdsGoogleadsV25Common__SitelinkAsset
object
A Sitelink asset.
6 properties
GoogleAdsGoogleadsV25Common__ShoppingComparisonListingAdInfo
object
A Shopping Comparison Listing ad.
1 property
GoogleAdsGoogleadsV25Common__ResponsiveDisplayAdInfo
object
A responsive display ad.
17 properties
GoogleAdsGoogleadsV25Resources_Recommendation_UpgradeLocalCampaignToPerformanceMaxRecommendation
object
The Upgrade Local campaign to Performance Max campaign recommendation.
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_AssetGroupInfo
object
Current AssetGroup information of the campaign.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingAddProductsToCampaignRecommendation
object
The shopping recommendation to add products to a Shopping Campaign Inventory.
3 properties
GoogleAdsGoogleadsV25Resources__Asset
object
Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and c…
44 properties
GoogleAdsGoogleadsV25Common__ImageAdInfo
object
An image ad.
11 properties
GoogleAdsGoogleadsV25Common__CallToActionAsset
object
A call to action asset.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
object
The Dynamic Search Ads to Performance Max migration recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_DynamicImageExtensionOptInRecommendation
object
Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.
GoogleAdsGoogleadsV25Resources_Recommendation_LowerTargetRoasRecommendation
object
Recommendation to lower Target ROAS.
1 property
GoogleAdsGoogleadsV25Common__DemandGenMultiAssetAdInfo
object
A Demand Gen multi asset ad.
10 properties
GoogleAdsGoogleadsV25Common__LeadFormSingleChoiceAnswers
object
Defines possible answers for a single choice question, usually presented as a single-choice drop-down list.
1 property
GoogleAdsGoogleadsV25Common__DynamicEducationAsset
object
A Dynamic Education asset.
14 properties
GoogleAdsGoogleadsV25Common__ShoppingSmartAdInfo
object
A Smart Shopping ad.
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_SitelinkAssetParameters
object
Parameters to use when applying sitelink asset recommendations.
1 property
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_ForecastingSetTargetRoasParameters
object
Parameters to use when applying a forecasting set target roas recommendation.
2 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_CallExtensionParameters
object
Parameters to use when applying call extension recommendation.
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
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
object
The shopping recommendation to migrate Regular Shopping Campaign targeted offers to Performance Max campaigns.
2 properties
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_TargetImpressionShareInfo
object
Current Target Impression Share information of the campaign.
3 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_RaiseTargetCpaBidTooLowParameters
object
Parameters to use when applying a raise target CPA bid too low recommendation. The apply is asynchronous and can take minutes depending on the number of ad gro…
1 property
GoogleAdsGoogleadsV25Common__LeadFormCustomQuestionField
object
One custom question input field instance within a form.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_KeywordRecommendation
object
The keyword recommendation.
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_TargetCpaOptInRecommendation
object
The Target CPA opt-in recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_RefreshCustomerMatchListRecommendation
object
The recommendation to update a customer list that hasn't been updated in the last 90 days. The customer receiving the recommendation is not necessarily the own…
6 properties
GoogleAdsGoogleadsV25Resources_Recommendation_UseBroadMatchKeywordRecommendation
object
The use broad match keyword recommendation.
5 properties
GoogleAdsGoogleadsV25Resources_Recommendation_UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
object
The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.
2 properties
GoogleAdsGoogleadsV25Resources_Recommendation_CampaignBudget
object
A campaign budget shared amongst various budget recommendation types.
3 properties
GoogleAdsGoogleadsV25Common__HotelPropertyAsset
object
A hotel property asset.
3 properties
GoogleAdsGoogleadsV25Services__ApplyRecommendationResponse
object
Response message for RecommendationService.ApplyRecommendation.
2 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
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_ResponsiveSearchAdImproveAdStrengthParameters
object
Parameters to use when applying a responsive search ad improve ad strength recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_PerformanceMaxFinalUrlOptInRecommendation
object
Recommendation to turn on Final URL expansion for your Performance Max campaigns.
GoogleAdsGoogleadsV25Resources_Recommendation_ShoppingTargetAllOffersRecommendation
object
The shopping recommendation to create a catch-all campaign that targets all offers.
3 properties
GoogleAdsGoogleadsV25Common__SitelinkFeedItem
object
Represents a sitelink.
8 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_SitelinkExtensionParameters
object
Parameters to use when applying sitelink recommendation.
1 property
GoogleAdsGoogleadsV25Common__AdVideoAssetLinkFeatureControl
object
YouTube Video Asset feature controls.
1 property
GoogleAdsGoogleadsV25Common__DynamicRealEstateAsset
object
A dynamic real estate asset.
15 properties
GoogleAdsGoogleadsV25Resources__Ad
object
An ad.
41 properties
GoogleAdsGoogleadsV25Resources_Recommendation_CallAssetRecommendation
object
The call asset recommendation.
GoogleAdsGoogleadsV25Services__GenerateRecommendationsResponse
object
Response message for RecommendationService.GenerateRecommendations.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_ResponsiveSearchAdRecommendation
object
The add responsive search ad recommendation.
1 property
GoogleAdsGoogleadsV25Common__DynamicHotelsAndRentalsAsset
object
A dynamic hotels and rentals asset.
17 properties
GoogleAdsGoogleadsV25Common__BookOnGoogleAsset
object
A Book on Google asset. Used to redirect user to book through Google. Book on Google will change the redirect url to book directly through Google.
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_TextAdParameters
object
Parameters to use when applying a text ad recommendation.
1 property
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_ResponsiveSearchAdAssetParameters
object
Parameters to use when applying a responsive search ad asset recommendation.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_CalloutAssetRecommendation
object
The callout asset recommendation.
2 properties
GoogleAdsGoogleadsV25Common__SyntheticContentAttestation
object
Represents an attestation about synthetic content from a single source.
2 properties
GoogleAdsGoogleadsV25Common__AdImageAsset
object
An image asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Services_GenerateRecommendationsRequest_SeedInfo
object
A keyword seed and a specific url to generate keywords from.
2 properties
GoogleAdsGoogleadsV25Common__CalloutFeedItem
object
Represents a callout extension.
1 property
GoogleAdsGoogleadsV25Common__BusinessProfileLocation
object
Business Profile location data synced from the linked Business Profile account.
3 properties
GoogleAdsGoogleadsV25Common__VideoAdInfo
object
A video ad.
7 properties
GoogleAdsGoogleadsV25Resources_Recommendation_PerformanceMaxOptInRecommendation
object
The Performance Max Opt In recommendation.
GoogleAdsGoogleadsV25Common__VideoBumperInStreamAdInfo
object
Representation of video bumper in-stream ad format (very short in-stream non-skippable video ad).
3 properties
GoogleAdsGoogleadsV25Resources_Recommendation_SitelinkAssetRecommendation
object
The sitelink asset recommendation.
2 properties
GoogleAdsGoogleadsV25Common__AdAppDeepLinkAsset
object
An app deep link used inside an ad.
1 property
GoogleAdsGoogleadsV25Common__AdMediaBundleAsset
object
A media bundle asset used inside an ad.
1 property
GoogleAdsGoogleadsV25Resources_Recommendation_MaximizeClicksOptInRecommendation
object
The Maximize Clicks opt-in recommendation.
1 property
GoogleAdsGoogleadsV25Common__ImageAsset
object
An Image asset.
4 properties
GoogleAdsGoogleadsV25Common__YouTubeVideoListAsset
object
A YouTube video list asset.
1 property
GoogleAdsGoogleadsV25Common__AdVideoAssetInfo
object
Contains info fields for AdVideoAssets.
2 properties
GoogleAdsGoogleadsV25Services_ApplyRecommendationOperation_AdAssetApplyParameters
object
Common parameters used when applying ad asset recommendations.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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