腾讯广告主账号管理

问题背景与需求

在腾讯广告投放中，广告主经常需要管理多个竞价广告账户，例如查询账户信息、调整日预算或监控资金状况。手动操作这些任务不仅繁琐，还可能在批量处理时引入错误。传统方式依赖网页界面，缺乏脚本化支持，难以集成到自动化工作流中。

核心功能与工作流程

该技能通过 Node.js 脚本调用腾讯广告 API，提供以下核心能力：

• 查询广告主账号列表：使用 get-account-list.mjs 脚本，基于当前用户关联的竞价广告主账户，支持按公司名称模糊搜索（最多 2 个关键词，长度 2~50 字符）和分页查询（默认每页 10 条，总分页上限 13000）。
• 日预算管理：通过 get-daily-budget.mjs 查询账户日预算，使用 update-daily-budget.mjs 修改预算，可选参数如 use_min_daily_budget 用于控制最小预算规则。
• 资金账户信息查询：get-funds.mjs 查询各类资金账户余额、锁定金额和今日消耗，get-wallet.mjs 获取共享钱包信息（余额、绑定账户等），均支持按 account_id 调用。
• 日结明细与钱包查询：get-daily-balance-report.mjs 获取资金账户日结明细（包含日终结余），get-wallet-basic-info.mjs 通过钱包 ID 查询基础信息。

工作流程通常遵循以下步骤：

1. 环境准备：安装 tencentads-cli（Node.js ≥ 20）并配置 tencentads-auth 技能以设置 API Key 凭据。
2. 脚本调用：在技能根目录下执行脚本，例如查询账号列表：

   node scripts/get-account-list.mjs '{"corporation_name_fuzzy_list":["示例公司"]}'
   

注意 JSON 参数传递需遵循跨平台规则（如 Linux 使用单引号，Windows CMD 使用双引号转义）。

1. 结果处理：解析脚本返回的 JSON 数据，用于展示或进一步操作。

适用场景与注意事项

该技能适用于自动化管理腾讯广告主账户的场景，但需注意以下边界和限制：

• 仅支持竞价广告主：所有脚本只处理竞价类型账户，不包括代理商或其他账户类型。
• 分页限制：查询账号列表时，严格要求 page * page_size ≤ 13000，超出将导致 API 报错。
• JSON 参数传递规则：不同终端（如 Bash、CMD、PowerShell）对 JSON 引号包裹方式有特定要求，错误传递会引发 JSON.parse 异常。
• 认证依赖：所有操作基于 tencentads-auth 配置的凭据，如遇认证错误需先完成鉴权流程。
• 枚举值查询：所有枚举值禁止猜测，必须通过 get-enum-options.mjs 查询确认。

该技能提供了脚本化的接口，但用户需熟悉 Node.js 环境和命令行操作，以确保正确调用。