用途:用 asc app-events 命令在 App Store Connect 中创建和管理应用内活动,覆盖本地化文案、媒体上传与审核提交等环节。使用前先运行 asc app-events --help 及各子命令帮助,确认支持参数。
主要能力:列出与查看活动(asc app-events list/view);管理本地化(localizations list/create/update)与图片、视频素材(screenshots create、video-clips create);通过 Asset Library 复用素材并做 placements;提交审核(asc app-events submit),并可检查提交状态(asc review submissions-get)。解析结果时显式使用 --output json。
使用方式:先解析 app ID 与认证配置,创建活动时需给出 --name(内部名称,限 64 字符)、--event-type、未来 RFC 3339 的 start/end/publish-start、--deep-link、--primary-locale、--purchase-requirement、--priority、--purpose 等。日期需 start 早于 end,时长 15 分钟至 31 天,发布开始不得早于活动前 14 天且不晚于 start。本地化名称限 30 字符、短描述 50、长描述 120。图片支持 JPG/JPEG/PNG,单个不超过 500 MB,建议不含透明通道;EVENT_CARD 为 16:9、1920×1080 至 3840×2160,EVENT_DETAILS_PAGE 为 9:16、1080×1920 至 2160×3840。修改已有活动用 update,修改已有本地化用 update 加 --localization-id,不要重复创建。提交需有已过审的 iOS 版本,并使用 --confirm;无过审版本时应改为在首个版本的提交中加入该活动。
限制与注意事项:CLI 会解析时间戳但不强制 Apple 的全部排期规则;未填 deep link 的活动可能创建成功但不可提交审核。submit 成功回执不代表获批或已发布。命令失败可能残留草稿,重试前应先用 review submissions-list/get、items-list 检查并复用草稿,避免重复提交;403 应先核对配置与权限,不要据此轮换凭证。素材、预览效果与链接行为需在目标构建中自行验证,缺失信息以实际命令帮助与 Apple 官方要求为准。