为终端而生的 AppGallery Connect 控制面

让每一次发布沿着 同一条红线前进。

用一套 Go 命令发现、预演并调用 AppGallery Connect API,为开发者、CI 和 Coding Agent 提供稳定 JSON。

21 API 家族286 已注册接口3 输出格式
agc / production参考模式
agc终端命令JSONAgent脚本
一个命令入口,连接你的工作流。
鉴权PS256 / OAuth
PROFILE项目自动绑定
软件包上传与状态
发布确认后调用

$ agc auth check --pretty

{
  "data": {
    "name": "production",
    "mode": "service-account",
    "active": true
  },
  "affordances": {
    "next": "agc publishing endpoints"
  }
}

已解析项目 Profile · 默认 dry-run

默认预演明确确认前不会发送请求。
Agent 可读JSON 返回下一步可执行操作。
统一控制面CLI、本地 REST 与 Web 共用注册表。

安装 agc CLI

用系统包管理器安装。

Windows、macOS 和 Linux CI 可通过同一条 NPM 命令无人值守安装。开发电脑仍可使用 Homebrew 或 Scoop 原生包。

Windows · macOS · Linux CI
$ npm install --global @createitv/agc-cli && agc version
macOS Homebrew 命令
$ brew tap createitv/tap && brew install agc-cli && agc version
Windows Scoop 命令
PS> if (!(Get-Command scoop -ErrorAction SilentlyContinue)) { Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex }; scoop bucket add createitv https://github.com/Createitv/scoop-bucket; scoop install agc-cli; agc version
NPM:Node.js 18+ 安装时不运行 postinstall 下载 内置五个平台校验后二进制

Agent Skills

让 Coding Agent 真正理解 AppGallery Connect 工作流。

6 个可移植 Skills 参考 asc-cli 的任务分层方式设计。可以全部安装,也可以只选择一个工作流;每个 Skill 都支持查看源码、直接下载和通过 GitHub 参与完善。

提交一个 Skill
为 Codex 安装全部 6 个 Skills$ agc skills install --agent codex --global
agc-cli-usage

通用命令发现、dry-run 预演、授权执行和远程结果验证。

agc skills install --name agc-cli-usage --agent codex --global
agc-auth

凭据 Profile、whoami、OAuth 团队查询和权限诊断。

agc skills install --name agc-auth --agent codex --global
agc-publishing

应用资料、软件包、提交审核、分阶段发布和发布状态验证。

agc skills install --name agc-publishing --agent codex --global
agc-testing

测试版本、群组、测试用户、邀请链接、反馈和版本转正。

agc skills install --name agc-testing --agent codex --global
agc-reports

分发、安装、付费、留存和鸿蒙元服务报表导出。

agc skills install --name agc-reports --agent codex --global
agc-cicd

跨平台固定版本安装、受保护凭据、dry-run 门禁和 CI 验证。

agc skills install --name agc-cicd --agent codex --global

发布轨道

上下文向前流动,密钥留在本地。

每个阶段只完成一件事。凭据保存在本机,项目上下文可以安全共享,写入类 API 必须显式确认。

01

鉴权

PS256 / OAuth

02

PROFILE

项目自动绑定

03

软件包

上传与状态

04

发布

确认后调用

Profile 自动绑定

每个项目只选择一次,临时切换时再覆盖。

在 .agc/project.json 中绑定 production。命令会按固定优先级解析,也可以用 --profile staging 完成一次性切换。

  1. 1命令行显式覆盖--profile staging
  2. 2项目默认 Profile.agc/project.json
  3. 3全局激活账户~/.agc/credentials.json
.agc/project.json 可安全提交
{
  "appId": "123456789",
  "projectId": "987654321",
  "packageName": "com.example.app",
  "profile": "production"
}
项目文件不保存 client key 或私钥。

接口注册表

先发现 API,再编写请求。

每个条目都包含 method、path、参数位置、CLI 命令、REST 路由和 dry-run 调用方式。

当前家族 / publishing

应用发布

已注册

管理发布资料、软件包状态、提交审核、撤回审核与定时发布。

发现agc publishing endpoints --output table
状态agc publishing status --pretty
本地 REST/api/v1/publishing
42 个类型化接口条目

全部接口 42

展开接口查看已登记参数与命令;完整协议、响应字段及权限以官方文档为准。

GET查询软件包编译状态package-compile-status-v3/api/publish/v3/package/compile/status

此接口用于查询HarmonyOS应用/元服务的软件包的编译状态。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string应用ID。
pkgIdsquery是string待查询的软件包ID。 多个ID之间用英文逗号分隔。 可从更新应用软件包信息接口返回的packageId参数中获取。

查看接口定义

agc publishing package-compile-status-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/package-compile-status-v3

调用预演(先填写所需参数)

agc publishing package-compile-status-v3 --invoke --dry-run=true
查看接口参考文档 ↗
POST创建APP IDapp-create/api/publish/v3/app

此接口用于为HarmonyOS应用/元服务创建APP ID。

开发者调用华为 API

已登记参数
参数位置必填类型说明
projectIdquery否string项目ID,获取方法请参见查看应用信息。 如果不传projectId,系统会先在内部创建一个与应用同名的项目,随后再创建应用。
appNamebody是string应用名称。
packageNamebody否string应用包名,必须唯一,且不能与其他应用(包括Android应用)包名相同。 说明 installationFree取值为0(HarmonyOS应用)时,此参数必填。 installationFree取值为1(元服务)时,系统将自动生成包名,此参数无需填写。
parentTypebody是integer应用分类。 取值范围: 2:游戏 13:应用
installationFreebody是integer应用类型。 取值范围: 0:HarmonyOS应用 1:元服务 默认值:0

请求体: appName,packageName,parentType,installationFree

查看接口定义

agc publishing app-create --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-create

调用预演(先填写所需参数)

agc publishing app-create --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询应用信息app-info-query-v3/api/publish/v3/app-info

此接口用于根据指定语言和应用ID查询HarmonyOS应用/元服务的详细信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要查询的应用ID。
langquery否string需要查询的语言。 说明 取值参考语言类型。 不传该参数,则查询全部语言的应用信息。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 6:HarmonyOS测试发布方式(API>=10) 默认值:1
versionIdquery否string需要查询的版本ID。 注意 releaseType为6,该字段必填。

查看接口定义

