AppScreenshots 文档获取 Huawei HarmonyOS API 凭证
获取开发者级 Service Account 文件，或使用已有 API 客户端连接。
版本可用性： 2026-09-17 核对时，Chrome 商店公开版本为 0.1.1，说明列出 Apple 与 Google 支持。本教程适用于后续支持 HarmonyOS 的插件，请等待对应商店更新可用后再配置。本地候选构建不代表已经公开发布。
本流程面向原生 HarmonyOS 应用，不支持 Android AppGallery 提交。请使用当前安装版本提供的华为凭证模式。
Service Account 配置
图片来源：华为获取服务端授权指南，2026-09-17 核对。这是官方空白配置示例，不含真实账号或私钥。
- 打开 AppGallery Connect，确认开发者团队。
- 进入“用户与访问 → API密钥 → Connect API → Service Account”。不同语言的后台名称可能不同。
- 创建开发者级凭证，选择管理应用资料所需的角色。现有配置流程使用“运营”；确认前核对当前角色说明及联动权限。
- 下载完整私钥 JSON 文件并妥善保管。如果创建时跳回登录，重新登录后先检查列表，再决定是否重新创建。
- 打开插件设置，选择 Huawei 与 Service Account，导入 JSON 后验证并保存。保存凭证时不需要填写 App ID。
字段对照
| 凭证或字段 | 用途 |
|---|---|
| Service Account JSON | 为插件提供 keyId、subAccount、privateKey |
| App ID | 在发布配置中定位应用，不是密钥 |
| API 客户端 Client ID / Secret | 独立的旧方式认证模式 |
| agconnect-services.json、应用 AppSecret | 不是本流程需要的发布凭证 |
| 华为云 IAM AK/SK | 本流程不使用 |
在发布配置中填写 App ID 不会把开发者级凭证的权限缩小到该应用。凭证只能用于其有权访问的应用。
已有 API 客户端
使用已有客户端时，选择插件的 API Client 模式，填写 Client ID 与 Client Secret。确认客户端属于开发者级，现有配置使用项目 N/A，不要使用项目级凭证，也不要把 Service Account 字段混填进来。
最新创建选项、角色要求和文件格式见华为获取服务端授权指南。
验证目标应用
凭证通过验证后，选择发布配置，预检 App ID、包名和版本。凭证验证不会上传图片或提交审核。保存资料后在 AGC 核对结果，准备好后手工提交审核。
常见问题
- 没有 Huawei 选项：更新到支持 HarmonyOS 的插件版本，并重新连接网站。
- JSON 无效：使用完整凭证文件，不要使用单独的标识或 SDK 配置文件。
- 401/403：检查团队、凭证状态、开发者级类型、角色、网络及设备时间。
- 认证成功但保存失败：检查目标应用、版本是否可编辑、语言及素材要求。
轮换与撤销
正常轮换时先验证新凭证，确认其他工具已经切换后，再在 AGC 停用或删除旧密钥。私钥文件丢失后不能根据 ID 还原；“添加密钥”也不是重新下载旧密钥。
插件中删除凭证只清除当前浏览器的副本，不会撤销平台凭证。
2026-09-17 已核对插件字段及华为官方创建、鉴权说明。官方推荐新凭证使用 Service Account，API Client 作为兼容路径。所需角色取决于调用的接口，授权前应核对当前角色说明。返回使用指南。