地理位置代码
地理位置数据可用于位置定位，例如，向特定国家/地区、省/自治区、县、市/自治区/直辖市/自治区的用户显示广告， (Microsoft 市场区域美国) 、邮政编码或城市。 可以调用 GetGeoLocationsFileUrl 操作以获取可用于下载最新地理位置数据的临时文件 URL。 还可以从 Microsoft Advertising 开发人员门户获取位置数据。 必须使用具有 Microsoft Advertising 凭据的 Microsoft 帐户用户登录到开发人员门户。
注意
作为最佳做法，应下载文件，而不是直接通过 Microsoft Excel 等应用程序打开它。 如果在文本编辑器中查看位置数据，请确保使用 UTF-8 编码而不是 ANSI，否则某些字符将无法准确显示。
有关演示如何下载地理位置代码的代码示例，请参阅 地理位置代码示例。
位置代码文件格式
CSV) 文件 (逗号分隔值包含组织在以下非本地化列标题中的数据。 根据上面使用的文件 URL，仅本地化必应显示名称。
重要
可以随时添加新列，因此实现必须忽略未知列。
无法保证位置的顺序，因此不应依赖任何感知到的列排序顺序或层次结构。
文件格式版本 2.0
如果在调用 GetGeoLocationsFileUrl 操作时将 Version 指定为 2.0，则下载的文件中提供了以下数据。 必应广告 API 目前仅支持文件格式版本 2.0。
| 列名称 | 说明 |
|---|---|
| 位置 ID | 位置的唯一 Microsoft Advertising 系统标识符。 必须使用此值来设置位置条件。 |
| 必应显示名称 | 可用于向应用程序的用户显示位置数据（例如）的可选名称。 垂直条用于将位置组件从最具体到最不具体分开。 例如，给定西雅图 |华盛顿|美国最具体的组成部分是美国华盛顿州的西雅图市。 多个位置 ID 可以具有相同的显示名称。 不得对演示文稿以外的任何内容使用显示名称，例如，不要假定任何层次结构或采用对显示名称的任何依赖项。 |
| 位置类型 | 确定与“位置 ID”列相对应的位置子类型 (，例如“城市”、“县”、“国家/地区”、“MetroArea”、“PostalCode”或“州) /自治区 邻里位置即将推出。 随时可以添加新的位置子类型。 给定位置 ID 的位置类型很少发生更改。 |
| 取代 | 保留以供将来使用，以指示此行中的位置将替换哪些位置。 |
| 状态 | 指示此行中的位置是活动、挂起的弃用还是已弃用。 - 活动：可以定位或排除位置。 - 挂起弃用：传递引擎仍使用位置进行定位或排除;但是，该位置将在未来 30 天内弃用。 - 已弃用：位置条件不再用于定位或排除。 仍可通过必应广告 API（例如 GetCampaignCriterionsByIds）检索已弃用的位置条件，但不能添加或更新已弃用的位置条件。 请考虑每月调用一次或两次 GetGeoLocationsFileUrl 操作，以确定文件的内容是否已更改，例如状态。 除非自上次同步位置数据以来返回的 LastModifiedTimeUtc 值已更改，否则不应下载整个文件。 |
| AdWords 位置 ID | 与 Microsoft Advertising 地理位置 ID 最接近匹配的 Google Ads 位置 ID。 可以使用此功能将 Microsoft Advertising 位置映射到估计的 Google Ads 位置。 此值是一个启发式估计值，可用于映射 Google Ads 和 Microsoft Advertising 地理位置。 如果未映射位置，则字段为空。 |
国家/地区代码
在某些情况下，API 需要国家/地区代码字符串，例如，用于 广告商Account 对象的业务地址。 Microsoft Advertising 支持以下国家/地区代码。
| Country Code | 国家/地区名称 |
|---|---|
| Af | 阿富汗 |
| 铝 | 阿尔巴尼亚 |
| Dz | 阿尔及利亚 |
| AS | 美属萨摩亚 |
| 广告 | 安道尔 |
| 坳 | 安哥拉 |
| 艾 | 安圭拉岛 |
| Aq | 南极洲 |
| 银 | 安提瓜和巴布达 |
| Ar | 阿根廷 |
| 是 | 亚美尼亚 |
| AW | 阿鲁巴岛 |
| 金 | 澳大利亚 |
| AT | 奥地利 |
| Az | 阿塞拜疆 |
| Bs | 巴哈马，The |
| Bh | 巴林 |
| 屋宇 署 | 孟加拉 |
| Bb | 巴巴多斯 |
| BY | 白俄罗斯 |
| BE | 比利时 |
| Bz | 伯利兹 |
| 北京 | 贝宁 |
| Bm | 百慕大 |
| Bt | 不丹 |
| 博 | 玻利维亚 |
| AN | 博内尔岛、库拉索、萨巴、圣尤斯特歇斯、圣马丁 |
| 八 | 波斯尼亚和黑塞哥维那 |
| Bw | 博茨瓦纳 |
| Br | 巴西 |
| 亿 | 文莱 |
| BG | 保加利亚 |
| 高炉 | 布基纳法索 |
| BI | 布隆迪 |
| CV | 佛得角 |
| Kh | 柬埔寨 |
| 厘米 | 喀麦隆 |
| 加利福尼亚州 | 加拿大 |
| 肯塔基州 | 开曼群岛 |
| Cf | 中非共和国 |
| Td | 乍得 |
| Cl | 智利 |
| 快递 之 家 | 中国 |
| 残雪 | 圣诞岛 |
| CC | 科科斯（基林）群岛 |
| CO | 哥伦比亚 |
| 公里 | 科摩罗 |
| Cg | 刚果（布） |
| Cd | 刚果（金） |
| Ck | 库克群岛 |
| 铬 | 哥斯达黎加 |
| CI | Côte d'Ivoire（科特迪瓦） |
| HR | 克罗地亚 |
| CY | 塞浦路斯 |
| Cz | 捷克共和国 |
| DK | 丹麦 |
| Dj | 吉布提 |
| Dm | 多米尼克 |
| DO | 多米尼加共和国 |
| 电子商务 | 厄瓜多尔 |
| EG | 埃及 |
| SV | 萨尔瓦多 |
| Gq | 赤道几内亚 |
| ER | 厄立特里亚 |
| Ee | 爱沙尼亚 |
| Et | 埃塞俄比亚 |
| Fk | 福克兰群岛 |
| 佛 | 法罗群岛 |
| 福建 | 斐济群岛 |
| FI | 芬兰 |
| FR | 法国 |
| 女朋友 | 法属圭亚那 |
| PF | 法属波利尼西亚 |
| GA | 加蓬 |
| 通用 汽车 | 冈比亚， |
| 通用 电气 | 格鲁吉亚 |
| DE | 德国 |
| Gh | 加纳 |
| Gi | 直布罗陀 |
| GR | 希腊 |
| Gl | 格陵兰 |
| Gd | 格林纳达 |
| Gp | 瓜德罗普 |
| 古 | 关岛 |
| GT | 危地马拉 |
| Gn | 几内亚 |
| Gw | 几内亚比绍 |
| Gy | 圭亚那 |
| HT | 海地 |
| Hn | 洪都拉斯 |
| 香港 | 香港特别行政区 |
| 胡 | 匈牙利 |
| 是 | 冰岛 |
| IN | 印度 |
| ID | 印度尼西亚 |
| 智商 | 伊拉克 |
| IE | 爱尔兰 |
| I l | Israel（以色列） |
| IT | Italy（意大利） |
| Jm | 牙买加 |
| Jp | 日本 |
| 乔 | 约旦 |
| KZ | 哈萨克斯坦 |
| 科 | 肯尼亚 |
| K i | 基里巴斯 |
| KR | 韩国 |
| 千瓦 | 科威特 |
| 公斤 | 吉尔吉斯斯坦 |
| 洛杉矶 | 老挝 |
| 低压 | 拉脱维亚 |
| 磅 | 黎巴嫩 |
| LS | 莱索托 |
| Lr | 利比里亚 |
| LY | 利比亚 |
| 李 | 列支敦士登 |
| LT | 立陶宛 |
| 路 | 卢森堡 |
| 莫 | 澳门特别行政区 |
| Mk | 北马其顿，前南斯拉夫共和国 |
| 镁 | 马达加斯加 |
| M w | 马拉维 |
| 我 | 马来西亚 |
| Mv | 马尔代夫 |
| 毫升 | 马里 |
| MT | 马耳他 |
| MH | 马绍尔群岛 |
| Mq | 马提尼克岛 |
| 先生 | 毛里塔尼亚 |
| 木 | 毛里求斯 |
| 刘日东 | 马约特岛 |
| MX | 墨西哥 |
| 调频 | 密克罗尼西亚 |
| Md | 摩尔多瓦 |
| Mc | 摩纳哥 |
| 锰 | 蒙古 |
| 我 | 黑山共和国 |
| 女士 | 蒙特塞拉特 |
| 马 | 摩洛哥 |
| Mz | 莫桑比克 |
| MM | 缅甸 |
| 不适用 | 纳米比亚 |
| 星期日 | 瑙鲁 |
| Np | 尼泊尔 |
| NL | 荷兰 |
| 数控 | 新喀里多尼亚 |
| 新西兰 | 新西兰 |
| 镍 | 尼加拉瓜 |
| NE | 尼日尔 |
| 议员 | 尼日利亚 |
| 女 | 纽埃 |
| Nf | 诺福克岛 |
| Mp | 北马里亚纳群岛 |
| 否 | 挪威 |
| Om | 阿曼 |
| Pk | 巴基斯坦 |
| PW | 帕劳 |
| Ps | 巴勒斯坦民族权力机构 |
| Pa | 巴拿马 |
| Pg | 巴布亚新几内亚 |
| PY | 巴拉圭 |
| 体育 | 秘鲁 |
| PH | 菲律宾 |
| Pn | 皮特凯恩群岛 |
| PL | Poland（波兰） |
| 铂 | 葡萄牙 |
| 公关 | 波多黎各 |
| Qa | 卡塔尔 |
| RE | 留尼旺 |
| Ro | 罗马尼亚 |
| 如 | 俄罗斯 |
| 乌尔曼 | 卢旺达 |
| Sh | 圣赫勒拿 |
| KN | 圣基茨和尼维斯 |
| 立法会 | 圣卢西亚 |
| 下午 | 圣皮埃尔和密克隆群岛 |
| Vc | 圣文森特和格林纳丁斯 |
| Ws | 萨摩亚 |
| Sm | 圣马力诺 |
| 圣 | 圣多美和普林西比 |
| SA | 沙特阿拉伯 |
| 锡 | 塞内加尔 |
| Rs | 塞尔维亚 |
| Sc | 塞舌尔 |
| SL | 塞拉利昂 |
| S g | 新加坡 |
| Sk | Slovakia（斯洛伐克） |
| 四 | 斯洛文尼亚 |
| 某人 | 所罗门群岛 |
| 所以 | 索马里 |
| 咱 | 南非 |
| ES | 西班牙 |
| 路 | 斯里兰卡 |
| 锶 | 苏里南 |
| 深圳 | 斯威士兰 |
| SE | 瑞典 |
| CH | Switzerland（瑞士） |
| TW | Taiwan（台湾） |
| Tj | 塔吉克斯坦 |
| TZ | Tanzania（坦桑尼亚） |
| TH | 泰国 |
| Tl | 东帝汶 |
| Tg | 多哥 |
| TK | 托克劳 |
| TO | 汤加 |
| TT | 特立尼达和多巴哥 |
| Tn | 突尼斯 |
| Tr | Türkiye |
| Tm | 土库曼斯坦 |
| Tc | 特克斯和凯科斯群岛 |
| 电视 | 图瓦卢 |
| Ug | 乌干达 |
| Ua | 乌克兰 |
| Ae | 阿拉伯联合酋长国 |
| G b | 英国 |
| 美国 | 美国 |
| UY | 乌拉圭 |
| UZ | 乌兹别克斯坦 |
| Vu | 瓦努阿图 |
| Va | 梵蒂冈 |
| VE | 委内瑞拉 |
| VN | 越南 |
| Vg | 英属维尔京群岛 |
| 六 | 美属维尔京群岛 |
| WF | 瓦利斯和富图纳 |
| 你们 | 也门 |
| Zm | 赞比亚 |
| ZW | 津巴布韦 |