agc publishing app-info-query-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-info-query-v3

调用预演(先填写所需参数)

agc publishing app-info-query-v3 --invoke --dry-run=true
查看接口参考文档 ↗
POST查询应用所有版本类型的版本列表app-version-list/api/publish/v3/version/brief-info/list

此接口用于获取HarmonyOS应用/元服务的所有版本类型(含商用版本和测试版本)的版本列表,帮助开发者了解版本发布状态。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader否string应用ID,获取方法参考查看应用信息。
packageNamebody否string应用包名。 说明 appId和packageName至少传一个。
statebody否string版本状态。 多个状态用逗号分隔。 说明 state字段的取值请参考AppInfo中的releaseState参数。

请求体: packageName,state

查看接口定义

agc publishing app-version-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-version-list

调用预演(先填写所需参数)

agc publishing app-version-list --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST通过下载方式提交软件包add-packageurl/api/publish/v2/app-package-file/by-url

如果您将软件包保存在自己的服务器上,可以直接调用本接口将软件包提交到AppGallery Connect服务器。华为服务器会自动从下载地址中下载软件包后提交,不会关联版本。本操作只提交软件包,不发布软件包。接口调用者的角色:账号持有者、管理员、APP管理员。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
downloadUrlbody是string由您自行提供的软件包下载地址。 APK:不超过4GB。 RPK:快应用不超过20MB,快游戏不超过30MB。 AAB:不超过150MB。 EXE(Windows应用):不超过4GB。
downloadFileNamebody是string与downloadUrl配套的文件名,包括后缀。
callbackAddrbody否string回调地址,由您自行配置。软件包提交完成后由华为服务器调用回调结果通知接口通过该URL回调给您的开发者服务器。
requestIdbody是string您自定义请求字符串,必须唯一标识此请求。结果回调时会携带该字段。
versionNamebody否stringWindows应用的软件包版本号。 文件类型为exe软件包时必选。
displayNamebody否string注册表显示名称,用于唯一标识Windows应用。 文件类型为exe软件包时必选。
packageTypebody否integer软件包类型。 1:APK 2:RPK 8:EXE(Windows应用)

请求体: json

查看接口定义

agc publishing add-packageurl --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/add-packageurl

调用预演(先填写所需参数)

agc publishing add-packageurl --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新应用文件信息app-file-info/api/publish/v2/app-file-info

图片、视频、APK、RPK、AAB等文件上传完成后,通过该接口刷新应用文件信息。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明

注册表未列出参数,请查看接口参考。

请求体: json

查看接口定义

agc publishing app-file-info --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-file-info

调用预演(先填写所需参数)

agc publishing app-file-info --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询应用信息app-info-query/api/publish/v2/app-info

此接口用于根据指定语言和应用ID查询应用的详细信息。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string需要查询的应用ID。
langquery否string需要查询的语言,取值参考语言类型。不传该参数则查询全部语言的应用信息。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 3:分阶段 默认值:1

查看接口定义

agc publishing app-info-query --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-info-query

调用预演(先填写所需参数)

agc publishing app-info-query --invoke --dry-run=true
查看接口参考文档 ↗
PUT更新应用基本信息app-info-update/api/publish/v2/app-info

此接口用于更新指定应用的应用详情。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 3:分阶段 默认值:1
appIdquery是string需要更新的应用ID。
defaultLangbody否string应用的默认语言,取值参见语言类型。
childTypebody否integer应用的二级分类,固定ID,取值参见应用游戏分类。
grandChildTypebody否integer应用的三级分类,固定ID,取值参见应用游戏分类。
privacyPolicybody是string隐私声明地址。
appNetTypebody否integer应用联网类型。 取值范围: 1:单机 2:网游
isFreebody否integer应用付费类型。 取值范围: 1:免费 0:付费 如果isFree为1,price和priceDetail参数将无效。
pricebody否string应用价格,格式为{"countryCode":"price"}。countryCode为国家码,price为应用的价格。国家码列表请参见国家码,对应币种请参见ISO 4217标准。 AppGallery Connect会根据所在国家/地区的价格规则对最终价格做适当调整,具体规则请参见价格换算规则。 注意 当isFree为0时,此参数必选。
priceDetailbody否string应用在不同国家或地区的价格,json数组格式,不同国家和地区之间使用逗号分隔,例如:[{"country":"CN","currency":"CNY","price":"18.00"},{{"country":"DE","currency":"EUR","price":"2.50"}}]。 其中,country为国家码,currency为国家码所对应的币种,price为应用价格。国家码列表请参见国家码,对应币种请参见ISO 4217标准。 AppGallery Connect会根据所在国家/地区的价格规则对最终价格做适当调整,具体规则请参见价格换算规则。 注意 当isFree为0时,此参数必选。
publishCountrybody否string应用发布国家的国家码,多个国家以英文逗号分隔,例如:“CN,DE,MC”。如果取值为“OTHER”,表示当AppGallery支持的国家或地区列表中新增某个国家或地区时,应用将自动分发到新增的国家和地区。国家码列表请参见国家码。 注意 取值不能只包含OTHER。
isAppForcedUpdatebody否integer应用是否强制升级。 取值范围: 0:不强制 1:强制
hispaceAutoDownbody否integer是否允许华为应用市场抓包。 取值范围: 0:不允许 1:允许
appTariffTypebody否string应用内付费道具类型。 取值范围: 1:激活收费 2:道具收费 3:关卡收费 4:购买虚拟币 5:部分章节收费(图书阅读类) 6:其他的 7:课程收费 8:会员收费 支持设置多个,使用英文逗号分隔,例如“1,2,3”。
publicationNumberbody否string版号信息。 此参数只支持游戏类应用。
cultureRecordNumberbody否string文化部备案编号。 此参数只支持游戏类应用。
developerWebsitebody否string开发者官网。
familyShareTagbody否integer是否可以家庭共享。 取值范围: 0:不可以。 1:可以。
deviceTypesbody否array设备类型信息。
webGameFlagbody否integer该应用是否为网页游戏。 取值范围: 0:否 1:是 该参数仅在应用为手机RPK游戏,且设备类型信息中适配设备类型包含Windows(appAdapters取值包含15)时才会生效。
privacyRightsUrlbody否string隐私权利网址,即关于您的用户实施其权利的网站地址,如用户删除、修改、导出其个人数据的入口。
registeredDclTypebody否integerAPP类型信息。 取值范围: -1:清空APP类型信息 0:APP服务器在中国大陆 1:APP服务器不在中国大陆 2:APP为单机APP
registeredIdTypebody否integer主办单位类型。 取值范围: -1:清空数据(会联动清空registeredIdNumber的内容) 1:企业(社会信用代码) 2:个人(身份证号码) 3:机构(机构代码)
registeredIdNumberbody否string主办单位证件号。 取值范围: registeredIdType为1时,对应统一社会信用代码 registeredIdType为2时,对应身份证号码 registeredIdType为3时,对应组织机构代码
registeredEntitybody否integer主办单位。 取值范围: 1:与开发者账号主体一致 2:与开发者账号主体不一致 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 若在版本提交时,该字段值选择“一致”,则主办单位名称和证件号,将直接复用开发者联盟注册账号信息。 若您提交的主办单位信息与联盟账号信息不一致,该字段值却选择了“一致”,则系统将自动判定为“不一致”,将会影响审核结果。
registeredEntityNamebody否string主办单位名称。 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。
userAgreementUrlbody否string用户协议URL。
encryptedbody否integer包是否加密。 取值范围: 0:否,表示不加密。 1:是,表示加密。 默认值:1

