> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateRecommendationsRequest).

Request message for `RecommendationService.GenerateRecommendations`.

[Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/services/recommendation_service.proto)

| Fields ||
|---|---|
| ## `ad_group_info[]` | `AdGroupInfo` Optional. Current AdGroup Information. Supports information from a single AdGroup. This field is optional for the following recommendation_types: KEYWORD This field is required for the following recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH |
| ## `advertising_channel_type` | `AdvertisingChannelType` Required. Advertising channel type of the campaign. The following advertising_channel_types are supported for recommendation generation: PERFORMANCE_MAX and SEARCH |
| ## `asset_group_info[]` | `AssetGroupInfo` Optional. Current AssetGroup Information. This field is required for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `bidding_info` | `BiddingInfo` Optional. Current bidding information of the campaign. This field is necessary for the following recommendation_types: CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN |
| ## `budget_info` | `BudgetInfo` Optional. Current budget information. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `campaign_call_asset_count` | `int32` Optional. Current campaign call asset count. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `campaign_image_asset_count` | `int32` Optional. Current campaign image asset count. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `campaign_sitelink_count` | `int32` Optional. Number of sitelinks on the campaign. This field is necessary for the following recommendation_types: SITELINK_ASSET |
| ## `conversion_tracking_status` | `ConversionTrackingStatus` Optional. Current conversion tracking status. This field is necessary for the following recommendation_types: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN |
| ## `country_codes[]` | `string` Optional. Current campaign country codes. This field is required for the following recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH |
| ## `customer_id` | `string` Required. The ID of the customer generating recommendations. |
| ## `is_new_customer` | `bool` Optional. Whether or not this customer should be treated as a "new" customer (that is, a customer who has not yet created a campaign). Setting this to `true` will cause the backend to generate recommendations using a dedicated recommendation model for onboarding new customers, as opposed to the default model for existing customers. This is only recommended for customers with 0 campaigns. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `language_codes[]` | `string` Optional. Current campaign language codes. This field is required for the following recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH |
| ## `merchant_center_account_id` | `int64` Optional. Merchant Center account ID. This field should only be set when advertising_channel_type is PERFORMANCE_MAX. Setting this field causes RecommendationService to generate recommendations for Performance Max for retail instead of standard Performance Max. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `negative_locations_ids[]` | `int64` Optional. Current campaign negative location ids. One of this field OR positive_location_ids is required for the following recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH |
| ## `positive_locations_ids[]` | `int64` Optional. Current campaign positive location ids. One of this field OR negative_location_ids is required for the following recommendation_types: CAMPAIGN_BUDGET if AdvertisingChannelType is SEARCH |
| ## `recommendation_types[]` | `RecommendationType` Required. List of eligible recommendation_types to generate. If the uploaded criteria isn't sufficient to make a recommendation, or the campaign is already in the recommended state, no recommendation will be returned for that type. Generally, a recommendation is returned if all required fields for that recommendation_type are uploaded, but there are cases where this is still not sufficient. The following recommendation_types are supported for recommendation generation: CAMPAIGN_BUDGET, KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN |
| ## `seed_info` | `SeedInfo` Optional. Seed information for Keywords. This field is necessary for the following recommendation_types: KEYWORD |
| ## `target_content_network` | `bool` Optional. If true, the campaign is opted into serving ads on specified placements in the Google Display Network. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |
| ## `target_partner_search_network` | `bool` Optional. If true, the campaign is opted into serving ads on the Google Partner Network. This field is optional for the following recommendation_types: CAMPAIGN_BUDGET |