如何通过GA API获取指定精确时间范围的网站GA曝光量数据？

Google Analytics（UA/GA4）的API默认日期参数仅支持Y-m-d格式，但可以结合时间维度+过滤器实现精确到时分秒的范围筛选，分两种情况说明：

一、Universal Analytics（UA）API实现方式 #

1. 基础日期参数仍按天设置：start-date=2023-04-06，end-date=2023-04-06
2. 添加高精度时间维度：
   • 可选ga:dateHourMinute（格式YYYYMMDDHHmm，到分钟）+ga:second（秒数，0-59），或直接用ga:timestamp（Unix时间戳，到秒）
3. 构造过滤器限定时间范围：
   以目标时间2023-04-06 03:12:26至2023-04-06 05:12:26为例，过滤器表达式如下：

   ga:timestamp>=1680745946;ga:timestamp<=1680753146
   

   （注：1680745946是起始时间的Unix时间戳，1680753146是结束时间的Unix时间戳）
4. 完整请求核心参数示例：

   GET https://www.googleapis.com/analytics/v3/data/ga
   ?ids=ga:你的视图ID
   &start-date=2023-04-06
   &end-date=2023-04-06
   &metrics=ga:impressions
   &dimensions=ga:timestamp,ga:hostname
   &filters=ga:timestamp>=1680745946;ga:timestamp<=1680753146;ga:hostname==目标域名
   

二、GA4 Data API v1实现方式 #

GA4支持通过eventTimestamp（毫秒级时间戳）实现更精准的筛选：

1. 日期范围仍按天设置：startDate: "2023-04-06"，endDate: "2023-04-06"
2. 将目标时间转换为毫秒级时间戳：
   • 起始时间2023-04-06 03:12:26 → 1680745946000
   • 结束时间2023-04-06 05:12:26 → 1680753146000
3. 构造POST请求，通过dimensionFilter过滤时间范围：

   {
     "dateRanges": [{"startDate": "2023-04-06", "endDate": "2023-04-06"}],
     "metrics": [{"name": "impressions"}],
     "dimensions": [{"name": "eventTimestamp"}, {"name": "hostName"}],
     "dimensionFilter": {
       "andGroup": {
         "expressions": [
           {
             "filter": {
               "fieldName": "eventTimestamp",
               "numericFilter": {
                 "operation": "BETWEEN",
                 "valueRange": {
                   "minValue": "1680745946000",
                   "maxValue": "1680753146000"
                 }
               }
             }
           },
           {
             "filter": {
               "fieldName": "hostName",
               "stringFilter": {
                 "matchType": "EXACT",
                 "value": "目标域名"
               }
             }
           }
         ]
       }
     }
   }
   

注意事项 #

• 需确保API请求已授权对应UA视图或GA4属性的访问权限
• 若需过滤特定域名，UA用ga:hostname维度，GA4用hostName维度
• 指标impressions对应广告曝光，若为页面曝光，UA可改用ga:pageviews，GA4改用pageViews

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