调用Google Search Console API查询特定URL仅返回根域名结果排查

以下是针对性的排查和修复方案：

• 精确匹配页面URL格式
  Google Search Console存储的页面URL可能存在尾部斜杠差异（比如/pizza/2和/pizza/2/），或者大小写不一致。先去Search Console后台确认目标页面的精确URL，再修改代码中的URL值，确保完全匹配。

• 替换Filter操作符为"contains"
  "equals"操作符要求绝对精确匹配，若API返回的page字段带有额外参数或格式细微差异，就会匹配失败。改用"contains"并使用相对路径，能更稳定地定位目标页面：

filters: [
  {
    dimension: "page",
    operator: "contains",
    expression: "/pizza/2",
  },
],

• 验证siteUrl与后台站点一致
  确保siteUrl和你在Google Search Console中验证的站点地址完全一致，比如后台验证的是https://my-domain.co.uk，就不能写成带www的版本。

• 检查日期范围的数据有效性
  确认2023-01-01当天该页面确实有搜索流量数据，若当天无数据，API可能返回根域名或空结果。可以扩大日期范围测试，比如改成2023-01-01到2023-01-07。

修改后的完整代码示例：

const targetPath = "/pizza/2";

searchconsole.searchanalytics.query(
  {
    siteUrl: "https://www.my-domain.co.uk",
    requestBody: {
      startDate: "2023-01-01",
      endDate: "2023-01-07",
      dimensions: ["page"],
      filters: [
        {
          dimension: "page",
          operator: "contains",
          expression: targetPath,
        },
      ],
      startRow: 0,
      rowLimit: 10,
    },
  },
  (err, response) => {
    console.log(response);
    if (err) return res.status(500).send(`Error: ${err}`);
    res.send(response.data);
  }
);

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