请求体: json

查看接口定义

agc publishing app-info-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-info-update

调用预演(先填写所需参数)

agc publishing app-info-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST提交发布app-submit/api/publish/v2/app-submit

此接口用于提交应用审核,调用本接口前必须保证应用信息已补充完整,应用软件包已经上传。接口调用者的角色:账号持有者、管理员、APP管理员。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
releaseTimequery否string指定发布的UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 说明 如果releaseTime未填写,应用审核通过后会立即上架。
remarkquery否string提审发布的备注信息,可以为空。如果填写,长度范围在10-300。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 3:分阶段 说明 应用发布方式为分阶段发布时,要求该应用存在一个已上架的版本。 默认值:1
statebody否string此参数无需设置。
phasedReleaseStartTimebody否string分阶段发布生效开始时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。
phasedReleaseEndTimebody否string分阶段发布生效结束时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。
phasedReleasePercentbody否string分阶段发布百分比。 Android应用取值范围为0.00到100.00,必须精确到两位小数,不含百分号。 HarmonyOS应用取值为0.00到100.00,可以不带小数或只带一位小数,不含百分号。
phasedReleaseDescriptionbody否string分阶段发布说明。
isPureDetectionbody否integer是否申请绿色应用认证。 取值范围: 0:否 1:是
sensitivePermissionIconUrlbody否string绿色认证审核材料的objectId,isPureDetection=1时为必填项。该值为将绿色认证审核材料打成zip包,然后先调用获取上传文件地址接口,然后调用上传文件接口上传审核材料,最后得到获取上传文件地址接口返回的objectId。
isCommitSensitivePermissionTipsbody否boolean确认是否符合相关要求,true表示符合。isPureDetection=1时为必填项,且只可以填true。要求包括: 非必要的使用场景禁止桌面、锁屏和其他应用弹出窗口骚扰用户行为。 非必要的使用场景禁止发送无法删除的常驻通知。 禁止影响用户体验的广告,如抬头、强制插屏、侧边等。 禁止引导用户开启开发者选项。 禁止引导用户开启USB调试模式。 禁止通过热补丁,引入恶意行为和不符合以上条款的行为。

请求体: json

查看接口定义

agc publishing app-submit --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-submit

调用预演(先填写所需参数)

agc publishing app-submit --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST通过下载方式提交发布app-submit-with-file/api/publish/v2/app-submit-with-file

如果您将软件包保存在自己的服务器上,可以直接调用本接口提交应用审核,并传入软件包的下载地址。华为服务器会自动从下载地址中下载软件包后启动发布流程。接口调用者的角色:账号持有者、管理员、APP管理员。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
releaseTimebody否string指定发布时间,如果为空表示审核通过立即上架。UTC时间:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。
remarkbody否string提交发布的备注信息,可以为空,如果填写,长度范围在10-300。
releaseTypebody否integer发布方式。 取值范围: 1:全网。 3:分阶段。 默认值:1
downloadUrlbody是string由您提供的软件包下载地址,支持APK/RPK/AAB/EXE等。 APK:不超过4GB。 RPK:快应用不超过20MB,快游戏不超过30MB。 AAB:不超过150MB。 EXE(Windows应用): 不超过4GB。
downloadFileNamebody是stringdownloadUrl下载地址中下载的文件名,包括后缀。
callbackAddrbody否string应用发布回调地址,由您自行配置。应用发布结果由华为服务器调用回调结果通知接口通过该URL回调给您的开发者服务器。
requestIdbody是string您自定义的请求字符串,必须唯一标识此请求。结果回调时会携带该字段。
clearArkbody否string是否清除方舟包(用于Android + 方舟升级到Android)。 取值范围: 1:需要清除方舟包。 0:不需要清除方舟包。 默认值:0。
sensitivePermissionDescbody否string敏感信息。
phasedReleaseInfobody否object分阶段发布信息。releaseType为3时,此参数必选。
versionNamebody否stringWindows应用的软件包版本号。 文件类型为exe软件包时必选。
displayNamebody否string注册表显示名称,用于唯一标识Windows用。 文件类型为exe软件包时必选。
isPureDetectionbody否integer是否申请绿色应用认证。 取值范围: 0:否 1:是
sensitivePermissionIconUrlbody否string绿色认证审核材料的objectId,isPureDetection=1时为必填项。该值为将绿色认证审核材料打成zip包,然后先调用获取上传文件地址接口,然后调用上传文件接口上传审核材料,最后得到获取上传文件地址接口返回的objectId。
isCommitSensitivePermissionTipsbody否boolean是否确认符合相关要求,true表示符合。isPureDetection=1时为必填项,且只可以填true。要求包括: 非必要的使用场景禁止桌面、锁屏和其他应用弹出窗口骚扰用户行为。 非必要的使用场景禁止发送无法删除的常驻通知。 禁止影响用户体验的广告,如抬头、强制插屏、侧边等。 禁止引导用户开启开发者选项。 禁止引导用户开启USB调试模式。 禁止通过热补丁,引入恶意行为和不符合以上条款的行为。

请求体: json

查看接口定义

agc publishing app-submit-with-file --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-submit-with-file

