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

# POST /v23/customers/{+customerId}:suggestKeywordThemes

`POST /v23/customers/{+customerId}:suggestKeywordThemes`

Suggests keyword themes to advertise on.

## Path parameters

- `customerId` 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.
      - `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.
      - `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.
      - `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.
      - `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.
      - `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.
    - `keywordThemes` GoogleAdsSearchads360V23CommonKeywordThemeInfo[] — Optional. Smart campaign keyword themes. This field may greatly improve suggestion accuracy and we recommend always setting it if possible.
      - `keywordThemeConstant` string — The resource name of a Smart Campaign keyword theme constant. `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}`
      - `freeFormKeywordTheme` string — Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
    - `businessContext` GoogleAdsSearchads360V23ServicesSmartCampaignSuggestionInfoBusinessContext — A context that describes a business.
      - `businessName` string — Optional. The name of the business.
    - `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.
      - `radius` number, double — The radius of the proximity.
      - `geoPoint` GoogleAdsSearchads360V23CommonGeoPointInfo — Geo point for proximity criterion.
        - `longitudeInMicroDegrees` integer — Micro degrees for the longitude.
        - `latitudeInMicroDegrees` integer — Micro degrees for the latitude.
      - `radiusUnits` 'UNSPECIFIED' | 'UNKNOWN' | 'MILES' | 'KILOMETERS' — The unit of measurement of the radius. Default is KILOMETERS.
      - `address` GoogleAdsSearchads360V23CommonAddressInfo — Address for proximity criterion.
        - `cityName` string — Name of the city.
        - `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.
        - `streetAddress` string — Street address line 1.
        - `provinceCode` string — Province or state code.
        - `countryCode` string — Country code.
        - `provinceName` string — Province or state name.
        - `postalCode` string — Postal code.
    - `finalUrl` string — Optional. Landing page URL of the campaign.
    - `languageCode` string — Optional. The two letter advertising language for the Smart campaign to be constructed, default to 'en' if not set.
    - `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.
    - `locationList` GoogleAdsSearchads360V23ServicesSmartCampaignSuggestionInfoLocationList — A list of locations.
      - `locations` GoogleAdsSearchads360V23CommonLocationInfo[] — Required. Locations.
        - `geoTargetConstant` string — The geo target constant resource name.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)