GoogleAdsGoogleadsV25Services__SuggestGeoTargetConstantsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-suggest-geo-target-constants-response-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__SuggestGeoTargetConstantsResponse",
  "description": "Response message for GeoTargetConstantService.SuggestGeoTargetConstants.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-geotargetconstants-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__SuggestGeoTargetConstantsResponse",
  "type": "object",
  "properties": {
    "geoTargetConstantSuggestions": {
      "type": "array",
      "description": "Geo target constant suggestions.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__GeoTargetConstantSuggestion"
      }
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources__GeoTargetConstant": {
      "description": "A geo target constant.",
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Output only. Geo target constant English name."
        },
        "resourceName": {
          "type": "string",
          "description": "Output only. The resource name of the geo target constant. Geo target constant resource names have the form: `geoTargetConstants/{geo_target_constant_id}`"
        },
        "countryCode": {
          "type": "string",
          "description": "Output only. The ISO-3166-1 alpha-2 country code that is associated with the target."
        },
        "id": {
          "description": "Output only. The ID of the geo target constant.",
          "type": "string",
          "format": "int64"
        },
        "status": {
          "description": "Output only. Geo target constant status.",
          "type": "string",
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ENABLED",
            "REMOVAL_PLANNED"
          ],
          "x-enumDescriptions": [
            "No value has been specified.",
            "The received value is not known in this version. This is a response-only value.",
            "The geo target constant is valid.",
            "The geo target constant is obsolete and will be removed."
          ]
        },
        "canonicalName": {
          "description": "Output only. The fully qualified English name, consisting of the target's name and that of its parent and country.",
          "type": "string"
        },
        "targetType": {
          "type": "string",
          "description": "Output only. Geo target constant target type."
        },
        "parentGeoTarget": {
          "type": "string",
          "description": "Output only. The resource name of the parent geo target constant. Geo target constant resource names have the form: `geoTargetConstants/{parent_geo_target_constant_id}`"
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__GeoTargetConstantSuggestion": {
      "type": "object",
      "properties": {
        "reach": {
          "format": "int64",
          "description": "Approximate user population that will be targeted, rounded to the nearest 100.",
          "type": "string"
        },
        "locale": {
          "type": "string",
          "description": "The language this GeoTargetConstantSuggestion is currently translated to. It affects the name of geo target fields. For example, if locale=en, then name=Spain. If locale=es, then name=España. The default locale will be returned if no translation exists for the locale in the request."
        },
        "geoTargetConstant": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__GeoTargetConstant",
          "description": "The GeoTargetConstant result."
        },
        "searchTerm": {
          "type": "string",
          "description": "If the request searched by location name, this is the location name that matched the geo target."
        },
        "geoTargetConstantParents": {
          "type": "array",
          "description": "The list of parents of the geo target constant.",
          "items": {
            "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__GeoTargetConstant"
          }
        }
      },
      "description": "A geo target constant suggestion."
    }
  }
}