.NET中Google Analytics Data API(GA4)调用空引用报错求助

错误原因 #

你遇到的NullReferenceException是因为RunReportRequest的Dimensions、Metrics、DateRanges这些集合属性，在默认构造后为null，直接使用集合初始化语法（{ ... }）会尝试对null集合执行Add操作，从而触发空引用错误。同时原代码中调用RunReport时重复传递了属性ID（request内已包含完整的Property路径），也会导致API调用异常。

修正后的代码 #

using Google.Apis.AnalyticsData.v1beta;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using System.Collections.Generic;

// Google Analytics 4 property ID.
string propertyId = "407521144";

// Credential Path
string credentialsPath = HostingEnvironment.MapPath("~") + @"Scripts\mktwebsuitedigital-afe56dbd25f6.json";

// Authenticate and create the service.
GoogleCredential credential = GoogleCredential.FromFile(credentialsPath);
AnalyticsDataService service = new AnalyticsDataService(new BaseClientService.Initializer()
{
    HttpClientInitializer = credential,
    ApplicationName = "Google Analytics 4",
});

RunReportRequest request = new RunReportRequest
{
    Property = $"properties/{propertyId}",
    // 显式初始化集合对象，避免null引用
    Dimensions = new List<Dimension> { new Dimension { Name = "city" } },
    Metrics = new List<Metric> { new Metric { Name = "activeUsers" } },
    DateRanges = new List<DateRange> { new DateRange { StartDate = "2023-03-31", EndDate = "today" } },
};

// 修正RunReport调用方式，无需重复传递propertyId
RunReportResponse response = service.Properties.RunReport(request).Execute();

Console.WriteLine("Report result:");
foreach (Row row in response.Rows)
{
    Console.WriteLine("{0}, {1}", row.DimensionValues[0].Value, row.MetricValues[0].Value);
}

关键修正点 #

• 集合初始化：对Dimensions、Metrics、DateRanges显式创建List<T>实例，确保集合不为null后再添加元素。
• API调用参数：移除RunReport方法中多余的propertyId参数，因为request对象已经包含了完整的Property路径。

额外检查项 #

1. 确认凭证JSON文件的权限：确保该服务账号已被添加到GA4属性的用户列表中，且拥有查看分析数据的权限。
2. 验证NuGet包版本：确保安装的Google.Apis.AnalyticsData.v1beta包是最新稳定版，避免版本兼容问题。

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