使用Google Analytics BetaAnalyticsDataClient遇必填dateRange错误求助

你遇到的问题是明明已传入日期范围参数，API却仍提示需要dateRange，这通常是PHP客户端的参数序列化或版本兼容问题导致的，以下是可行的解决办法：

方案1：直接传递数组形式的参数（绕过对象实例化） #

放弃使用DateRange和Metric对象，直接以数组形式传递参数，避免对象序列化可能出现的解析错误：

try {
    $response = $client->runReport([
        'property' => 'properties/********',
        'date_ranges' => [
            [
                'start_date' => '2024-04-01',
                'end_date' => '2024-04-12',
            ]
        ],
        'metrics' => [
            ['name' => 'sessions'],
            ['name' => 'screenPageViews']
        ],
    ]);

    foreach ($response->getRows() as $row) {
        foreach ($row->getMetricValues() as $metricValue) {
            print 'Metric Value: ' . $metricValue->getValue() . PHP_EOL;
        }
    }
} catch (Exception $e) {
    echo $e->getMessage();
}

注意：原代码中遍历的是dimensionValues，但请求未传入维度参数，不会返回维度数据，建议改为遍历metricValues获取指标结果。

方案2：修正DateRange对象的初始化方式 #

如果坚持使用对象实例化，尝试用setter方法替代构造函数传参，确保参数被正确赋值：

$dateRange = new DateRange();
$dateRange->setStartDate('2024-04-01');
$dateRange->setEndDate('2024-04-12');

$metricSessions = new Metric();
$metricSessions->setName('sessions');

$metricPageViews = new Metric();
$metricPageViews->setName('screenPageViews');

try {
    $response = $client->runReport([
        'property' => 'properties/********',
        'date_ranges' => [$dateRange],
        'metrics' => [$metricSessions, $metricPageViews],
    ]);
    // 结果处理逻辑
    foreach ($response->getRows() as $row) {
        foreach ($row->getMetricValues() as $metricValue) {
            print 'Metric Value: ' . $metricValue->getValue() . PHP_EOL;
        }
    }
} catch (Exception $e) {
    echo $e->getMessage();
}

方案3：更新客户端依赖版本 #

旧版本的google/analytics-data包可能存在参数映射bug，执行以下命令更新到最新稳定版：

composer update google/analytics-data

更新完成后重试原代码，大部分序列化问题会在新版本中修复。

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