创建并提交一批IAP
可以使用逗号分隔值 (CSV) 文件来上传新的和更新的IAP商品，以便批量提交应用内商品。IAP批量提交功能可将现有应用内购买 (IAP) 商品导出到CSV文件中。编辑该文件以更新现有条目并添加新条目，然后导入新的和更新的IAP商品并将它们提交到亚马逊应用商店。
CSV文件支持消费品和权利IAP（但不支持订阅）。为了简化IAP创建，IAP图标图像是可选项。CSV文件不支持上传图标图像。
要创建或更新单个IAP（和订阅IAP），请使用开发者控制台用户界面，如提交单个应用内商品中所述。
功能
IAP批量提交提供了以下功能：
-
将现有的应用内商品导出为CSV文件。使用此文件作为起点来更新现有的IAP商品或创建新的IAP商品。
-
导入CSV文件来创建新商品和更新现有商品。
- 两步错误处理：
- 系统验证CSV文件是否存在任何格式错误（如缺少价格，或字段格式不正确）。
- 系统识别提交后错误，如产品ID重复。
-
如果CSV文件中的条目未通过验证检查或提交后检查，则系统会创建一个文件，其中列出每个未通过条目对应的错误。
-
开发者门户会显示添加的IAP商品、更新的商品以及错误的数量。
- CSV文件可以包含消费品商品与权利商品、新商品与更新的现有商品的组合。
CSV文件格式
CSV文件是具有.csv文件扩展名的文本文件。CSV文件必须使用UTF-8编码，以支持本地化字符串。
CSV文件包含一个标题行（其中显示列标题）。文件中的每个后续行都包含一个应用内商品的信息。“产品ID”字段定义每个商品的唯一标识符。
下表介绍了文件中每个条目（行）的字段：
| 字段 | 类型 | 描述 |
|---|---|---|
| Product ID | 字符串 | 为IAP商品输入唯一产品ID。亚马逊开发者门户将此字段称为SKU。产品ID值在您的所有应用中必须是唯一的。它最多包含150个字符，其中可包含字符a-z、A-Z、0-9、下划线、句点和短划线。产品ID区分大小写。如果您未提供产品ID值，则系统将忽略文件的这一行。 |
| Locale; Title; Description; | 字符串 | 为商品指定区域设置、名称和描述。输入三个值，用分号隔开，顺序如下： 区域设置；名称；描述；。您可以针对不同的区域设置提供多组值。但是，即使您的应用仅在不使用en_US编码的国家/地区可用，您也必须为每个项目提供英语(en_US)文本。 有关语言缩写的列表，请参阅以下支持的语言表。 对于您未提供翻译文本的任何区域设置，系统将显示英语文本。 |
| Auto Fill Prices | TRUE或FALSE | 如果将Auto Fill Prices（自动填充价格）设置为TRUE，则只需在Price（价格）字段中输入价格值（以设置基本价格）。 如果将Auto Fill Prices设置为FALSE，则必须为每个市场输入价格。 |
| Price | PriceMicro | 如果此商品不收费，请输入0。 如果将Auto Fill Prices设置为TRUE，请为商品提供币种缩写和价格。 否则，请使用用分号分隔的一对值为每个市场输入价格。对每个值对使用以下格式： 国家/地区缩写; 价格;。最后一个值对后面不加分号。 将价格设置为每种币种的有效金额。请参阅每种币种的IAP价格范围。 有关国家/地区与币种的对应关系，请参阅以下示例条目。以币种基本单位的百万分之一为单位输入价格，不带小数。例如，在CSV文件中输入1美元 ( US; 1000000;) 的单价。如果您没有为每个市场提供价格，则系统会将此行标记为存在错误。
|
| IAP Type | 消费品或权利 | 输入IAP类型。如果此字段为空或无效，则系统会将此行标记为存在错误。IAP类型区分大小写，且不支持Subscription（订阅）。 |
| TEST IAP 注意： 仅在导出商品时出现。不用于导入商品。 |
TRUE或FALSE | 对于仅为LAT提交或发布的IAP（带有“测试”标签的IAP），此字段的值为TRUE。
对于同时为测试和上线创建和提交的IAP，此字段的值为FALSE。 |
如果Auto Fill Prices设置为TRUE，请输入币种缩写。如果Auto Fill Prices设置为False，请输入国家/地区缩写。下面的示例显示了Auto Fill Prices设置为FALSE时的价格条目：
US;44000000;DE;41640000;IN;2933590000;JP;5015000000;IT;41640000;FR;41640000;ES;41640000;BR;137250000; AU;57990000;GB;36060000;CA;59020000
下面的示例显示了Auto Fill Price设置为TRUE时的价格条目：
USD; 3840000
国家/地区和币种缩写
下表显示了每个市场的国家/地区缩写、币种缩写和币种：
| 国家/地区 缩写 |
币种 缩写 |
币种 | 市场 |
|---|---|---|---|
| AU | AUD | 澳元 | Amazon.com.au |
| BR | BRL | 巴西雷亚尔 | Amazon.com.br |
| CA | CAN | 加拿大元 | Amazon.ca |
| DE | EUR | 欧元 | Amazon.de |
| ES | EUR | 欧元 | Amazon.es |
| FR | EUR | 欧元 | Amazon.fr |
| GB | GBP | 英镑 | Amazon.co.uk |
| IN | INR | 印度卢比 | Amazon.in |
| IT | EUR | 欧元 | Amazon.it |
| JP | JPY | 日元 | Amazon.co.jp |
| MX | MXN | 墨西哥比索 | Amazon.com.mx |
| US | USD | 美元 | Amazon.com |
支持的语言
下表显示了名称和描述字段支持的语言：
| 缩写 | 语言 |
|---|---|
| zh_CN | 中文（不支持拼音。请参阅以下警告） |
| de_DE | 德语 |
| en_AU | 英语（澳大利亚） |
| en_GB | 英语（英国） |
| en_IN | 英语（印度） |
| en_US | 英语（美国） |
| es_ES | 西班牙语 |
| es_MX | 西班牙语（墨西哥） |
| fr_FR | 法语 |
| it_IT | 意大利语 |
| ja_JP | 日语 |
| pt_BR | 巴西葡萄牙语 |
错误消息
当您上传CSV文件时，系统将验证该文件中的每个条目。如果文件包含错误，则系统会复制输入文件，并在状态列中为具有错误的每一行添加消息。您可以查看消息作为解决任何问题的指导。
示例CSV文件
CSV模板文件包含示例条目。有关下载文件的说明，请参阅创建并提交一批IAP。
有关行格式的说明：
- 使用逗号分隔行中的每个字段。
- 使用分号分隔字段中的值。系统会忽略空格。
建议使用Google Sheets查看和编辑CSV文件。
有关如何为Excel和其他工具配置UTF-8编码的说明，请参阅为Excel配置UTF-8。
将UTF-8 CSV文件导入到Excel中：
- 选择File>Import（文件 > 导入）
- 选择CSV作为文件类型
- 选择要导入的文件
- 在Text Import Wizard（文本导入向导）中，选择UTF-8作为文件源。
Last updated: 2026年1月23日
