用途:通过 asc 命令行管理 Apple Ads,包括 OAuth 配置、广告账户与 ACL 发现、Platform API v1 的广告系列与定向、报表、素材上传及原始请求;同时保留已弃用的 v5 命令。Apple Ads 凭据与 App Store Connect 凭据相互独立,需单独配置。
主要能力:身份与 ACL 查询(asc ads me view、acls list、orgs view);应用搜索与账户验证;广告系列、广告组、广告的查询与创建、暂停、恢复、删除;定向关键词与否定关键词;品牌与素材上传;报表、洞察、建议与变更历史;共享预算(budget-orders)。直接命令使用 Platform API v1 与广告账户 ID,旧版命令位于 asc ads v5 并使用组织 ID,两者不可混用;v5 将于 2027 年 1 月 26 日退役。
使用方式:先登录并绑定账户,例如 asc ads auth login 配合 --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 等变量。非交互管道可用 --file - 从 stdin 读取 JSON 请求体。资源、报表、上传和 raw 命令输出无损 JSON,可用 jq 做投影。运行命令前先用 --help 查看具体叶子命令;v1 请求体与 v5 不同,CLI 不做转换。
限制与注意:绝不可用组织 ID 替代广告账户 ID。变更操作需用户确认广告账户、资源类型、目标 ID 和请求体,创建广告系列可能产生支出;CampaignCreate 需要 adAccountId、billingEvent、dailyBudget、name、promotedObjectId、promotedObjectType 和 targeting,且 CLI 不注入 adAccountId。素材仅在 eligibility.status 为 ELIGIBLE 时可用。报表命令不接受 --paginate,需在请求体中设置分页。raw 请求仅接受 v1/... 路径或 https://api.ads.apple.com/v1/... URL。部分 v5 叶子命令在 v1 中没有一一对应的替代。官方资料未提供具体定价信息。