SuperAPI AI 工具集

asc-subscription-localization

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:通过 asc 命令行工具,批量创建或更新订阅、订阅组、内购(IAP)在各 App Store 语言区域下的显示名称,并在支持时更新描述,替代在 App Store Connect 中逐语言手动点击。

前置条件:已配置认证(asc auth login 或 ASC_* 环境变量);已知应用 ID(ASC_APP_ID 或 --app);订阅组与订阅已存在。

API 范围:API 4.4.1 为 IAP、订阅、订阅组引入独立版本(version)。版本 ID 与产品、订阅或组 ID 不同。新本地化工作应使用 asc ... versions localizations ... 版本级命令,不要使用产品级或组级 v1 本地化命令(已弃用并会输出迁移警告)。切勿把产品、订阅或组 ID 传给版本级命令。

版本解析:先用 asc iap versions list、asc subscriptions versions list、asc subscriptions groups versions list 配合 --state PREPARE_FOR_SUBMISSION --paginate 列出可变更版本。零匹配则创建(versions create),一匹配则复用该版本 ID,多匹配则停止并要求显式指定版本 ID。三类版本均无删除命令;父级删除不会级联清理版本。

支持语言区域:ar-SA、ca、cs、da、de-DE、el、en-AU、en-CA、en-GB、en-US、es-ES、es-MX、fi、fr-CA、fr-FR、he、hi、hr、hu、id、it、ja、ko、ms、nl-NL、no、pl、pt-BR、pt-PT、ro、ru、sk、sv、th、tr、uk、vi、zh-Hans、zh-Hant。

用法:先 list 现有本地化,再仅对缺失语言区域 create,最后 list 验证。更新用 update --id。订阅与 IAP 版本本地化的描述必须非空,Apple 线上服务会拒绝空描述与 --clear-description;若只提供显示名称,只能更新已有本地化,不能创建缺失语言区域,需先获得非空描述。订阅组版本本地化无描述字段,可用 --custom-app-name。清除元数据需显式使用 --clear-name 或 --clear-custom-app-name,且不要与对应赋值标志同时使用。

限制:无批量 API,每个语言区域需单独 create 调用;对已存在语言区域创建会失败;list 命令应加 --paginate;只有应用名称而无 ID 时可参考 asc-id-resolver 技能。批量写入后应运行 list 验证完整性,单个语言区域失败时记录并继续,最后汇总报告。