调用预演(先填写所需参数)

agc publishing app-submit-with-file --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询应用包名对应的appidappid-list/api/publish/v2/appid-list

此接口用于根据HarmonyOS应用/元服务的应用包名查询对应的应用ID,支持一次查询多个应用包名。

开发者调用华为 API

已登记参数
参数位置必填类型说明
packageNamequery是string需要查询的应用包名。 多个包名以逗号分隔,最多支持50个。
packageTypesquery否string通过软件包类型过滤应用,只查询指定软件包类型的应用。 取值范围: 7:APP(HarmonyOS应用/元服务)

查看接口定义

agc publishing appid-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/appid-list

调用预演(先填写所需参数)

agc publishing appid-list --invoke --dry-run=true
查看接口参考文档 ↗
PUT设置应用GMS依赖属性gms/api/publish/v2/properties/gms

此接口用于向AGC上报应用是否依赖GMS。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
needGmsbody是integer应用是否依赖GMS。 取值范围: 0:不依赖 1:依赖

请求体: json

查看接口定义

agc publishing gms --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/gms

调用预演(先填写所需参数)

agc publishing gms --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
DELETE删除应用语言信息language-info-delete/api/publish/v2/app-language-info

此接口用于删除指定HarmonyOS应用/元服务不需要的语言描述信息,默认语言不支持删除。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要删除语言描述信息的应用ID。
langquery是string需要删除的语言。 说明 取值参见语言类型。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1

查看接口定义

agc publishing language-info-delete --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/language-info-delete

调用预演(先填写所需参数)

agc publishing language-info-delete --invoke --dry-run=true
查看接口参考文档 ↗
PUT更新语言描述信息language-info-update/api/publish/v2/app-language-info

此接口用于更新指定应用的语言描述信息,如果当前没有语言描述信息则新增。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string需要更新语言描述信息的应用ID。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 3:分阶段 默认值:1
langbody是string语言种类,取值参见语言类型。
appNamebody否string对应语言的应用名称。新增一个语言种类时,此字段必选。
appDescbody否string对应语言的应用描述信息。
briefInfobody否string对应语言的一句话简介。
newFeaturesbody否string对应语言的新版本简介。

请求体: lang,appName,appDesc,briefInfo,newFeatures

查看接口定义

agc publishing language-info-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/language-info-update

调用预演(先填写所需参数)

agc publishing language-info-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询软件包列表obbfile-package-list/api/publish/v2/package-list

此接口用于查询应用当前关联的软件包列表信息。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
fromRecCountquery否integer查询起始记录号。 默认值:1
maxReqCountquery否integer请求查询的软件包数。 取值范围:最大为100 默认值:10

查看接口定义

agc publishing obbfile-package-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/obbfile-package-list

调用预演(先填写所需参数)

agc publishing obbfile-package-list --invoke --dry-run=true
查看接口参考文档 ↗
PUT更新分阶段发布phased-release/api/publish/v2/phased-release

此接口用于将分阶段发布修改为全网发布,或者更新分阶段发布的设置。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
releaseTypequery否integer需要修改的发布方式。支持将分阶段发布修改为全网发布。 取值范围: 1:全网。 说明 如果选择全网发布,Body请传空对象{}。 3:分阶段。 默认值:3
statebody否string分阶段发布的状态。 取值范围: SUSPEND:暂停。 RELEASE:恢复为发布中。
phasedReleaseStartTimebody否string分阶段发布生效开始时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。已上架的分阶段发布应用,不允许修改开始时间。
phasedReleaseEndTimebody否string分阶段发布生效结束时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。
phasedReleasePercentbody否string分阶段发布百分比。取值为大于0.00且小于100.00,必须精确到两位小数,不含百分号。
phasedReleaseDescriptionbody否string分阶段发布说明。

请求体: json

查看接口定义

agc publishing phased-release --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/phased-release

调用预演(先填写所需参数)

agc publishing phased-release --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询软件包编译状态query-aabfile/api/publish/v2/package/compile/status

此接口用于查询软件包的编译状态。接口调用者的角色:账号持有者、管理员、APP管理员。

开发者调用华为 API

已登记参数
参数位置必填类型说明
teamIdheader否string开发者所在团队的团队ID,可通过获取团队列表接口获取。
appIdquery是string应用ID。
pkgIdsquery是string待查询的软件包id,多个id之间用逗号分隔。 对应查询软件包列表接口返回的pkgVersion参数。

查看接口定义

agc publishing query-aabfile --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/query-aabfile

调用预演(先填写所需参数)

agc publishing query-aabfile --invoke --dry-run=true
查看接口参考文档 ↗
PUT更新版本上架时间update-releasetime/api/publish/v2/on-shelf-time

此接口用于设置版本的上架时间。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string应用ID。
changeTypebody是integer修改类型。 取值范围: 2:指定时间上架改为审核通过立即上架 3:变更定时上架时间
releaseTimebody是string指定的版本上架时间。 UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 changeType为3时有效。
releaseTypebody是integer发布方式。 取值范围: 1:全网 目前支持全网及releasePhase为3的分阶段发布。

请求体: changeType,releaseTime,releaseType

查看接口定义

agc publishing update-releasetime --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/update-releasetime

调用预演(先填写所需参数)

agc publishing update-releasetime --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询团队账号下的成员角色列表members-role-list/api/publish/v3/members-role-list

此接口用于查询团队账号下的成员角色列表和团队主账号的开发者信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
fromPagequery是integer起始页。 最小值:1,表示从第1页开始查询。
pageSizequery是integer每页查询的条数。 取值范围:[1,50]
languageCodequery是string语言码。 取值范围: zh_cn:中文 en_us:英文 ru_ru:俄语

查看接口定义

agc publishing members-role-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/members-role-list

调用预演(先填写所需参数)

agc publishing members-role-list --invoke --dry-run=true
查看接口参考文档 ↗
PUT更新应用基本信息app-info-update-v3/api/publish/v3/app-info

