如何通过Google Search Console API获取query=null维度的数据？

问题核心：GSC界面中query为空（null）的流量数据，API默认不返回，且无法通过equals+null/空字符串筛选，需要使用missing操作符匹配维度值缺失的情况。

解决方案（PHP） #

将过滤条件的操作符从equals改为missing，无需指定匹配值，代码示例如下：

$filter_group = new Google_Service_Webmasters_ApiDimensionFilterGroup;

// 筛选query维度缺失的行（即query=null的数据）
$groups = array(['query', null, 'missing']);

$filters = array();
foreach ($groups as $group) {
    $filter = new Google_Service_Webmasters_ApiDimensionFilter();
    $filter->setDimension($group[0]);
    // missing操作符不需要设置value，可忽略或设为null
    if ($group[2] !== 'missing') {
        $filter->setValue($group[1]);
    }
    $filter->setOperator($group[2]);
    $filters[] = $filter;
}

$filter_group->setFilters($filters);
// 后续将filter_group传入报告请求参数中

原理说明 #

Google Search Console API中，维度值缺失（如query=null）的情况，需用missing操作符筛选，而非equals。equals仅能匹配具体字符串值，无法识别API层面定义的“缺失值”类型。

其他语言参考（Python） #

from googleapiclient.discovery import build

# 构建过滤组
filter_group = {
    "filters": [
        {
            "dimension": "query",
            "operator": "missing"
        }
    ]
}

# 后续将filter_group加入searchanalytics.query的请求参数

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