$ npm install --global @createitv/agc-cli && agc version让每一次发布沿着 同一条红线前进。
用一套 Go 命令发现、预演并调用 AppGallery Connect API,为开发者、CI 和 Coding Agent 提供稳定 JSON。
$ agc auth check --pretty
{
"data": {
"name": "production",
"mode": "service-account",
"active": true
},
"affordances": {
"next": "agc publishing endpoints"
}
}已解析项目 Profile · 默认 dry-run
安装 agc CLI
用系统包管理器安装。
Windows、macOS 和 Linux CI 可通过同一条 NPM 命令无人值守安装。开发电脑仍可使用 Homebrew 或 Scoop 原生包。
$ brew tap createitv/tap && brew install agc-cli && agc versionPS> 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 versionAgent Skills
让 Coding Agent 真正理解 AppGallery Connect 工作流。
6 个可移植 Skills 参考 asc-cli 的任务分层方式设计。可以全部安装,也可以只选择一个工作流;每个 Skill 都支持查看源码、直接下载和通过 GitHub 参与完善。
提交一个 Skill$ agc skills install --agent codex --globalagc-cli-usage通用命令发现、dry-run 预演、授权执行和远程结果验证。
agc skills install --name agc-cli-usage --agent codex --globalagc-auth凭据 Profile、whoami、OAuth 团队查询和权限诊断。
agc skills install --name agc-auth --agent codex --globalagc-publishing应用资料、软件包、提交审核、分阶段发布和发布状态验证。
agc skills install --name agc-publishing --agent codex --globalagc-testing测试版本、群组、测试用户、邀请链接、反馈和版本转正。
agc skills install --name agc-testing --agent codex --globalagc-reports分发、安装、付费、留存和鸿蒙元服务报表导出。
agc skills install --name agc-reports --agent codex --globalagc-cicd跨平台固定版本安装、受保护凭据、dry-run 门禁和 CI 验证。
agc skills install --name agc-cicd --agent codex --global发布轨道
上下文向前流动,密钥留在本地。
每个阶段只完成一件事。凭据保存在本机,项目上下文可以安全共享,写入类 API 必须显式确认。
鉴权
PS256 / OAuth
PROFILE
项目自动绑定
软件包
上传与状态
发布
确认后调用
Profile 自动绑定
每个项目只选择一次,临时切换时再覆盖。
在 .agc/project.json 中绑定 production。命令会按固定优先级解析,也可以用 --profile staging 完成一次性切换。
- 1命令行显式覆盖
--profile staging - 2项目默认 Profile
.agc/project.json - 3全局激活账户
~/.agc/credentials.json
{
"appId": "123456789",
"projectId": "987654321",
"packageName": "com.example.app",
"profile": "production"
}接口注册表
先发现 API,再编写请求。
每个条目都包含 method、path、参数位置、CLI 命令、REST 路由和 dry-run 调用方式。
当前家族 / publishing
应用发布
管理发布资料、软件包状态、提交审核、撤回审核与定时发布。
agc publishing endpoints --output tableagc publishing status --pretty/api/v1/publishing全部接口 42
展开接口查看已登记参数与命令;完整协议、响应字段及权限以官方文档为准。
GET查询软件包编译状态package-compile-status-v3/api/publish/v3/package/compile/status
此接口用于查询HarmonyOS应用/元服务的软件包的编译状态。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 应用ID。 |
pkgIds | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
projectId | query | 否 | string | 项目ID,获取方法请参见查看应用信息。 如果不传projectId,系统会先在内部创建一个与应用同名的项目,随后再创建应用。 |
appName | body | 是 | string | 应用名称。 |
packageName | body | 否 | string | 应用包名,必须唯一,且不能与其他应用(包括Android应用)包名相同。 说明 installationFree取值为0(HarmonyOS应用)时,此参数必填。 installationFree取值为1(元服务)时,系统将自动生成包名,此参数无需填写。 |
parentType | body | 是 | integer | 应用分类。 取值范围: 2:游戏 13:应用 |
installationFree | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要查询的应用ID。 |
lang | query | 否 | string | 需要查询的语言。 说明 取值参考语言类型。 不传该参数,则查询全部语言的应用信息。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 6:HarmonyOS测试发布方式(API>=10) 默认值:1 |
versionId | query | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 否 | string | 应用ID,获取方法参考查看应用信息。 |
packageName | body | 否 | string | 应用包名。 说明 appId和packageName至少传一个。 |
state | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
downloadUrl | body | 是 | string | 由您自行提供的软件包下载地址。 APK:不超过4GB。 RPK:快应用不超过20MB,快游戏不超过30MB。 AAB:不超过150MB。 EXE(Windows应用):不超过4GB。 |
downloadFileName | body | 是 | string | 与downloadUrl配套的文件名,包括后缀。 |
callbackAddr | body | 否 | string | 回调地址,由您自行配置。软件包提交完成后由华为服务器调用回调结果通知接口通过该URL回调给您的开发者服务器。 |
requestId | body | 是 | string | 您自定义请求字符串,必须唯一标识此请求。结果回调时会携带该字段。 |
versionName | body | 否 | string | Windows应用的软件包版本号。 文件类型为exe软件包时必选。 |
displayName | body | 否 | string | 注册表显示名称,用于唯一标识Windows应用。 文件类型为exe软件包时必选。 |
packageType | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 需要查询的应用ID。 |
lang | query | 否 | string | 需要查询的语言,取值参考语言类型。不传该参数则查询全部语言的应用信息。 |
releaseType | query | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 3:分阶段 默认值:1 |
appId | query | 是 | string | 需要更新的应用ID。 |
defaultLang | body | 否 | string | 应用的默认语言,取值参见语言类型。 |
childType | body | 否 | integer | 应用的二级分类,固定ID,取值参见应用游戏分类。 |
grandChildType | body | 否 | integer | 应用的三级分类,固定ID,取值参见应用游戏分类。 |
privacyPolicy | body | 是 | string | 隐私声明地址。 |
appNetType | body | 否 | integer | 应用联网类型。 取值范围: 1:单机 2:网游 |
isFree | body | 否 | integer | 应用付费类型。 取值范围: 1:免费 0:付费 如果isFree为1,price和priceDetail参数将无效。 |
price | body | 否 | string | 应用价格,格式为{"countryCode":"price"}。countryCode为国家码,price为应用的价格。国家码列表请参见国家码,对应币种请参见ISO 4217标准。 AppGallery Connect会根据所在国家/地区的价格规则对最终价格做适当调整,具体规则请参见价格换算规则。 注意 当isFree为0时,此参数必选。 |
priceDetail | body | 否 | 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时,此参数必选。 |
publishCountry | body | 否 | string | 应用发布国家的国家码,多个国家以英文逗号分隔,例如:“CN,DE,MC”。如果取值为“OTHER”,表示当AppGallery支持的国家或地区列表中新增某个国家或地区时,应用将自动分发到新增的国家和地区。国家码列表请参见国家码。 注意 取值不能只包含OTHER。 |
isAppForcedUpdate | body | 否 | integer | 应用是否强制升级。 取值范围: 0:不强制 1:强制 |
hispaceAutoDown | body | 否 | integer | 是否允许华为应用市场抓包。 取值范围: 0:不允许 1:允许 |
appTariffType | body | 否 | string | 应用内付费道具类型。 取值范围: 1:激活收费 2:道具收费 3:关卡收费 4:购买虚拟币 5:部分章节收费(图书阅读类) 6:其他的 7:课程收费 8:会员收费 支持设置多个,使用英文逗号分隔,例如“1,2,3”。 |
publicationNumber | body | 否 | string | 版号信息。 此参数只支持游戏类应用。 |
cultureRecordNumber | body | 否 | string | 文化部备案编号。 此参数只支持游戏类应用。 |
developerWebsite | body | 否 | string | 开发者官网。 |
familyShareTag | body | 否 | integer | 是否可以家庭共享。 取值范围: 0:不可以。 1:可以。 |
deviceTypes | body | 否 | array | 设备类型信息。 |
webGameFlag | body | 否 | integer | 该应用是否为网页游戏。 取值范围: 0:否 1:是 该参数仅在应用为手机RPK游戏,且设备类型信息中适配设备类型包含Windows(appAdapters取值包含15)时才会生效。 |
privacyRightsUrl | body | 否 | string | 隐私权利网址,即关于您的用户实施其权利的网站地址,如用户删除、修改、导出其个人数据的入口。 |
registeredDclType | body | 否 | integer | APP类型信息。 取值范围: -1:清空APP类型信息 0:APP服务器在中国大陆 1:APP服务器不在中国大陆 2:APP为单机APP |
registeredIdType | body | 否 | integer | 主办单位类型。 取值范围: -1:清空数据(会联动清空registeredIdNumber的内容) 1:企业(社会信用代码) 2:个人(身份证号码) 3:机构(机构代码) |
registeredIdNumber | body | 否 | string | 主办单位证件号。 取值范围: registeredIdType为1时,对应统一社会信用代码 registeredIdType为2时,对应身份证号码 registeredIdType为3时,对应组织机构代码 |
registeredEntity | body | 否 | integer | 主办单位。 取值范围: 1:与开发者账号主体一致 2:与开发者账号主体不一致 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 若在版本提交时,该字段值选择“一致”,则主办单位名称和证件号,将直接复用开发者联盟注册账号信息。 若您提交的主办单位信息与联盟账号信息不一致,该字段值却选择了“一致”,则系统将自动判定为“不一致”,将会影响审核结果。 |
registeredEntityName | body | 否 | string | 主办单位名称。 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 |
userAgreementUrl | body | 否 | string | 用户协议URL。 |
encrypted | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
releaseTime | query | 否 | string | 指定发布的UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 说明 如果releaseTime未填写,应用审核通过后会立即上架。 |
remark | query | 否 | string | 提审发布的备注信息,可以为空。如果填写,长度范围在10-300。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 3:分阶段 说明 应用发布方式为分阶段发布时,要求该应用存在一个已上架的版本。 默认值:1 |
state | body | 否 | string | 此参数无需设置。 |
phasedReleaseStartTime | body | 否 | string | 分阶段发布生效开始时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 |
phasedReleaseEndTime | body | 否 | string | 分阶段发布生效结束时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 |
phasedReleasePercent | body | 否 | string | 分阶段发布百分比。 Android应用取值范围为0.00到100.00,必须精确到两位小数,不含百分号。 HarmonyOS应用取值为0.00到100.00,可以不带小数或只带一位小数,不含百分号。 |
phasedReleaseDescription | body | 否 | string | 分阶段发布说明。 |
isPureDetection | body | 否 | integer | 是否申请绿色应用认证。 取值范围: 0:否 1:是 |
sensitivePermissionIconUrl | body | 否 | string | 绿色认证审核材料的objectId,isPureDetection=1时为必填项。该值为将绿色认证审核材料打成zip包,然后先调用获取上传文件地址接口,然后调用上传文件接口上传审核材料,最后得到获取上传文件地址接口返回的objectId。 |
isCommitSensitivePermissionTips | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
releaseTime | body | 否 | string | 指定发布时间,如果为空表示审核通过立即上架。UTC时间:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 |
remark | body | 否 | string | 提交发布的备注信息,可以为空,如果填写,长度范围在10-300。 |
releaseType | body | 否 | integer | 发布方式。 取值范围: 1:全网。 3:分阶段。 默认值:1 |
downloadUrl | body | 是 | string | 由您提供的软件包下载地址,支持APK/RPK/AAB/EXE等。 APK:不超过4GB。 RPK:快应用不超过20MB,快游戏不超过30MB。 AAB:不超过150MB。 EXE(Windows应用): 不超过4GB。 |
downloadFileName | body | 是 | string | downloadUrl下载地址中下载的文件名,包括后缀。 |
callbackAddr | body | 否 | string | 应用发布回调地址,由您自行配置。应用发布结果由华为服务器调用回调结果通知接口通过该URL回调给您的开发者服务器。 |
requestId | body | 是 | string | 您自定义的请求字符串,必须唯一标识此请求。结果回调时会携带该字段。 |
clearArk | body | 否 | string | 是否清除方舟包(用于Android + 方舟升级到Android)。 取值范围: 1:需要清除方舟包。 0:不需要清除方舟包。 默认值:0。 |
sensitivePermissionDesc | body | 否 | string | 敏感信息。 |
phasedReleaseInfo | body | 否 | object | 分阶段发布信息。releaseType为3时,此参数必选。 |
versionName | body | 否 | string | Windows应用的软件包版本号。 文件类型为exe软件包时必选。 |
displayName | body | 否 | string | 注册表显示名称,用于唯一标识Windows用。 文件类型为exe软件包时必选。 |
isPureDetection | body | 否 | integer | 是否申请绿色应用认证。 取值范围: 0:否 1:是 |
sensitivePermissionIconUrl | body | 否 | string | 绿色认证审核材料的objectId,isPureDetection=1时为必填项。该值为将绿色认证审核材料打成zip包,然后先调用获取上传文件地址接口,然后调用上传文件接口上传审核材料,最后得到获取上传文件地址接口返回的objectId。 |
isCommitSensitivePermissionTips | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
packageName | query | 是 | string | 需要查询的应用包名。 多个包名以逗号分隔,最多支持50个。 |
packageTypes | query | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
needGms | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要删除语言描述信息的应用ID。 |
lang | query | 是 | string | 需要删除的语言。 说明 取值参见语言类型。 |
releaseType | query | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 需要更新语言描述信息的应用ID。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 3:分阶段 默认值:1 |
lang | body | 是 | string | 语言种类,取值参见语言类型。 |
appName | body | 否 | string | 对应语言的应用名称。新增一个语言种类时,此字段必选。 |
appDesc | body | 否 | string | 对应语言的应用描述信息。 |
briefInfo | body | 否 | string | 对应语言的一句话简介。 |
newFeatures | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
fromRecCount | query | 否 | integer | 查询起始记录号。 默认值:1 |
maxReqCount | query | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
releaseType | query | 否 | integer | 需要修改的发布方式。支持将分阶段发布修改为全网发布。 取值范围: 1:全网。 说明 如果选择全网发布,Body请传空对象{}。 3:分阶段。 默认值:3 |
state | body | 否 | string | 分阶段发布的状态。 取值范围: SUSPEND:暂停。 RELEASE:恢复为发布中。 |
phasedReleaseStartTime | body | 否 | string | 分阶段发布生效开始时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。已上架的分阶段发布应用,不允许修改开始时间。 |
phasedReleaseEndTime | body | 否 | string | 分阶段发布生效结束时间,UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 |
phasedReleasePercent | body | 否 | string | 分阶段发布百分比。取值为大于0.00且小于100.00,必须精确到两位小数,不含百分号。 |
phasedReleaseDescription | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
teamId | header | 否 | string | 开发者所在团队的团队ID,可通过获取团队列表接口获取。 |
appId | query | 是 | string | 应用ID。 |
pkgIds | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 应用ID。 |
changeType | body | 是 | integer | 修改类型。 取值范围: 2:指定时间上架改为审核通过立即上架 3:变更定时上架时间 |
releaseTime | body | 是 | string | 指定的版本上架时间。 UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 changeType为3时有效。 |
releaseType | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
fromPage | query | 是 | integer | 起始页。 最小值:1,表示从第1页开始查询。 |
pageSize | query | 是 | integer | 每页查询的条数。 取值范围:[1,50] |
languageCode | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要更新的应用ID。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | query | 否 | integer | 分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0 |
defaultLang | body | 否 | string | 应用的默认语言。 说明 取值参见语言类型。 |
harmonyChildType | body | 否 | integer | HarmonyOS应用/元服务的二级分类。 固定ID。 说明 取值参见应用游戏分类。 |
kindMainTag | body | 否 | integer | HarmonyOS应用/元服务主标签。 固定ID。 说明 取值参见应用游戏分类的“标签”列。 |
kindSubTags | body | 否 | array | HarmonyOS应用/元服务附属标签。 固定ID。最多可选4个附属标签。 说明 取值参见应用游戏分类的“标签”列。 |
privacyPolicy | body | 否 | string | 隐私政策网址。 |
appNetType | body | 否 | integer | 应用联网类型。 取值范围: 1:单机 2:网游 默认值:1 |
publishCountry | body | 是 | string | 应用发布国家的国家码。 多个国家以英文逗号分隔,例如:“CN,DE,MC”。 如果取值为“OTHER”,则表示当App Gallery支持的国家或地区列表中新增某个国家或地区时,应用将自动分发到新增的国家和地区。 注意 取值不能只包含OTHER。 如果国家码有设置非CN的地区,将存在个人信息出境的情况,具体请参考个人信息出境授权声明。 |
appTariffType | body | 否 | string | 应用内付费道具类型。 取值范围: 1:激活收费 2:道具收费 3:关卡收费 4:购买虚拟币 5:部分章节收费(图书阅读类) 6:其他的 7:课程收费 8:会员收费 支持设置多个,使用英文逗号分隔,例如“1,2,3”。 |
publicationNumber | body | 否 | string | 版号信息。 此参数只支持游戏类应用。 |
developerWebsite | body | 否 | string | 开发者官网。 |
customInfo | body | 否 | object | 客服信息。 |
deviceTypes | body | 否 | array | 设备类型信息。 |
privacyRightsUrl | body | 否 | string | 隐私权利网址。 即关于您的用户实施其权利的网站地址,如用户删除、修改、导出其个人数据的入口。 |
registeredDclType | body | 否 | integer | APP类型信息。 取值范围: -1:清空APP类型信息 0:APP服务器在中国大陆 1:APP服务器不在中国大陆 2:APP为单机APP |
registeredIdType | body | 否 | integer | 主办单位类型。 取值范围: -1:清空数据(会联动清空registeredIdNumber的内容) 1:企业(社会信用代码) 2:个人(身份证号码) 3:机构(机构代码) |
registeredIdNumber | body | 否 | string | 主办单位证件号。 取值范围: registeredIdType为1时,对应统一社会信用代码 registeredIdType为2时,对应身份证号码 registeredIdType为3时,对应组织机构代码 |
registeredEntity | body | 否 | integer | 主办单位。 取值范围: 1:与开发者账号主体一致 2:与开发者账号主体不一致 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 若在版本提交时,该字段值选择“一致”,则主办单位名称和证件号,将直接复用开发者联盟注册账号信息。 若您提交的主办单位信息与联盟账号信息不一致,该字段值却选择了“一致”,则系统将自动判定为“不一致”,将会影响审核结果。 |
registeredEntityName | body | 否 | string | 主办单位名称。 说明 当registeredDclType值为0(APP服务器在中国大陆)时,该字段必填。若不填写或填写错误,会导致审核不通过。 |
privacyAgreementId | body | 否 | string | 隐私协议ID。 |
userAgreementUrl | body | 否 | string | 用户协议URL。 |
userAgreementIds | body | 否 | array | 用户协议ID列表。 当userAgreementUrl和userAgreementIds同时传值时,以userAgreementIds值为准。 数组长度不超过5。 |
encrypted | body | 是 | integer | 包是否加密。 取值范围: 0:否,表示不加密。 1:是,表示加密。 默认值:1 |
isAiGenerate | body | 否 | integer | 是否涉及AI生成合成服务。 取值范围: 0:不涉及。 1:涉及。 |
aiTypes | body | 否 | array | 涉及的AI生成合成服务类型。 取值范围: -1:其他 1:文本 2:图片 3:音频 4:视频 5:虚拟场景 说明 isAiGenerate取值为1(涉及)时,此参数必填。 |
testUserName | body | 否 | string | 应用审核信息的测试账号用户名。 说明 如果存在需要登录后才可使用的功能,需要提供测试账号用户名。 |
testUserPassword | body | 否 | string | 应用审核信息的测试账号密码。 说明 如果存在需要登录后才可使用的功能,需要提供测试账号密码。 |
appRemark | body | 否 | string | 应用审核信息的备注。 提供有助于审核人员更准确、高效测试您应用的额外信息,比如在审核时需要的特别设置等。 |
selfTestVideos | body | 否 | string | 应用审核信息的自测文件。 格式为JSON字符串,示例:{"objectId1":"文件名1","objectId2":"文件名2"...} 说明 objectId的获取流程:先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。 最多可上传5个自测视频,总大小不超过500MB。 注意 此字段只支持元服务。 元服务需要与设备联动时,此参数必填。 |
appReviewPhoneInfo | body | 否 | object | 应用负责人的手机号信息。用于沟通审核问题。 |
appReviewEmailInfo | body | 否 | object | 应用负责人的邮箱账号信息。用于接收上架审核结果,应用整改或下架通知。 |
appReviewName | body | 否 | string | 应用负责人的姓名。 |
versionVocs | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要更新语言描述信息的应用ID。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | query | 否 | integer | 分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0 |
lang | body | 是 | string | 语言种类。 说明 取值参见语言类型。 |
appName | body | 否 | string | 对应语言的应用名称。 新增一个语言种类时,此字段必选。 |
appDesc | body | 否 | string | 对应语言的应用描述信息。 |
briefInfo | body | 否 | string | 对应语言的一句话简介。 |
newFeatures | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要更新的应用ID。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | query | 否 | integer | 分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0 |
appIconList | body | 否 | array | 应用图标信息。 数组长度不超过20。 说明 应用图标必须与软件包中的应用图标一致,且需符合审核政策与应用文件要求。 |
screenShotList | body | 否 | array | 应用介绍截图信息。 数组长度不超过20。 说明 在同一语言、同一设备下,同时更新的截图素材和视频素材方向必须保持一致,否则将报错。 |
introVideoList | body | 否 | array | 应用介绍视频信息。 数组长度不超过20。 说明 在同一语言、同一设备下,同时更新的截图素材和视频素材方向必须保持一致,否则将报错。 |
rcmdVideoList | body | 否 | array | 推荐视频信息。 数组长度不超过20。 |
rcmdPicList | body | 否 | array | 推荐图片信息。 数组长度不超过20。 |
elecCertificate | body | 否 | string | 电子版本证书。 |
certificateList | body | 否 | array | 应用版权证书或代理证书。 数组长度不超过10。 |
publicationList | body | 否 | array | 版号证明。 数组长度不超过10。 |
packagePermissionIntroVideoList | body | 否 | array | 包权限使用场景说明视频。 数组长度不超过100。 说明 隐私权限说明的“权限描述”、“权限使用设备范围”和“权限使用理由”从上传的软件包体中读取,无需通过接口更新。 |
otherCertificatesURL | body | 否 | string | 授权书及其他材料文件压缩包的objectId。 说明 objectId的获取流程:先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。 若文件格式不正确,提交发布时会出错,具体限制如下: 压缩包必须为zip格式,不超过200MB。 解压后的大小不超过1GB。 文件夹层级不超过3层。 只能包含JPG、JPEG、BMP格式图片和PDF格式的文件,累计不超过200个。 说明 此字段只支持HarmonyOS应用,不支持元服务。 |
updateScreenShotList | body | 否 | array | 更新截图素材。 数组长度不超过20。 |
updateVideoList | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要更新的应用ID。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | query | 否 | integer | 分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0 |
fileName | body | 是 | string | 文件名称,包括文件的后缀名。 |
objectId | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
versionId | body | 是 | string | 版本ID。 可从查询应用所有版本类型的版本列表接口返回的versionId参数中获取。 |
releasePhase | body | 否 | integer | 分阶段发布标识。 取值范围: 3:分阶段。 4:分阶段转全网。 |
state | body | 否 | string | 分阶段发布的状态。 取值范围: SUSPEND:暂停。 RELEASE:恢复为发布中。 |
description | body | 否 | string | 分阶段发布说明。 |
phaseDay | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
packageId | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
vocId | body | 否 | string | 工单ID。 |
vocDesc | body | 否 | string | 工单描述。 |
pageNo | body | 是 | integer | 当前页。 最小值:1 |
pageSize | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
tagQualInfos | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
tagIds | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
tagQualInfos | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
taskId | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
tagIds | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
type | body | 是 | integer | 协议类型。 取值范围: 2:用户协议 |
defaultLang | body | 否 | string | 用户协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾) |
agreementInfos | body | 否 | array | 用户协议列表。 数组长度不超过100。 |
channel | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
agreementIdList | body | 否 | array | 用户协议ID。 数组长度为1~1000。 |
name | body | 是 | string | 用户协议名称。 使用模糊查询方式。 |
status | body | 否 | integer | 用户协议状态。 取值范围: 2:已完成 3:已删除 |
type | body | 否 | integer | 协议类型。 取值范围: 2:用户协议 |
fromRecCount | body | 否 | integer | 查询起始位置。 默认值:1 |
maxReqCount | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
id | body | 是 | string | 用户协议ID。 |
defaultLang | body | 否 | string | 用户协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾) |
agreementInfos | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
id | body | 是 | string | 隐私政策协议ID。 |
requireConfirm | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
agreementIdList | body | 否 | array | 隐私政策协议ID。 数组长度为1~1000。 |
name | body | 是 | string | 隐私政策协议名称。 使用模糊查询方式。 |
status | body | 否 | integer | 隐私政策协议状态。 取值范围: 1:草稿 2:已完成 3:已删除 不传值:默认查未删除的记录 |
type | body | 否 | integer | 协议类型。 取值范围: 1:隐私政策协议 |
fromRecCount | body | 否 | integer | 起始页数。 默认值:1 |
maxReqCount | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
id | body | 是 | string | 隐私政策协议ID。 |
defaultLang | body | 否 | string | 隐私政策协议默认语言。 取值范围: zh:简体中文 en:英语 ug:维吾尔语 bo:藏语 zh-Hant-HK:繁体中文(中国香港特别行政区) zh-Hant-TW:繁体中文(中国台湾) |
agreementInfos | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID。 获取方法参考查看应用信息。 |
releaseType | query | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | query | 否 | integer | 分阶段发布标识。 取值范围: 0:全网 3:分阶段 默认值:0 |
feedback | body | 是 | string | 问卷内容。 说明 具体请参见feedback获取方式。 |
expectedRating | body | 否 | integer | 预期年龄分级。 取值范围: 1:巴西适用所有年龄段,中国区及其他区域年满3周岁 2:中国区年满8周岁,巴西年满10周岁,其他区域年满7周岁 3:巴西年满14周岁,中国区及其他区域年满12周岁 4:年满16周岁 5:年满18周岁 |
ratingRule | body | 否 | integer | 年龄分级生效规则。 取值范围: 0:以问卷内容评级结果为准。 1:当预期年龄分级expectedRating设置的值大于问卷评级结果中的年龄值时,以预期年龄分级为准,否则以问卷内容评级结果为准。 |
childFlag | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 应用ID。 |
releaseTime | body | 否 | string | 指定发布时间。 UTC时间格式:yyyy-MM-ddTHH:mm:ssZZ,例如“2015-01-01T01:01:01+0800”。 可以不用填写,则表示立刻发布。 说明 如果在首次提交发布时已设置过releaseTime参数,撤销审核后再次提交发布时,需要将releaseTime参数重新设置为过去的时间,才能实现立即发布。 |
remark | body | 否 | string | 提审发布备注。 可以为空,如果填写则长度范围为10-300。 |
releaseType | body | 否 | integer | 应用发布方式。 取值范围: 1:全网 默认值:1 |
releasePhase | body | 否 | integer | 分阶段发布标识。 取值范围: 0:全网发布 3:分阶段发布(7天内自动更新) 默认值:0 |
phasedReleaseDescription | body | 否 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | header | 是 | string | 应用ID,获取方法参考查看应用信息。 |
versionId | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
appId | query | 是 | string | 需要下架的应用ID。 |
reason | query | 是 | string | 下架的原因描述。 说明 中文字符需要进行URL编码后再传入。 |
releaseType | query | 否 | 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
GEO · AEO · LLMO
面向 AI Agent 的可读取文档
这些公开文件提供项目事实、任务选择、安全边界、Skills 和完整接口契约。Coding Agent 可以直接读取,无需执行 JavaScript、登录或猜测页面结构。
常见问题
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。
保存凭据 Profile
推荐使用 Service Account。密钥会以受限权限保存在 ~/.agc/credentials.json。
$ agc auth login --service-account-file ~/.agc/service-account.json --name production绑定当前项目
保存项目资料与默认凭据 Profile;调用接口时仍按要求填写应用 ID 等参数。
$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production调用前先检查
接口命令默认 dry-run。确认 method 与 URL 后,再明确执行真实请求。
$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false本地命令中心
浏览器看到的,就是 CLI 使用的同一份注册表。
需要实时能力数据时启动本地 REST 服务;未启动时,官网仍会作为完整参考界面工作。
agc web-server --addr :8421/api/v1/capabilities家族与下一步操作/api/v1/endpoints全部接口条目/api/v1/openapi.json机器可读契约/api/v1/:family/endpoints/:id/invoke默认 dry-run