此接口用于更新指定HarmonyOS应用/元服务的应用详情。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要更新的应用ID。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasequery否integer分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0
defaultLangbody否string应用的默认语言。 说明 取值参见语言类型。
harmonyChildTypebody否integerHarmonyOS应用/元服务的二级分类。 固定ID。 说明 取值参见应用游戏分类。
kindMainTagbody否integerHarmonyOS应用/元服务主标签。 固定ID。 说明 取值参见应用游戏分类的“标签”列。
kindSubTagsbody否arrayHarmonyOS应用/元服务附属标签。 固定ID。最多可选4个附属标签。 说明 取值参见应用游戏分类的“标签”列。
privacyPolicybody否string隐私政策网址。
appNetTypebody否integer应用联网类型。 取值范围: 1:单机 2:网游 默认值:1
publishCountrybody是string应用发布国家的国家码。 多个国家以英文逗号分隔,例如:“CN,DE,MC”。 如果取值为“OTHER”,则表示当App Gallery支持的国家或地区列表中新增某个国家或地区时,应用将自动分发到新增的国家和地区。 注意 取值不能只包含OTHER。 如果国家码有设置非CN的地区,将存在个人信息出境的情况,具体请参考个人信息出境授权声明。
appTariffTypebody否string应用内付费道具类型。 取值范围: 1:激活收费 2:道具收费 3:关卡收费 4:购买虚拟币 5:部分章节收费(图书阅读类) 6:其他的 7:课程收费 8:会员收费 支持设置多个,使用英文逗号分隔,例如“1,2,3”。
publicationNumberbody否string版号信息。 此参数只支持游戏类应用。
developerWebsitebody否string开发者官网。
customInfobody否object客服信息。
deviceTypesbody否array设备类型信息。
privacyRightsUrlbody否string隐私权利网址。 即关于您的用户实施其权利的网站地址,如用户删除、修改、导出其个人数据的入口。
registeredDclTypebody否integerAPP类型信息。 取值范围: -1:清空APP类型信息 0:APP服务器在中国大陆 1:APP服务器不在中国大陆 2:APP为单机APP
registeredIdTypebody否integer主办单位类型。 取值范围: -1:清空数据(会联动清空registeredIdNumber的内容) 1:企业(社会信用代码) 2:个人(身份证号码) 3:机构(机构代码)
registeredIdNumberbody否string主办单位证件号。 取值范围: registeredIdType为1时,对应统一社会信用代码 registeredIdType为2时,对应身份证号码 registeredIdType为3时,对应组织机构代码
registeredEntitybody否integer主办单位。 取值范围: 1:与开发者账号主体一致 2:与开发者账号主体不一致 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 若在版本提交时,该字段值选择“一致”,则主办单位名称和证件号,将直接复用开发者联盟注册账号信息。 若您提交的主办单位信息与联盟账号信息不一致,该字段值却选择了“一致”,则系统将自动判定为“不一致”,将会影响审核结果。
registeredEntityNamebody否string主办单位名称。 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。
privacyAgreementIdbody否string隐私协议ID。
userAgreementUrlbody否string用户协议URL。
userAgreementIdsbody否array用户协议ID列表。 当userAgreementUrl和userAgreementIds同时传值时,以userAgreementIds值为准。 数组长度不超过5。
encryptedbody是integer包是否加密。 取值范围: 0:否,表示不加密。 1:是,表示加密。 默认值:1
isAiGeneratebody否integer是否涉及AI生成合成服务。 取值范围: 0:不涉及。 1:涉及。
aiTypesbody否array涉及的AI生成合成服务类型。 取值范围: -1:其他 1:文本 2:图片 3:音频 4:视频 5:虚拟场景 说明 isAiGenerate取值为1(涉及)时,此参数必填。
testUserNamebody否string应用审核信息的测试账号用户名。 说明 如果存在需要登录后才可使用的功能,需要提供测试账号用户名。
testUserPasswordbody否string应用审核信息的测试账号密码。 说明 如果存在需要登录后才可使用的功能,需要提供测试账号密码。
appRemarkbody否string应用审核信息的备注。 提供有助于审核人员更准确、高效测试您应用的额外信息,比如在审核时需要的特别设置等。
selfTestVideosbody否string应用审核信息的自测文件。 格式为JSON字符串,示例:{"objectId1":"文件名1","objectId2":"文件名2"...} 说明 objectId的获取流程:先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。 最多可上传5个自测视频,总大小不超过500MB。 注意 此字段只支持元服务。 元服务需要与设备联动时,此参数必填。
appReviewPhoneInfobody否object应用负责人的手机号信息。用于沟通审核问题。
appReviewEmailInfobody否object应用负责人的邮箱账号信息。用于接收上架审核结果,应用整改或下架通知。
appReviewNamebody否string应用负责人的姓名。
versionVocsbody否array应用版本已解决问题。 数组长度不超过1000。 说明 调用查询应用未处理的问题工单接口可以查询用户反馈的应用问题。如果在应用版本更新时某些问题已经解决,可以将这些问题提交审核,工单平台验证通过后会关闭工单。

请求体: defaultLang,harmonyChildType,kindMainTag,kindSubTags,privacyPolicy,appNetType,publishCountry,appTariffType,publicationNumber,developerWebsite,customInfo,deviceTypes,privacyRightsUrl,registeredDclType,registeredIdType,registeredIdNumber,registeredEntity,registeredEntityName,privacyAgreementId,userAgreementUrl,userAgreementIds,encrypted,isAiGenerate,aiTypes,testUserName,testUserPassword,appRemark,selfTestVideos,appReviewPhoneInfo,appReviewEmailInfo,appReviewName,versionVocs

查看接口定义

agc publishing app-info-update-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-info-update-v3

调用预演(先填写所需参数)

agc publishing app-info-update-v3 --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新应用语言信息language-info-update-v3/api/publish/v3/app-language-info

此接口用于更新指定的HarmonyOS应用/元服务的语言描述信息,如果当前没有语言描述信息则新增。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要更新语言描述信息的应用ID。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasequery否integer分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0
langbody是string语言种类。 说明 取值参见语言类型。
appNamebody否string对应语言的应用名称。 新增一个语言种类时,此字段必选。
appDescbody否string对应语言的应用描述信息。
briefInfobody否string对应语言的一句话简介。
newFeaturesbody否string对应语言的新版本简介。 说明 升级版本时,此参数必填。

请求体: lang,appName,appDesc,briefInfo,newFeatures

查看接口定义

agc publishing language-info-update-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/language-info-update-v3

调用预演(先填写所需参数)

agc publishing language-info-update-v3 --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新应用文件信息app-file-info-v3/api/publish/v3/app-file-info

