为终端而生的 AppGallery Connect 控制面

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

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

快速开始浏览 156 个接口

13 API 家族156 已注册接口3 输出格式

agc / production参考模式

一个命令入口，连接你的工作流。

鉴权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

用系统包管理器安装。

macOS 通过 Createitv Homebrew tap 安装：brew tap createitv/tap && brew install agc-cli。Windows 通过 Scoop 和 Createitv bucket 安装。

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

Homebrew formula：agc-cli 正式 GitHub Release 二进制 Winget PR 已提交等待 Microsoft 审核

发布轨道

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

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

鉴权

PS256 / OAuth

PROFILE

项目自动绑定

软件包

上传与状态

发布

确认后调用

Profile 自动绑定

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

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

1命令行显式覆盖--profile staging
2项目默认 Profile.agc/project.json
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 调用方式。

当前家族 / pms

商品管理

已注册

管理 HarmonyOS 与 Android 商品、订阅、促销、审核资料与价格。

发现agc pms endpoints --output table

状态agc pms status --pretty

本地 REST/api/v1/pms

40 个类型化接口条目

全部接口 40

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

POST创建商品addproduct-android/api/pms/product-price-service/v1/manage/product

此接口用于创建商品定义信息，包含商品价格，展示语言等。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addproduct-android

调用预演（先填写所需参数）

agc pms addproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST创建商品addproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于创建商品定义信息，包含商品价格，展示语言等。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms addproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST创建商品订阅分组信息addproductgroup-android/api/pms/product-price-service/v1/manage/product/group

此接口用于创建商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addproductgroup-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addproductgroup-android

调用预演（先填写所需参数）

agc pms addproductgroup-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST创建商品订阅分组信息addproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group

此接口用于创建商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addproductgroup-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addproductgroup-harmonyosnext

调用预演（先填写所需参数）

agc pms addproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST创建商品促销信息addpromotion-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于创建商品促销信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addpromotion-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addpromotion-android

调用预演（先填写所需参数）

agc pms addpromotion-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST创建商品促销信息addpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于创建商品促销信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms addpromotion-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/addpromotion-harmonyosnext

调用预演（先填写所需参数）

agc pms addpromotion-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

GET查询关联APP已有商品类型basicapplication-harmonyosnext/api/pms/product-price-service/v2/manage/application/basic

此接口用于查询关联APP已有商品类型。

开发者调用华为 API

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

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

查看接口定义

agc pms basicapplication-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/basicapplication-harmonyosnext

调用预演（先填写所需参数）

agc pms basicapplication-harmonyosnext --invoke --dry-run=true

查看接口参考文档 ↗

PUT批量激活商品batchactproduct-android/api/pms/product-price-service/v1/manage/product/batchActive

此接口用于批量激活商品。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchactproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchactproduct-android

调用预演（先填写所需参数）

agc pms batchactproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量激活商品batchactproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchActive

此接口用于批量激活商品，生效已下线商品，已结束的促销不会重新生效。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchactproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchactproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms batchactproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量上线商品促销活动batchactpromotion-android/api/pms/product-price-service/v1/manage/product/promotion/batchActive

此接口用于批量上线商品促销活动。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchactpromotion-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchactpromotion-android

调用预演（先填写所需参数）

agc pms batchactpromotion-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量上线商品促销活动batchactpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/batchActive

此接口用于批量上线商品促销活动。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchactpromotion-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchactpromotion-harmonyosnext

调用预演（先填写所需参数）

agc pms batchactpromotion-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST批量创建商品batchaddproduct-android/api/pms/product-price-service/v1/manage/product/batchImportProducts

此接口用于批量创建商品定义信息，展示语言，商品价格，促销活动信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchaddproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchaddproduct-android

调用预演（先填写所需参数）

agc pms batchaddproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST批量创建商品batchaddproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchImportProducts

此接口用于批量创建商品定义信息，展示语言，商品价格，促销活动信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchaddproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchaddproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms batchaddproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量去激活商品batchdeactproduct-android/api/pms/product-price-service/v1/manage/product/batchDeactive

此接口用于批量去激活商品。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchdeactproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchdeactproduct-android

