用途:本技能用于指导运行或设计面向 App Store Connect 的 asc 命令,覆盖标志、输出格式、分页、认证与命令发现。
命令发现:始终用 --help 查看命令与标志,如 asc --help、asc builds --help、asc builds list --help。用 asc search 做本地确定性发现,如 asc search "submit app for review"、asc search --output table "upload build"。用 asc schema 查看内置端点模式与请求/查询字段,如 asc schema --pretty "GET /v1/apps"、asc schema --method POST appStoreVersions。用 asc capabilities 说明 CLI 支持、部分支持、Web 会话及公共 API 受限的工作流覆盖。
规范动词:只读命令优先用 view 而非旧 get 别名,如 asc apps view --id "APP_ID"、asc versions view --version-id "VERSION_ID"。仅更新的可用性界面优先用 edit,如 asc pricing availability edit --app "APP_ID" --territory "USA,GBR" --available true。用 asc pricing availability create 初始化可用性后再用仅更新的 edit;若 Apple 拒绝公共 API 引导,可认证 Web 会话用 asc web apps availability create,或在 App Store Connect 中配置。
标志约定:使用显式长标志(--app、--output);自动化中优先显式标志;破坏性操作需 --confirm;需要全部页面时用 --paginate;命令专属标志放在叶子子命令之后;--next URL 视为不透明续接,不与新过滤、排序或分页标志组合。
输出格式:默认 TTY 感知,交互终端为 table,管道或非交互为 json;--output table/markdown 仅用于人类可读输出;--pretty 仅对 JSON 有效;除 stdout 外还要检查退出状态,失败批处理可能产生部分回执。
认证与默认值:优先用 asc auth login 的钥匙串认证;回退环境变量 ASC_KEY_ID、ASC_ISSUER_ID、ASC_PRIVATE_KEY_PATH、ASC_PRIVATE_KEY、ASC_PRIVATE_KEY_B64;ASC_APP_ID 可提供默认应用 ID。App Store Server API 读取位于 asc storekit,使用单独的 In-App Purchase 密钥(asc storekit auth login)。权限不明时用 asc web auth capabilities 检查密钥角色覆盖。可用 asc web api-keys create 创建团队 API 密钥,需 Account Holder 或 Admin 会话,P8 保存为 AuthKey_<KEY_ID>.p8。API 密钥认证与 Apple Account Web 会话相互独立,复用前先检查 asc auth status 与 asc web auth status。非交互 Web 登录需 --two-factor-code-command 或 ASC_WEB_2FA_CODE_COMMAND。
Apple Ads:使用 asc ads auth、--ads-profile 和 ASC_ADS_* 变量,不用 App Store Connect API 凭据。直接资源命令用 Platform API v1 与 --ad-account 或 ASC_ADS_AD_ACCOUNT_ID;已弃用的 v5 命令位于 asc ads v5,用 --org 或 ASC_ADS_ORG_ID。删除及涉及支出、账单、投放、定向或访问的变更需 --confirm。
超时:ASC_TIMEOUT / ASC_TIMEOUT_SECONDS 控制请求超时;ASC_UPLOAD_TIMEOUT / ASC_UPLOAD_TIMEOUT_SECONDS 控制上传超时。