针对具体错误消息建议的解决方案
如果您在上传过程中收到错误消息，不要惊慌！这些情况通常会在数据导入遇到上传文件中的非预期数据时发生。下表列出了您可能会收到的错误消息，并提供了修正这些问题的解决方案。
在下列消息中，X、Y 和 Z 等参数是占位符，在运行时被替换为实际值。
如果建议的解决方案是“修改文件”，则意味着您需要直接修改上传文件或采用可纠正相应错误的方式重新生成该文件。
| 消息 | 含义 | 解决方案 |
|---|---|---|
| 找不到 API 参数 X。 | 您尝试使用 Management API 上传数据，但缺少一个必需的参数。 | 将缺少的参数添加到您的代码中。 |
| 至少应使用以下标题中的一个：X。 | 上传文件缺少一个必需的标题。 | 查看您要导入的数据类型的数据集详细信息，并确保您的上传文件与所需的架构相符。 |
| 对列的访问请求被拒：X。 | 对于所选的媒体资源，您的权限不足。 | 确保您拥有要向其上传数据的媒体资源的“编辑者”角色。 |
| 缺少列标题 X。 | 上传文件缺少指定的列标题。 | 修改文件并添加缺少的标题。 |
| 不允许使用列标题 X。 | 指定的列标题针对的是无法上传到 Google Analytics（分析）的数据。 | 查看适用于所选导入类型的可用维度和指标。 |
| 输入文件中缺少列标题。 | 上传文件缺少列标题。 | 修改文件并添加适当的标题。请参阅设置上传文件的格式。 |
| 找不到 uid X 的自定义数据源。 | 找不到为此导入提供的数据集 ID（也称为自定义数据源 ID）。 | 确保此上传内容的数据集 ID 正确无误。有关详情，请参阅创建数据集 |
| 退款导入不允许删除上传的内容。 | 无法删除退款数据上传文件。请参阅退款数据。 | |
| 列标题 X 重复。 | 上传文件中包含重复的列标题。每个维度或指标名称只能在每个上传文件中出现一次。 | 修改该文件并移除或更改重复标题。 |
| 第 X 列的列标题为空。 | 上传文件缺少列标题。 | 修改文件并添加缺少的标题。 |
| 已经超出每行的最大长度限制 (X)。 | 上传文件中的一个或多个字段/行超出每个字段/行的最大长度限制。 |
减少您上传的数据量。 如需了解特定字段长度限制，请参阅 Analytics.js 字段参考文档。 |
| 文件包含 X 列。列数上限为 Y。 | 上传文件的列数过多。 | 减少您要上传的维度数量或指标数量。 |
| 在数据导入架构中找不到标题 X。 | 上传文件中包含未在数据集架构中定义的标题。上传文件中的每一列都必须包含与架构中定义的一个维度或指标相符的标题。 | 修改文件并添加缺少的标题。了解如何获取数据集架构。 |
| 权限不足。 | 您没有向此媒体资源上传数据的权限。 | 您需要拥有媒体资源级别的“编辑者”角色才能将数据导入 Google Analytics（分析）。 |
| 第 X 行的 CSV 格式无效。 | 上传文件存在格式问题。可能存在的问题包括：
|
修改该文件并检查指明的行是否存在格式错误。请注意，错误消息中指明的行可能并非存在实际错误的行，因此您可能需要检查前一行是否存在相应错误。 |
| 帐号 ID 格式无效：X。 | 帐号 ID 的格式不正确。Google Analytics（分析）帐号 ID 必须采用以下格式：UA-XXXXXX-X | 修改您的代码并确保帐号 ID 的格式正确无误。 |
| 第 Y 行、第 Z 列的单元格数据“X”无效。支持的日期格式为 YYYYMMDD（例如 20131217）。 | 上传文件中指定位置的数据包含无效的日期格式。日期必须采用 YYYYMMDD 格式。 | 修改文件并更正日期格式。 |
| 第 Y 行、第 Z 列的单元格数据“X”无效。数据类型应为：（类型）。 | 上传文件中指定位置的数据的类型有误。例如，该列应该包含数值数据，但上传文件中的此处包含的是字符串值。 | 将该单元格中的数据更正为预期类型。 |
| 第 Y 行、第 Z 列的单元格数据“X”无效。“年份”不得早于 2005。 | 上传文件中指定位置的数据包含无效的年份。您无法上传 2005 年之前的数据。 | 删除所有含有 2005 年之前的数据的行。 |
| 客户数据无效：X | 上传文件中包含无法处理的数据。 | 修改上传文件并更正数据。 |
| 上传的数据中存在无效的列标题名称 X。 | 上传文件中包含无效的列标题名称。可能存在拼写错误？列标题名称必须为采用以下格式的有效维度或指标名称：ga:name。 | 确保您的列标题与数据集架构相符。 |
| 自定义数据源 ID 格式无效：X。 | 自定义数据源 ID 格式无效的错误消息。 | 修改您的代码并确保自定义数据源 ID 的格式正确无误。详细了解自定义数据源。 |
| 媒体资源 ID 格式无效：X。 | 媒体资源 ID 的格式不正确。Google Analytics（分析）媒体资源 ID 必须采用以下格式：UA-XXXXXX-X | 修改您的代码并确保媒体资源 ID 的格式正确无误。 |
| 出现多个错误： | 包含多个错误的列表 | |
| 媒体资源 ID X 未找到（或不可访问）。 | 此上传内容指定的媒体资源 ID 不正确，或者您无权将数据上传到此媒体资源。 | 确保您拥有要向其上传数据的媒体资源的“编辑者”角色。 |
| 媒体资源 ID 与帐号 ID 不符。媒体资源 ID：X，帐号 ID：Y。 | 您尝试将数据导入到不属于指定帐号的媒体资源中。 | 修改您的代码并确保帐号 ID 和媒体资源 ID 均正确无误。 |
| 已超出配额。 | 您已超出数据导入配额。 | 请参阅数据导入限制。 |
| 第 X 行仅包含 Y 列，实际应为 Z 列。 | 指定的行缺少一列或多列数据。 | 修改上传文件的相应行并添加缺少的数据列。 |
| 第 X 行、第 Y 列：数据无效。当“ga:source”的值为“google”时，可上传的费用数据只有“organic”费用数据（即“ga:medium”为“organic”）。 | 您尝试使用“来源”维度中的“google”上传费用数据，但“媒介”维度是“notorganic”。 | 将“ga:source”维度为“google”的所有行的“ga:medium”维度更改为“organic”。 |
| 第 X 行、第 Y 列：标题 Z 缺少必需的值。 | 上传文件的指定位置缺少必需的数据。 | 修改文件并添加缺少的数据。 |
| 第 X 行：文件中包含无效的字符。仅支持 UTF-8 编码字符。 | 上传文件中包含无效的字符。数据导入文件应采用 UTF-8 编码。 | 将上传文件的编码更改为 UTF-8。 |
| 第 X 行：至少应为以下标题提供一个值：Y。 | 上传文件缺少一个必需的数据维度或指标。 | 查看您要导入的数据类型的数据集详细信息，并确保您的数据包含所有必需值。 |
| 第 X 行无效，无法导入退款。该行必须包含 ga:transactionId，有无 ga:transactionRevenue 均可。如果指定了 ga:productSku，则必须指定 ga:quantityRefunded。如果指定了 ga:productSku，则可以视需要指定 ga:productPrice。 | 上传文件中包含错误数据，无法导入退款数据。 | 修改上传数据，以遵守退款数据架构要求。 |
| 出现临时错误。请稍后重试。 | 服务器出现临时错误。 | 请等待几分钟，然后重新尝试提交请求。 |
| 出现内部错误。 | 服务器出现错误。 | 尽管极少出现此类错误，但服务器的连接问题或配置错误可能会阻止用户使用相关服务。此问题很可能会快速得到解决。如果该错误持续存在，您可以向我们发送反馈。 |
| 上传请求中网址的开头应为 https://www.googleapis.com/upload/analytics/... | 您的上传请求缺少相应的网址。 | 将正确的网址添加到您的代码中。有关详情，请参阅 Google Analytics（分析）开发者指南中的 Uploads: uploadData。 |
| 网络媒体资源未处于有效状态（帐号 ID 为 X，媒体资源编号为 Y）。 | 您的上传请求指定的网络媒体资源未与指定帐号相关联。 | 修改您的请求并确保帐号 ID 和媒体资源 ID 均正确无误。 |