图片、视频等文件上传完成后,通过该接口刷新HarmonyOS应用/元服务的文件信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要更新的应用ID。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasequery否integer分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0
appIconListbody否array应用图标信息。 数组长度不超过20。 说明 应用图标必须与软件包中的应用图标一致,且需符合审核政策与应用文件要求。
screenShotListbody否array应用介绍截图信息。 数组长度不超过20。 说明 在同一语言、同一设备下,同时更新的截图素材和视频素材方向必须保持一致,否则将报错。
introVideoListbody否array应用介绍视频信息。 数组长度不超过20。 说明 在同一语言、同一设备下,同时更新的截图素材和视频素材方向必须保持一致,否则将报错。
rcmdVideoListbody否array推荐视频信息。 数组长度不超过20。
rcmdPicListbody否array推荐图片信息。 数组长度不超过20。
elecCertificatebody否string电子版本证书。
certificateListbody否array应用版权证书或代理证书。 数组长度不超过10。
publicationListbody否array版号证明。 数组长度不超过10。
packagePermissionIntroVideoListbody否array包权限使用场景说明视频。 数组长度不超过100。 说明 隐私权限说明的“权限描述”、“权限使用设备范围”和“权限使用理由”从上传的软件包体中读取,无需通过接口更新。
otherCertificatesURLbody否string授权书及其他材料文件压缩包的objectId。 说明 objectId的获取流程:先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。 若文件格式不正确,提交发布时会出错,具体限制如下: 压缩包必须为zip格式,不超过200MB。 解压后的大小不超过1GB。 文件夹层级不超过3层。 只能包含JPG、JPEG、BMP格式图片和PDF格式的文件,累计不超过200个。 说明 此字段只支持HarmonyOS应用,不支持元服务。
updateScreenShotListbody否array更新截图素材。 数组长度不超过20。
updateVideoListbody否array更新视频素材。 数组长度不超过20。

请求体: appIconList,screenShotList,introVideoList,rcmdVideoList,rcmdPicList,elecCertificate,certificateList,publicationList,packagePermissionIntroVideoList,otherCertificatesURL,updateScreenShotList,updateVideoList

查看接口定义

agc publishing app-file-info-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-file-info-v3

调用预演(先填写所需参数)

agc publishing app-file-info-v3 --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新应用软件包信息app-package-info-update/api/publish/v3/app-package-info

APP软件包上传完成后,通过该接口刷新HarmonyOS应用/元服务的软件包信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要更新的应用ID。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasequery否integer分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0
fileNamebody是string文件名称,包括文件的后缀名。
objectIdbody是string文件在文件服务器中的对象ID。 说明 objectId的获取流程:先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。

请求体: fileName,objectId

查看接口定义

agc publishing app-package-info-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-package-info-update

调用预演(先填写所需参数)

agc publishing app-package-info-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新分阶段发布phased-release-update/api/publish/v2/version/phased-release

此接口用于将分阶段发布修改为全网发布,或者更新分阶段发布的设置。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
versionIdbody是string版本ID。 可从查询应用所有版本类型的版本列表接口返回的versionId参数中获取。
releasePhasebody否integer分阶段发布标识。 取值范围: 3:分阶段。 4:分阶段转全网。
statebody否string分阶段发布的状态。 取值范围: SUSPEND:暂停。 RELEASE:恢复为发布中。
descriptionbody否string分阶段发布说明。
phaseDaybody否integer更新分阶段天数。 取值范围2、3、4、5、6、7,对应分阶段发布比例加速到2%、5%、10%、20%、50%、100%。

请求体: versionId,releasePhase,state,description,phaseDay

查看接口定义

agc publishing phased-release-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/phased-release-update

调用预演(先填写所需参数)

agc publishing phased-release-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询应用软件包信息app-package-info-query/api/publish/v2/app-package-info

此接口用于查询HarmonyOS应用/元服务的软件包信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
packageIdquery是string待查询的软件包ID。

查看接口定义

agc publishing app-package-info-query --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-package-info-query

调用预演(先填写所需参数)

agc publishing app-package-info-query --invoke --dry-run=true
查看接口参考文档 ↗
POST查询应用未处理的问题工单app-version-voc/api/publish/v1/app-voc/version-voc

此接口用于查询HarmonyOS应用/元服务未处理的问题工单。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
vocIdbody否string工单ID。
vocDescbody否string工单描述。
pageNobody是integer当前页。 最小值:1
pageSizebody是integer每页数量。 最大值:100

请求体: vocId,vocDesc,pageNo,pageSize

查看接口定义

agc publishing app-version-voc --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-version-voc

调用预演(先填写所需参数)

agc publishing app-version-voc --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询需要上传的资质文件信息tag-qual-dependent/api/publish/v2/tag-qual-dependent

此接口用于查询元服务需要上传的所有资质文件信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明

注册表未列出参数,请查看接口参考。

查看接口定义

agc publishing tag-qual-dependent --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/tag-qual-dependent

调用预演(先填写所需参数)

agc publishing tag-qual-dependent --invoke --dry-run=true
查看接口参考文档 ↗
POST提交资质审核任务qualification-review-create/api/publish/v2/qualification-review-task

此接口用于提交元服务的资质审核任务。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
tagQualInfosbody是array标签和标签对应的资质信息列表。 数组长度不超过5。

请求体: tagQualInfos

查看接口定义

agc publishing qualification-review-create --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/qualification-review-create

调用预演(先填写所需参数)

agc publishing qualification-review-create --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET查询资质审核任务详情qualification-review-query/api/publish/v2/qualification-review-task

此接口用于查询元服务的资质审核任务详情。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
tagIdsquery是string审核任务包含的标签ID列表,逗号分隔。

查看接口定义

agc publishing qualification-review-query --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/qualification-review-query

调用预演(先填写所需参数)

agc publishing qualification-review-query --invoke --dry-run=true
查看接口参考文档 ↗
PUT修改资质审核任务qualification-review-update/api/publish/v2/qualification-review-task

此接口用于修改元服务的资质审核任务。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
tagQualInfosbody是array标签和标签对应的资质信息列表。 数组长度不超过5。

请求体: tagQualInfos

查看接口定义

agc publishing qualification-review-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/qualification-review-update

调用预演(先填写所需参数)

agc publishing qualification-review-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT撤销资质审核任务qualification-review-cancel/api/publish/v2/qualification-review-task/cancel

