To retrieve geo targets directly from the Google Ads API, query the
geo_target_constant field.
Geo targets
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eGeo targets can be retrieved directly from the Google Ads API using the \u003ccode\u003egeo_target_constant\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eDownloadable CSV files provide a list of geo targets with details like ID, name, parent, country code, type, and status.\u003c/p\u003e\n"],["\u003cp\u003eSome locations, although appearing in reports, might be restricted for targeting in Google Ads.\u003c/p\u003e\n"],["\u003cp\u003eFor advertising in China, additional certificates and licenses may be required based on product categories.\u003c/p\u003e\n"],["\u003cp\u003eDMA region data is available through Nielsen, not directly through Google Ads.\u003c/p\u003e\n"]]],[],null,["# Geo targets\n\nTo retrieve geo targets directly from the Google Ads API, query the\n[`geo_target_constant`](/google-ads/api/fields/v21/geo_target_constant) field.\n\nDownload CSV of geo targets\n---------------------------\n\n[Latest zipped CSV (2025-07-15)](/static/google-ads/api/data/geo/geotargets-2025-07-15.csv.zip)\n\n[Previous zipped CSV (2025-06-26)](/static/google-ads/api/data/geo/geotargets-2025-06-26.csv.zip)\n\nColumns\n-------\n\nCriteria ID\n: Unique and persistent assigned ID.\n\nName\n: Best available English name of the geo target.\n\nCanonical Name\n: The constructed fully qualified English name consisting of the target's own\n name, and that of its parent and country. This field is meant only for\n disambiguating similar target names.\n\nParent ID\n:\n The criteria ID of a parent. This field is included only for legacy support,\n so IDs might not be consistent across datasets.\n\nCountry Code\n: The ISO-3166-1 alpha-2 country code that is associated with the target.\n\nTarget Type\n\n: Allowable values:\n\n - Airport\n - Autonomous Community\n - Barrio\n - Borough\n - Canton\n - City\n - City Region\n - Colloquial Area\n - Commune\n - Congressional District\n - Country\n - County\n - Department\n - District\n - Division\n - Governorate\n - Municipality\n - Municipality District\n - National Park\n - Neighborhood\n - Okrug\n - Postal Code\n - Prefecture\n - Province\n - Quarter\n - Region\n - State\n - Sub District\n - Sub Ward\n - Territory\n - TV Region\n - Union Territory\n - University\n\nStatus\n\n: Allowable values:\n\n - `Active`: Location is valid.\n - `Removal Planned`: Location is obsolete and will be removed in the next version.\n\nThe allowed values in the CSV file differ from the enum values for\n`geo_target_constant.status`, which are `ENABLED` (equivalent to `Active`),\n`REMOVAL_PLANNED`, `UNKNOWN`, and `UNSPECIFIED`. When using the Google Ads API,\nyou cannot query for `UNKNOWN` values of `geo_target_constant.status`.\n\nNon-targetable locations\n------------------------\n\nSome countries or territories are not targetable in Google Ads but might appear\nin reports based on the user's location of interest or physical location.\n[Check the list of restricted countries](//support.google.com/google-ads/answer/6163740)\n\nDue to advertising regulations and laws of the People's Republic of China, you\nmay be asked to provide certificates and licenses if you are advertising certain\ncategories of products in China. You don't need to submit certificates until\nafter your account has been activated. Once your account is active, you will be\nprovided with information on how to submit certificates to Google.\n\nDMA regions\n-----------\n\nContact [The Nielsen\nCompany](//markets.nielsen.com/us/en/contact-us/intl-campaigns/dma-maps/)\ndirectly for DMA data."]]