如何通过Google Sheets API条件格式设置整行颜色

当前调用的条件格式规则默认对范围内每个单元格自身的值做等值匹配，因此只有内容等于ERROR的单元格会应用样式，无法实现整行变色。

要实现单字段匹配触发整行变色，需要做两个核心修改：

• 将条件类型从TEXT_EQ改为自定义公式类型CUSTOM_FORMULA
• 公式中用$符号绝对引用判断字段所在的列，行号保持相对引用，确保每行都校验自身行对应字段的值

举个例子：如果你要判断的ERROR值存放在A列（列索引为0），从表格第1行（行索引0）开始生效，正确的接口请求体如下：

{
  "requests": [
    {
      "addConditionalFormatRule": {
        "rule": {
          "ranges": [
            {
              "sheetId": 0
              // 如需限定范围可补充以下参数，比如从第2行开始跳过表头
              // "startRowIndex": 1,
              // "endColumnIndex": 10 // 限定生效到第10列，按需调整
            }
          ],
          "booleanRule": {
            "condition": {
              "type": "CUSTOM_FORMULA",
              "values": [
                {
                  // 核心：$A锁定A列，行号1和范围起始行对应，会随应用行自动偏移
                  "userEnteredValue": "=$A1=\"ERROR\""
                }
              ]
            },
            "format": {
              "backgroundColor": {
                "green": 0.2,
                "red": 0.8
              }
            }
          }
        },
        "index": 0
      }
    }
  ]
}

• 公式中列标识前的$是绝对引用标记，作用是固定判断列，避免规则应用到同行其他列时，判断逻辑偏移到其他列
• 公式中的行号不要加$，保持相对引用，规则应用到不同行时会自动匹配当前行的目标列值；行号数值需要和你设置的范围起始行对应：如果范围从第1行（表格显示行号，对应API行索引0）开始就写1，如果从第2行（跳过表头，对应API行索引1）开始就写2
• 如果判断值不在A列，比如存放在C列，把公式里的$A替换为$C即可
• 不需要限定生效范围的话，ranges里只保留sheetId即可，规则会覆盖整张工作表；如果需要限定生效的行、列范围，可以补充startRowIndex/endRowIndex/startColumnIndex/endColumnIndex参数

内容的提问来源于stack exchange，提问作者MMZSTACK