如何使用Google Ads脚本批量排除500条以上搜索词

Google Ads UI的批量排除功能有500条限制，要处理更多搜索词，用Google Ads脚本是高效的解决方案，以下是具体实现步骤：

准备工作 #

• 把需要排除的搜索词整理成纯文本列表，每行一个，存入Google Sheets的第一列（也可以直接写在脚本里，但Sheets更方便维护）
• 确认要排除搜索词的目标广告系列ID（可在Google Ads广告系列页面的「设置」标签下查看）

脚本实现 #

这个脚本会读取Google Sheets里的搜索词，分批批量添加为目标广告系列的否定关键词，避免API限额问题：

function excludeNegativeKeywords() {
  // 配置项，根据你的需求修改
  const SPREADSHEET_URL = '替换为你的Google Sheets链接';
  const SHEET_NAME = 'Sheet1'; // 存放搜索词的工作表名称
  const CAMPAIGN_IDS = ['123-456-7890', '098-765-4321']; // 目标广告系列ID列表
  const MATCH_TYPE = 'EXACT'; // 匹配类型：EXACT（精确）、PHRASE（短语）、BROAD（广泛）

  // 读取Sheets中的搜索词列表
  const spreadsheet = SpreadsheetApp.openByUrl(SPREADSHEET_URL);
  const sheet = spreadsheet.getSheetByName(SHEET_NAME);
  const keywords = sheet.getRange(1, 1, sheet.getLastRow(), 1)
    .getValues()
    .flat()
    .filter(keyword => keyword.trim() !== '');

  if (keywords.length === 0) {
    Logger.log('未找到有效搜索词');
    return;
  }

  Logger.log(`待排除搜索词总数：${keywords.length}`);

  // 分批处理，每批200条（适配API限额）
  const batchSize = 200;
  for (let i = 0; i < keywords.length; i += batchSize) {
    const currentBatch = keywords.slice(i, i + batchSize);
    const mutateOperations = [];

    // 为每个广告系列创建否定关键词操作
    CAMPAIGN_IDS.forEach(campaignId => {
      currentBatch.forEach(keyword => {
        mutateOperations.push({
          create: {
            campaignId: campaignId,
            text: keyword.trim(),
            matchType: MATCH_TYPE
          }
        });
      });
    });

    // 执行批量操作
    try {
      const response = AdsApp.campaignNegativeKeywords().bulkMutate(mutateOperations);
      const successCount = response.getResults().filter(res => res.isSuccessful()).length;
      Logger.log(`批次 ${Math.floor(i/batchSize)+1}：成功排除 ${successCount} 条关键词`);
    } catch (error) {
      Logger.log(`批次 ${Math.floor(i/batchSize)+1} 处理失败：${error.message}`);
    }
  }

  Logger.log('全部排除操作完成');
}

使用步骤 #

1. 创建并配置Google Sheets：新建一个Sheets，第一列填写所有要排除的搜索词，确保没有空行
2. 添加脚本到Google Ads：
   • 打开Google Ads账号，进入「工具与设置」>「批量操作」>「脚本」
   • 点击「+」新建脚本，粘贴上述代码
   • 替换配置项中的Sheets链接、工作表名称、广告系列ID和匹配类型
3. 授权脚本权限：点击「授权」，按照提示完成OAuth验证（需要允许脚本访问Google Sheets和你的Google Ads数据）
4. 运行脚本：点击「运行」按钮，脚本会自动分批处理搜索词
5. 验证结果：查看脚本日志（点击「日志」按钮），确认排除操作的成功数量；也可以在广告系列的「否定关键词」标签下检查结果

注意事项 #

• 匹配类型选择：根据业务需求选对匹配类型，避免误排除相关流量
• 测试先行：先用少量搜索词测试脚本，确认功能正常后再处理全量列表
• API限额：Google Ads脚本单次运行最长30分钟，若搜索词数量极大（如数万条），可拆分Sheets列表分多次运行，或调整batchSize（建议不超过500条/批）
• 广告系列ID准确性：确保输入的广告系列ID正确，避免将否定关键词添加到错误系列

内容的提问来源于stack exchange，提问作者mert dökümcü