调用预演（先填写所需参数）

agc pms batchdeactproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量去激活商品batchdeactproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchDeactive

此接口用于批量去激活商品，下线已生效商品，结束促销活动。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchdeactproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchdeactproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms batchdeactproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量下线商品促销活动batchdeactpromotion-android/api/pms/product-price-service/v1/manage/product/promotion/batchDeactive

此接口用于批量下线商品促销活动。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchdeactpromotion-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchdeactpromotion-android

调用预演（先填写所需参数）

agc pms batchdeactpromotion-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量下线商品促销活动batchdeactpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/batchDeactive

此接口用于批量下线商品促销活动。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchdeactpromotion-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchdeactpromotion-harmonyosnext

调用预演（先填写所需参数）

agc pms batchdeactpromotion-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量更新商品batchupdateproduct-android/api/pms/product-price-service/v1/manage/product/batchImportProducts

此接口用于批量更新商品定义信息，展示语言，商品价格，促销活动信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchupdateproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchupdateproduct-android

调用预演（先填写所需参数）

agc pms batchupdateproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT批量更新商品batchupdateproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchImportProducts

此接口用于批量更新商品定义信息，展示语言，商品价格，促销活动信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms batchupdateproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/batchupdateproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms batchupdateproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST按条件查询商品信息bygetproductinfo-android/api/pms/product-price-service/v1/manage/product/list

此接口用于商品查询，支持多条件过滤，根据productNo和AppId唯一查询一个商品信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms bygetproductinfo-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/bygetproductinfo-android

调用预演（先填写所需参数）

agc pms bygetproductinfo-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST按条件查询商品信息bygetproductinfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/list

此接口用于商品查询，支持多条件过滤，根据productNo和AppId唯一查询一个商品信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms bygetproductinfo-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/bygetproductinfo-harmonyosnext

调用预演（先填写所需参数）

agc pms bygetproductinfo-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST按条件查询商品促销信息bygetpromotioninfo-android/api/pms/product-price-service/v1/manage/product/promotion/list

此接口用于商品促销查询，支持多条件过滤。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms bygetpromotioninfo-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/bygetpromotioninfo-android

调用预演（先填写所需参数）

agc pms bygetpromotioninfo-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST按条件查询商品促销信息bygetpromotioninfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/list

此接口用于商品促销查询，支持多条件过滤。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms bygetpromotioninfo-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/bygetpromotioninfo-harmonyosnext

调用预演（先填写所需参数）

agc pms bygetpromotioninfo-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST查询商品订阅分组信息getproductgroup-android/api/pms/product-price-service/v1/manage/product/group/list

此接口用于查询商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms getproductgroup-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getproductgroup-android

调用预演（先填写所需参数）

agc pms getproductgroup-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST查询商品订阅分组信息getproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group/list

此接口用于查询商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms getproductgroup-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getproductgroup-harmonyosnext

调用预演（先填写所需参数）

agc pms getproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

GET查询商品详情getproductinfo-android/api/pms/product-price-service/v1/manage/product

此接口用于商品详情查询，根据productNo和appId唯一查询一个商品信息。

开发者调用华为 API

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

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

查看接口定义

agc pms getproductinfo-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getproductinfo-android

调用预演（先填写所需参数）

agc pms getproductinfo-android --invoke --dry-run=true

查看接口参考文档 ↗

GET查询商品详情getproductinfo-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于商品详情查询，根据productNo和appId唯一查询一个商品信息。

开发者调用华为 API

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

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

查看接口定义

agc pms getproductinfo-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getproductinfo-harmonyosnext

调用预演（先填写所需参数）

agc pms getproductinfo-harmonyosnext --invoke --dry-run=true

查看接口参考文档 ↗

GET查询商品促销详情getpromotioninfo-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于查询商品促销信息。

开发者调用华为 API

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

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

查看接口定义

agc pms getpromotioninfo-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getpromotioninfo-android

调用预演（先填写所需参数）

agc pms getpromotioninfo-android --invoke --dry-run=true

查看接口参考文档 ↗

GET查询商品促销详情getpromotioninfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于查询商品促销信息。

开发者调用华为 API

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

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

查看接口定义

