PHP调用GA4 Data API V1beta runReport参数类型报错求助

问题分析 #

你遇到的两个报错核心原因如下：

1. 传入RunReportRequest对象时提示需数组：低版本google/analytics-data库仅支持数组形式请求参数，而官方示例可能基于支持对象传参的新版本编写。
2. 数组传参时提示期望DateRange：dateRanges是重复字段（支持多日期范围查询），需传入数组嵌套数组的结构，而非单个日期范围数组。

解决方案 #

方案1：升级库版本（推荐） #

执行Composer命令升级到支持对象传参的新版本：

composer update google/analytics-data

升级后即可直接使用你最初编写的RunReportRequest对象传参代码，无需额外修改。

方案2：修正数组传参格式（适用于无法升级的场景） #

调整请求参数结构，确保重复字段使用数组嵌套数组的形式：

use Google\Analytics\Data\V1beta\BetaAnalyticsDataClient;

$client = new BetaAnalyticsDataClient([
    'credentials' => json_decode(file_get_contents($KEY_FILE_LOCATION ), true)
]);

// 正确构造数组形式的请求
$request = [
    'property' => 'properties/' . $property_id,
    'dateRanges' => [
        [
            'start_date' => '2020-03-31',
            'end_date' => 'today'
        ]
    ],
    'dimensions' => [
        ['name' => 'city']
    ],
    'metrics' => [
        ['name' => 'activeUsers']
    ]
];

$response = $client->runReport($request);

// 输出报告结果
print 'Report result: ' . PHP_EOL;
foreach ($response->getRows() as $row) {
    print $row->getDimensionValues()[0]->getValue()
        . ' ' . $row->getMetricValues()[0]->getValue() . PHP_EOL;
}

关键说明 #

• 所有重复字段（dateRanges/dimensions/metrics）必须以数组嵌套数组的形式传入，每个子数组对应一个实体的结构。
• 若升级库版本后使用对象传参，确保BetaAnalyticsDataClient的命名空间正确引入，不要错误注释。

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