此接口用于撤销元服务的资质审核任务。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
taskIdbody是string资质审核任务ID。

请求体: taskId

查看接口定义

agc publishing qualification-review-cancel --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/qualification-review-cancel

调用预演(先填写所需参数)

agc publishing qualification-review-cancel --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
DELETE删除资质审核任务qualification-review-delete/api/publish/v2/qualification-review-task

此接口用于删除元服务的资质审核任务。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
tagIdsbody是array需要删除的资质审核标签ID列表,逗号分隔。 数组长度不超过5。 说明 具体取值请参见元服务的“标签ID”列。

请求体: tagIds

查看接口定义

agc publishing qualification-review-delete --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/qualification-review-delete

调用预演(先填写所需参数)

agc publishing qualification-review-delete --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST新建用户协议user-agreement-create/api/publish/v2/agreement

此接口用于新建HarmonyOS应用/元服务的用户协议。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
typebody是integer协议类型。 取值范围: 2:用户协议
defaultLangbody否string用户协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾)
agreementInfosbody否array用户协议列表。 数组长度不超过100。
channelbody否integer官方创建用户协议请求样例中的渠道字段。

请求体: type,defaultLang,agreementInfos,channel

查看接口定义

agc publishing user-agreement-create --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/user-agreement-create

调用预演(先填写所需参数)

agc publishing user-agreement-create --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST查询用户协议列表user-agreement-list/api/publish/v2/agreement/list

此接口用于查询HarmonyOS应用/元服务的用户协议信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
agreementIdListbody否array用户协议ID。 数组长度为1~1000。
namebody是string用户协议名称。 使用模糊查询方式。
statusbody否integer用户协议状态。 取值范围: 2:已完成 3:已删除
typebody否integer协议类型。 取值范围: 2:用户协议
fromRecCountbody否integer查询起始位置。 默认值:1
maxReqCountbody否integer最大请求查询数。 取值范围:[1,100] 默认值:30

请求体: agreementIdList,name,status,type,fromRecCount,maxReqCount

查看接口定义

agc publishing user-agreement-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/user-agreement-list

调用预演(先填写所需参数)

agc publishing user-agreement-list --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新用户协议user-agreement-update/api/publish/v2/agreement

此接口用于更新HarmonyOS应用/元服务的用户协议信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
idbody是string用户协议ID。
defaultLangbody否string用户协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾)
agreementInfosbody否array用户协议列表。 数组长度不超过100。

请求体: id,defaultLang,agreementInfos

查看接口定义

agc publishing user-agreement-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/user-agreement-update

调用预演(先填写所需参数)

agc publishing user-agreement-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT提交隐私政策协议privacy-agreement-submit/api/publish/v2/agreement/submit

此接口用于提交HarmonyOS应用/元服务的隐私政策协议。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
idbody是string隐私政策协议ID。
requireConfirmbody否integer是否弹窗确认。 取值范围: 1:是 0:否

请求体: id,requireConfirm

查看接口定义

agc publishing privacy-agreement-submit --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/privacy-agreement-submit

调用预演(先填写所需参数)

agc publishing privacy-agreement-submit --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST查询隐私政策协议列表privacy-agreement-list/api/publish/v2/agreement/list

此接口用于查询HarmonyOS应用/元服务的隐私政策协议信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
agreementIdListbody否array隐私政策协议ID。 数组长度为1~1000。
namebody是string隐私政策协议名称。 使用模糊查询方式。
statusbody否integer隐私政策协议状态。 取值范围: 1:草稿 2:已完成 3:已删除 不传值:默认查未删除的记录
typebody否integer协议类型。 取值范围: 1:隐私政策协议
fromRecCountbody否integer起始页数。 默认值:1
maxReqCountbody否integer每页返回条数。 取值范围:[1,100] 默认值:30

请求体: agreementIdList,name,status,type,fromRecCount,maxReqCount

查看接口定义

agc publishing privacy-agreement-list --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/privacy-agreement-list

调用预演(先填写所需参数)

agc publishing privacy-agreement-list --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT更新隐私政策协议privacy-agreement-update/api/publish/v2/agreement

此接口用于更新HarmonyOS应用/元服务的隐私政策协议。接口调用者的角色:账号持有者、管理员、APP管理员、运营。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
idbody是string隐私政策协议ID。
defaultLangbody否string隐私政策协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾)
agreementInfosbody否array隐私政策协议列表。 数组长度不超过100。

请求体: id,defaultLang,agreementInfos

查看接口定义

agc publishing privacy-agreement-update --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/privacy-agreement-update

调用预演(先填写所需参数)

agc publishing privacy-agreement-update --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST申请年龄分级app-age-rating/api/publish/v2/app-age-rating

此接口用于申请或修改HarmonyOS应用/元服务的年龄分级。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID。 获取方法参考查看应用信息。
releaseTypequery否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasequery否integer分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0
feedbackbody是string问卷内容。 说明 具体请参见feedback获取方式。
expectedRatingbody否integer预期年龄分级。 取值范围: 1:巴西适用所有年龄段,中国区及其他区域年满3周岁 2:中国区年满8周岁,巴西年满10周岁,其他区域年满7周岁 3:巴西年满14周岁,中国区及其他区域年满12周岁 4:年满16周岁 5:年满18周岁
ratingRulebody否integer年龄分级生效规则。 取值范围: 0:以问卷内容评级结果为准。 1:当预期年龄分级expectedRating设置的值大于问卷评级结果中的年龄值时,以预期年龄分级为准,否则以问卷内容评级结果为准。
childFlagbody否integer应用是否仅面向儿童。 取值范围: 0:应用不仅面向儿童 1:应用仅面向儿童

请求体: feedback,expectedRating,ratingRule,childFlag

查看接口定义

agc publishing app-age-rating --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-age-rating

调用预演(先填写所需参数)

agc publishing app-age-rating --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST提交发布app-submit-v3/api/publish/v3/app-submit

