用途:通过 asc ads 命令管理 Apple Ads。Apple Ads 凭据与 App Store Connect 凭据相互独立,asc auth login 不会配置 Ads。
主要能力:直接使用 asc ads <resource> 命令走 Apple Ads Platform API v1,需要广告账户 ID;已弃用的 Campaign Management API v5 命令位于 asc ads v5 ...,使用组织 ID,Apple 将于 2027 年 1 月 26 日停用 v5。两者 ID 不可混用。覆盖广告账户、广告主资源、应用资格与本地化、品牌与素材、地理定向与共享预算、应用与品牌报表、洞察、建议、推荐和变更历史等。
使用方式:先认证并固定账户,例如 asc ads auth login 配合 --name、--client-id、--team-id、--key-id、--private-key、--ad-account、--org、--network;CI 中可设置 ASC_ADS_CLIENT_ID、ASC_ADS_TEAM_ID、ASC_ADS_KEY_ID、ASC_ADS_PRIVATE_KEY_PATH、ASC_ADS_AD_ACCOUNT_ID、ASC_ADS_BYPASS_KEYCHAIN=1 等变量。用 asc ads auth status --validate、asc ads auth discover、asc ads auth doctor 检查认证。非交互管道可用 --file - 从 stdin 读取 JSON 请求体。资源、报表、上传和原始命令输出无损 JSON,建议用 jq 做投影。
限制与注意:变更前需用户确认广告账户、资源类型、目标 ID 和载荷;创建广告系列可能产生花费,CampaignCreate 需要 adAccountId、billingEvent、dailyBudget、name、promotedObjectId、promotedObjectType 和 targeting,CLI 原样发送文件,--ad-account 不会注入 adAccountId。显式 PAUSED 状态可免 --confirm,否则需要。删除、批量创建或更新、推荐应用或忽略、预算订单写入等高风险操作需确认。素材上传使用专用 multipart 命令,仅在 eligibility.status 为 ELIGIBLE 时使用。原始 v1 请求仅接受 v1/... 路径或 https://api.ads.apple.com/v1/... URL。v5 迁移需逐命令进行,部分 v5 叶子命令没有对应的单命令 v1 替代。具体收费、价格和平台细节暂未提供。