如何通过单次Google Analytics API调用获取指定URL集合的详情？

可以通过单次API调用实现这个需求，不管是使用旧版的Universal Analytics（UA） Core Reporting API，还是新版的Google Analytics 4（GA4） Data API v1，都支持针对指定URL集合的批量数据查询。

具体实现方式 #

1. Universal Analytics（UA） Core Reporting API #

使用filters参数对ga:pagePath维度进行过滤，通过正则表达式的OR逻辑匹配多个目标URL，同时结合渠道过滤获取自然流量数据：

• 请求参数示例：

  metrics=ga:organicSessions,ga:pageviews
  dimensions=ga:pagePath
  filters=ga:channelGrouping==Organic Search;ga:pagePath=~^/product/shoes$|^/product/shirts$|^/product/pants$
  start-date=2024-01-01
  end-date=2024-01-31
  

  其中ga:pagePath=~^/url1$|^/url2$是正则匹配多个精确路径，ga:channelGrouping==Organic Search确保只获取自然搜索渠道的数据。

2. Google Analytics 4（GA4） Data API v1 #

通过请求体中的dimensionFilter使用inListFilter直接传入URL数组，同时指定自然流量相关指标：

• 请求体示例（JSON格式）：

  {
    "dimensions": [{"name": "pagePath"}],
    "metrics": [{"name": "organicSearchSessions"}, {"name": "screenPageViews"}],
    "dimensionFilter": {
      "filter": {
        "fieldName": "pagePath",
        "inListFilter": {
          "values": ["/product/shoes", "/product/shirts", "/product/pants"]
        }
      }
    },
    "dateRanges": [{"startDate": "2024-01-01", "endDate": "2024-01-31"}]
  }
  

  这里inListFilter可以直接传入最多几百个URL值，15个完全在限制范围内。

注意事项 #

• 确保传入的URL是不带域名的路径部分（比如/product/shoes而非https://example.com/product/shoes），因为UA和GA4的pagePath维度仅存储路径信息。
• 根据需求选择对应指标：UA的ga:organicSessions、ga:pageviews；GA4的organicSearchSessions、screenPageViews分别对应自然会话数和页面浏览量。
• 单次请求的过滤条件长度有上限，但15个URL的规模完全不会触发限制。

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