此接口用于提交HarmonyOS应用/元服务审核,调用本接口前必须保证应用信息已补充完整,应用软件包已经上传。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string应用ID。
releaseTimebody否string指定发布时间。 UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 可以不用填写,则表示立刻发布。 说明 如果在首次提交发布时已设置过releaseTime参数,撤销审核后再次提交发布时,需要将releaseTime参数重新设置为过去的时间,才能实现立即发布。
remarkbody否string提审发布备注。 可以为空,如果填写则长度范围为10-300。
releaseTypebody否integer应用发布方式。 取值范围: 1:全网 默认值:1
releasePhasebody否integer分阶段发布标识。 取值范围: 0:全网发布 3:分阶段发布(7天内自动更新) 默认值:0
phasedReleaseDescriptionbody否string分阶段发布说明。 说明 releasePhase取值为3(分阶段发布)时,此参数必填。

请求体: releaseTime,remark,releaseType,releasePhase,phasedReleaseDescription

查看接口定义

agc publishing app-submit-v3 --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-submit-v3

调用预演(先填写所需参数)

agc publishing app-submit-v3 --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT撤销审核on-shelf-cancel/api/publish/v3/version/on-shelf/cancel

此接口用于HarmonyOS应用/元服务的撤销审核,当应用发布方式为“全网”时,只有处于“审核中”、“预审中”、“升级审核中”、“待上架/预约上架”、“申请下架”状态的应用可以撤销审核;当应用发布方式为“HarmonyOS测试发布方式(API>=10)”时,只有处于“正在审核”状态的应用可以撤销审核。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdheader是string应用ID,获取方法参考查看应用信息。
versionIdbody是string版本ID。

请求体: versionId

查看接口定义

agc publishing on-shelf-cancel --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/on-shelf-cancel

调用预演(先填写所需参数)

agc publishing on-shelf-cancel --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST下架应用app-shelf-off/api/publish/v2/app-shelf-off

此接口用于对已经上架的应用进行下架处理。

开发者调用华为 API

已登记参数
参数位置必填类型说明
appIdquery是string需要下架的应用ID。
reasonquery是string下架的原因描述。 说明 中文字符需要进行URL编码后再传入。
releaseTypequery否integer下架的方式。 取值范围: 1:全网下架。 默认值:1

请求体: json

查看接口定义

agc publishing app-shelf-off --pretty

本地 REST 定义地址

/api/v1/publishing/endpoints/app-shelf-off

调用预演(先填写所需参数)

agc publishing app-shelf-off --invoke --dry-run=true --body body.json
查看接口参考文档 ↗

agc-cli 是什么,适合谁使用?

agc-cli 是 Createitv 开源的华为 AppGallery Connect 命令行工具,安装后的命令名是 agc。它面向鸿蒙和华为应用开发者,将接口发现、凭据 Profile、请求预演与 API 调用组织成可复用命令,适合需要维护应用资料、测试用户、商品和报表的个人开发者与团队。

项目与使用指南: GitHub · 使用指南 · Issues

常见问题

agc-cli 是华为官方工具吗?

不是。agc-cli 是 Createitv 维护的独立开源项目,使用 MIT 许可证。它基于华为 AppGallery Connect API 参考文档组织接口,不代表华为官方产品或官方支持服务。

如何在 macOS、Windows 和 Linux 安装 agc-cli?

已安装 Node.js 18+ 时,三个系统都可运行 npm install --global @createitv/agc-cli。macOS 也可使用 Homebrew,Windows 也可使用 Scoop。安装后运行 agc version 检查版本。

agc-cli 免费吗,需要付费账号吗?

agc-cli 使用 MIT 许可证,可免费使用和修改。调用华为 API 需要自己的 AppGallery Connect 账号、凭据和相应权限;华为平台服务的费用和限制以华为说明为准。浏览官网接口和使用 CLI 查看接口定义无需登录。

如何开始第一次应用信息查询?

先用 agc auth login --service-account-file ~/.agc/service-account.json --name production 保存凭据,再用 agc init --app-id YOUR_APP_ID --default-profile production 绑定项目。运行 agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=zh-CN 预演请求,确认后增加 --dry-run=false 发送请求。接口要求 client_id 时显式补上请求头。

156 个接口是否都完成了生产验证?

156 表示注册表中的接口条目数量,分属 13 个 API 家族,不代表每个接口都已完成生产验证。注册表展示已登记参数和调用入口;完整请求、响应、权限与业务前置条件以每个接口链接的参考文档为准。

默认 dry-run 会修改我的应用吗?

不会。带 --invoke 的接口命令默认构建并预览请求,不发送远程请求。真实调用需显式设置 --dry-run=false;调用前应检查目标应用、所选凭据和参数。

可以把 agc-cli 用在脚本或 AI Agent 中吗?

可以。默认 JSON 输出适合脚本处理,agc capabilities 和 agc endpoints 提供能力发现;agc web-server 提供本地 REST 接口,agc openapi 导出接口契约。命令模板帮助导航,但不能替代业务状态检查或审核判断。

如何安装 agc-cli 的 Codex 或 Claude Agent Skills?

先安装 agc-cli,再运行 agc skills list 查看 6 个任务型 Skills。使用 agc skills install --agent codex --global 安装全部 Skills,或增加 --name agc-publishing 只安装发布 Skill。也可以从官网直接下载对应的 SKILL.md。

项目 Profile 会自动填入所有接口参数吗?

项目配置可以绑定默认凭据 Profile,临时切换时使用 --profile。应用 ID、语言、请求头和请求体等接口参数仍需按接口要求显式提供。不要将 Service Account 私钥或凭据文件提交到 Git。

按 API 家族浏览完整参考

内容更新:

快速开始

三条命令,建立可检查的项目工作区。

请将占位符替换为 AppGallery Connect 的真实值。第二条命令会让该项目自动选择对应 Profile。

01

保存凭据 Profile

推荐使用 Service Account。密钥会以受限权限保存在 ~/.agc/credentials.json。

$ agc auth login --service-account-file ~/.agc/service-account.json --name production
02

绑定当前项目

保存项目资料与默认凭据 Profile;调用接口时仍按要求填写应用 ID 等参数。

$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production
03

调用前先检查

接口命令默认 dry-run。确认 method 与 URL 后,再明确执行真实请求。

$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false

本地命令中心

浏览器看到的,就是 CLI 使用的同一份注册表。

需要实时能力数据时启动本地 REST 服务;未启动时,官网仍会作为完整参考界面工作。

agc web-server --addr :8421
GET/api/v1/capabilities家族与下一步操作
GET/api/v1/endpoints全部接口条目
GET/api/v1/openapi.json机器可读契约
POST/api/v1/:family/endpoints/:id/invoke默认 dry-run