--- title: "POST /v23/customers/{customersId}:suggestSmartCampaignBudgetOptions" method: POST path: "/v23/customers/{customersId}:suggestSmartCampaignBudgetOptions" tags: ["customers"] --- # POST /v23/customers/{customersId}:suggestSmartCampaignBudgetOptions `POST /v23/customers/{customersId}:suggestSmartCampaignBudgetOptions` ## Request - Base URL: `https://searchads360.googleapis.com` - URL: `https://searchads360.googleapis.com/v23/customers/{customersId}:suggestSmartCampaignBudgetOptions` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/doubleclicksearch` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns BudgetOption suggestions. ## Path parameters - `customersId` string, required ## Request body - GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsRequest: Request message for SmartCampaignSuggestService.SuggestSmartCampaignBudgetOptions. - `campaign` string: Required. The resource name of the campaign to get suggestion for. - `suggestionInfo` GoogleAdsSearchads360V23ServicesSmartCampaignSuggestionInfo: Information needed to get suggestion for Smart Campaign. More information provided will help the system to derive better suggestions. - `adSchedules` GoogleAdsSearchads360V23CommonAdScheduleInfo[]: Optional. The business ad schedule. - `dayOfWeek` 'UNSPECIFIED' | 'UNKNOWN' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY': Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. - `endHour` integer: Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. - `endMinute` 'UNSPECIFIED' | 'UNKNOWN' | 'ZERO' | 'FIFTEEN' | 'THIRTY' | 'FORTY_FIVE': Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. - `startHour` integer: Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. - `startMinute` 'UNSPECIFIED' | 'UNKNOWN' | 'ZERO' | 'FIFTEEN' | 'THIRTY' | 'FORTY_FIVE': Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. - `businessContext` GoogleAdsSearchads360V23ServicesSmartCampaignSuggestionInfoBusinessContext: A context that describes a business. - `businessName` string: Optional. The name of the business. - `businessProfileLocation` string: Optional. The resource name of a Business Profile location. Business Profile location resource names can be fetched through the Business Profile API and adhere to the following format: `locations/{locationId}`. See the [Business Profile API] (https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations) for additional details. - `finalUrl` string: Optional. Landing page URL of the campaign. - `keywordThemes` GoogleAdsSearchads360V23CommonKeywordThemeInfo[]: Optional. Smart campaign keyword themes. This field may greatly improve suggestion accuracy and we recommend always setting it if possible. - `freeFormKeywordTheme` string: Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis. - `keywordThemeConstant` string: The resource name of a Smart Campaign keyword theme constant. `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}` - `languageCode` string: Optional. The two letter advertising language for the Smart campaign to be constructed, default to 'en' if not set. - `locationList` GoogleAdsSearchads360V23ServicesSmartCampaignSuggestionInfoLocationList: A list of locations. - `locations` GoogleAdsSearchads360V23CommonLocationInfo[]: Required. Locations. - `geoTargetConstant` string: The geo target constant resource name. - `proximity` GoogleAdsSearchads360V23CommonProximityInfo: A Proximity criterion. The geo point and radius determine what geographical area is included. The address is a description of the geo point that does not affect ad serving. There are two ways to create a proximity. First, by setting an address and radius. The geo point will be automatically computed. Second, by setting a geo point and radius. The address is an optional label that won't be validated. - `address` GoogleAdsSearchads360V23CommonAddressInfo: Address for proximity criterion. - `cityName` string: Name of the city. - `countryCode` string: Country code. - `postalCode` string: Postal code. - `provinceCode` string: Province or state code. - `provinceName` string: Province or state name. - `streetAddress` string: Street address line 1. - `streetAddress2` string: Street address line 2. This field is write-only. It is only used for calculating the longitude and latitude of an address when geo_point is empty. - `geoPoint` GoogleAdsSearchads360V23CommonGeoPointInfo: Geo point for proximity criterion. - `latitudeInMicroDegrees` integer: Micro degrees for the latitude. - `longitudeInMicroDegrees` integer: Micro degrees for the longitude. - `radius` number, double: The radius of the proximity. - `radiusUnits` 'UNSPECIFIED' | 'UNKNOWN' | 'MILES' | 'KILOMETERS': The unit of measurement of the radius. Default is KILOMETERS. ## Response `200` Successful response - GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponse: Response message for SmartCampaignSuggestService.SuggestSmartCampaignBudgetOptions. Depending on whether the system could suggest the options, either all of the options or none of them might be returned. - `high` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseBudgetOption: Smart Campaign budget option. - `dailyAmountMicros` string, int64: The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. - `metrics` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseMetrics: Performance metrics for a given budget option. - `maxDailyClicks` string, int64: The estimated max daily clicks. - `minDailyClicks` string, int64: The estimated min daily clicks. - `low` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseBudgetOption: Smart Campaign budget option. - `dailyAmountMicros` string, int64: The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. - `metrics` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseMetrics: Performance metrics for a given budget option. - `maxDailyClicks` string, int64: The estimated max daily clicks. - `minDailyClicks` string, int64: The estimated min daily clicks. - `recommended` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseBudgetOption: Smart Campaign budget option. - `dailyAmountMicros` string, int64: The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. - `metrics` GoogleAdsSearchads360V23ServicesSuggestSmartCampaignBudgetOptionsResponseMetrics: Performance metrics for a given budget option. - `maxDailyClicks` string, int64: The estimated max daily clicks. - `minDailyClicks` string, int64: The estimated min daily clicks. --- [API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)