---
title: "POST /v23/customers/{customersId}:suggestKeywordThemes"
method: POST
path: "/v23/customers/{customersId}:suggestKeywordThemes"
tags: ["customers"]
---

# POST /v23/customers/{customersId}:suggestKeywordThemes

`POST /v23/customers/{customersId}:suggestKeywordThemes`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{customersId}:suggestKeywordThemes`
- 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: <https://skmtc.dev/google/apis/searchads360/docs/v23/customers/:customersId:suggestKeywordThemes/post.ts> (a function with typed inputs; its response is checked against the schema)

Suggests keyword themes to advertise on.

## Path parameters

- `customersId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesSuggestKeywordThemesRequest: Request message for SmartCampaignSuggestService.SuggestKeywordThemes.
  - `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

- GoogleAdsSearchads360V23ServicesSuggestKeywordThemesResponse: Response message for SmartCampaignSuggestService.SuggestKeywordThemes.
  - `keywordThemes` GoogleAdsSearchads360V23ServicesSuggestKeywordThemesResponseKeywordTheme[]: Smart campaign keyword theme suggestions.
    - `freeFormKeywordTheme` string: A free-form text keyword theme.
    - `keywordThemeConstant` GoogleAdsSearchads360V23ResourcesKeywordThemeConstant: A Smart Campaign keyword theme constant.
      - `countryCode` string: Output only. The ISO-3166 Alpha-2 country code of the constant, eg. "US". To display and query matching purpose, the keyword theme needs to be localized.
      - `displayName` string: Output only. The display name of the keyword theme or sub keyword theme.
      - `languageCode` string: Output only. The ISO-639-1 language code with 2 letters of the constant, eg. "en". To display and query matching purpose, the keyword theme needs to be localized.
      - `resourceName` string: Output only. The resource name of the keyword theme constant. Keyword theme constant resource names have the form: `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}`

---

[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)