agc pms getpromotioninfo-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/getpromotioninfo-harmonyosnext

调用预演（先填写所需参数）

agc pms getpromotioninfo-harmonyosnext --invoke --dry-run=true

查看接口参考文档 ↗

GET查询是否有在线商品isproductactive-android/api/pms/product-price-service/v1/manage/product/check

此接口用于根据AppId查询是否有激活的商品。

开发者调用华为 API

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

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

查看接口定义

agc pms isproductactive-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/isproductactive-android

调用预演（先填写所需参数）

agc pms isproductactive-android --invoke --dry-run=true

查看接口参考文档 ↗

GET查询是否有在线商品isproductactive-harmonyosnext/api/pms/product-price-service/v2/manage/product/check

此接口用于根据AppId查询是否有激活的商品。

开发者调用华为 API

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

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

查看接口定义

agc pms isproductactive-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/isproductactive-harmonyosnext

调用预演（先填写所需参数）

agc pms isproductactive-harmonyosnext --invoke --dry-run=true

查看接口参考文档 ↗

PUT更新商品订阅分组等级信息levelgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group/level

此接口用于更新商品订阅分组等级信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms levelgroup-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/levelgroup-harmonyosnext

调用预演（先填写所需参数）

agc pms levelgroup-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST上传资源resourcemanage-harmonyosnext/api/pms/product-price-service/v2/manage/resource

此接口用于提交上传资源。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms resourcemanage-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/resourcemanage-harmonyosnext

调用预演（先填写所需参数）

agc pms resourcemanage-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

POST提交商品审核reviewproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/review

此接口用于提交商品审核。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms reviewproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/reviewproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms reviewproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品信息updateproduct-android/api/pms/product-price-service/v1/manage/product

此接口用于更新商品定义信息，包含商品价格，展示语言和商品状态。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updateproduct-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updateproduct-android

调用预演（先填写所需参数）

agc pms updateproduct-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品信息updateproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于更新商品定义信息，包含商品价格，展示语言和商品状态。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updateproduct-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updateproduct-harmonyosnext

调用预演（先填写所需参数）

agc pms updateproduct-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品订阅分组信息updateproductgroup-android/api/pms/product-price-service/v1/manage/product/group

此接口用于更新商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updateproductgroup-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updateproductgroup-android

调用预演（先填写所需参数）

agc pms updateproductgroup-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品订阅分组信息updateproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group

此接口用于更新商品订阅分组信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updateproductgroup-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updateproductgroup-harmonyosnext

调用预演（先填写所需参数）

agc pms updateproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品促销信息updatepromotion-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于更新商品促销信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updatepromotion-android --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updatepromotion-android

调用预演（先填写所需参数）

agc pms updatepromotion-android --invoke --dry-run=true --body body.json

查看接口参考文档 ↗

PUT更新商品促销信息updatepromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于更新商品促销信息。

开发者调用华为 API

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

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

请求体: json

查看接口定义

agc pms updatepromotion-harmonyosnext --pretty

本地 REST 定义地址

/api/v1/pms/endpoints/updatepromotion-harmonyosnext

调用预演（先填写所需参数）

agc pms updatepromotion-harmonyosnext --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？

macOS：brew tap createitv/tap，然后 brew install agc-cli。Windows：scoop bucket add createitv https://github.com/Createitv/scoop-bucket，然后 scoop install agc-cli。Linux：从 GitHub Releases 下载适合架构的二进制。安装后运行 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 导出接口契约。命令模板帮助导航，但不能替代业务状态检查或审核判断。

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

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

按 API 家族浏览完整参考

内容更新: 2026-10-07

快速开始

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

请将占位符替换为 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

GET/api/v1/capabilities家族与下一步操作

GET/api/v1/endpoints全部接口条目

GET/api/v1/openapi.json机器可读契约

POST/api/v1/:family/endpoints/:id/invoke默认 dry-run

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

用系统包管理器安装。

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

鉴权

PROFILE

软件包

发布

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

先发现 API，再编写请求。

商品管理

全部接口 40

agc-cli 是什么，适合谁使用？

常见问题

按 API 家族浏览完整参考

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

保存凭据 Profile

绑定当前项目

调用前先检查

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

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