Google Ads

核心用法

Google Ads via ClawLink 是一个集成式技能，让用户无需自行配置 Google Ads API 凭据即可在聊天环境中管理广告账户。核心工作流程包括：

1. 插件安装与配对：安装 clawhub:clawlink-plugin 后，通过 clawlink_begin_pairing 和 clawlink_get_pairing_status 完成设备配对，建立本地安全凭证存储。

2. Google Ads 连接：用户访问 claw-link.dev/dashboard?add=google-ads 完成 Google 账号授权，ClawLink 托管处理 OAuth 流程。

3. 工具动态发现：通过 clawlink_list_integrations、clawlink_list_tools 实时获取可用工具，避免硬编码假设；使用 clawlink_describe_tool 了解工具参数与安全配置。

4. 安全执行模式：优先使用只读操作（账户检查、GAQL 查询、受众查看）；写入操作（广告系列修改、预算调整、受众更新）必须先调用 clawlink_preview_tool 并获取用户确认。

显著优点

• 零配置接入：用户无需管理 API 密钥、开发者令牌或 OAuth 回调，降低技术门槛
• 动态工具生态：工具集随 ClawLink 平台更新自动扩展，无需手动升级插件
• 内置安全护栏：safeDefaults、askBefore 等元数据指导 AI 安全决策，强制确认机制防止误操作
• 实时能力验证：每次会话动态拉取工具目录，避免过时假设

潜在缺点与局限性

• 外部依赖：核心功能依赖 ClawLink 服务可用性，若 ClawLink 宕机则无法操作 Google Ads
• 权限约束：实际可用功能受用户 Google Ads 账户权限、OAuth 授权范围及 ClawLink 工具目录三重限制，某些高级功能可能不可用
• 网络延迟：动态工具发现和描述调用增加交互延迟
• 隐私考量：Google Ads 数据流经 ClawLink 托管服务，需信任其数据处理政策

适合人群

• 营销人员希望快速查询广告表现数据而不学习 GAQL
• 中小企业主需要临时调整预算或受众但无技术团队
• 代理机构批量检查多客户账户状态
• 任何需要降低 Google Ads API 接入门槛的用户

常规风险

• 误操作风险：尽管有确认机制，用户仍可能在未充分理解预览结果时批准变更
• 会话状态丢失：配对状态或集成连接可能因会话重启需要重新验证
• 第三方信任：需将 Google Ads 数据访问权限委托给 ClawLink 平台
• 成本暴露：GAQL 查询若设计不当可能拉取大量数据，产生意外 API 调用成本

核心用法

本技能是一个纯 Markdown 格式的使用指南，本身不捆绑可执行代码，而是指导用户安装和调用 ClawLink 插件来操作 Google Ads。用户通过自然语言对话即可完成以下操作：账户与广告系列检查、GAQL 报表查询、受众群体管理，以及经确认后的广告系列修改。整个流程采用托管式 OAuth 连接，用户无需自行申请 Google Ads API 访问权限或处理复杂的凭证配置。

具体使用步骤为：安装 ClawLink 官方插件（openclaw plugins install clawhub:clawlink-plugin）→ 完成设备配对（clawlink_begin_pairing）→ 在 ClawLink 仪表板连接 Google Ads 账户 → 通过 clawlink_list_tools 动态发现可用工具 → 执行查询或变更操作。所有写入操作（预算调整、受众更新等）均需经用户显式确认。

显著优点

零配置接入：彻底消除了传统 Google Ads API 集成的复杂性，开发者无需管理 Developer Token、OAuth 凭证刷新、API 版本适配等繁琐事项。ClawLink 作为托管中间层处理了全部认证流程。

动态工具发现：不同于静态绑定的工具集，ClawLink 根据用户实际连接的账户权限和当前 API 状态动态返回可用工具，确保功能描述与实际能力始终一致。

安全设计优先：技能本身为纯文档，无代码执行风险；所有敏感操作强制要求 clawlink_preview_tool + 用户确认的双重验证；凭证由 ClawLink 安全托管，永不在聊天上下文中暴露。

GAQL 原生支持：支持直接使用 Google Ads Query Language 进行灵活的数据分析，满足从简单报表到复杂性能诊断的多样化需求。

潜在缺点与局限性

外部依赖单一：核心功能完全依赖 ClawLink 服务的可用性。若 ClawLink 服务中断或维护，技能将无法执行任何 Google Ads 操作。

功能边界模糊：由于工具动态发现机制，用户无法预先获知完整的功能清单，某些边缘场景可能需要多次尝试 clawlink_search_tools 才能定位合适工具。

变更延迟性：OAuth 连接状态和工具列表的刷新可能存在延迟，用户刚完成的账户权限调整可能不会立即反映在工具调用中。

网络准入要求：部分企业网络环境可能对 claw-link.dev 域名的访问受限，需要额外的网络配置协调。

适合的目标群体

• 数字营销专员：需要快速获取广告账户状态、生成性能报表，但无技术背景配置 API
• 中小型企业主：希望以对话方式管理广告预算和受众，降低工具学习成本
• 营销团队技术协调员：负责为多账户团队搭建标准化、安全的 Google Ads 接入方案
• 数据分析师：需要通过 GAQL 进行定制化数据提取，但希望避免编写独立的 API 客户端

使用风险

供应链风险：ClawLink 插件需通过 clawhub 渠道安装，用户应验证插件签名，防范供应链污染攻击。

权限范围风险：Google Ads OAuth 授权时，用户需仔细审查 ClawLink 请求的权限范围，避免过度授权导致的数据暴露。

操作确认风险：尽管技能强制要求变更前确认，但用户仍需理解 clawlink_preview_tool 返回的变更详情，防止误操作影响线上广告投放。

API 配额风险：Google Ads API 存在严格的速率限制和月度操作配额，高频查询或大规模账户操作可能触发限流。

会话上下文风险：长时间对话中，若用户切换了活跃的 Google Ads 账户而未重新验证连接状态，可能导致操作指向错误的账户实体。