PHP集成Google Analytics Data API V1(Beta)授权失败求助

针对你在WordPress插件开发中遇到的服务账号授权报错问题，以下是具体排查和解决步骤：

1. 确认服务账号权限配置 #

• 确保服务账号邮箱已添加到目标GA4属性的用户列表，角色至少设置为查看者（或更高权限如分析师）
• 注意：GA4权限生效存在15-30分钟延迟，添加权限后不要立即测试
• 核对服务账号邮箱是否完全正确，避免复制时遗漏后缀（如.iam.gserviceaccount.com）

2. 验证JSON密钥文件 #

• 确认密钥文件是从Google Cloud控制台服务账号详情页下载的，不要混淆成OAuth客户端ID的密钥文件
• 检查密钥文件内容：必须包含type: service_account、client_email、private_key等核心字段，脱敏操作不要破坏这些字段的完整性
• 第一种授权方式中，用file_exists($json_path)验证密钥文件路径是否正确，避免因路径错误导致加载失败

3. 适配WordPress环境限制 #

• 若使用第一种putenv方式授权，检查服务器PHP配置是否禁用了putenv函数，禁用则改用第二种直接传入凭据的方式
• 确保服务器PHP版本≥7.4（建议8.0+），符合Google客户端库的版本要求
• 排查服务器防火墙/代理设置，确认能正常访问Google API的端点（如analyticsdata.googleapis.com）

4. 清除令牌缓存 #

Google客户端库会自动缓存访问令牌，旧的过期令牌可能导致报错，可通过以下方式处理：

• 手动删除客户端库的缓存文件（通常在vendor/google/auth/src/Cache相关目录，或WordPress临时目录）
• 初始化客户端时禁用缓存测试：

$credentials = json_decode(file_get_contents(__DIR__ . '/client_secrets.json'), true);
$client = new BetaAnalyticsDataClient([
    'credentials' => $credentials,
    'cache' => new \Google\Auth\Cache\NullCache()
]);

5. 极简脚本测试 #

脱离WordPress环境，编写极简脚本验证API调用是否正常，排除WordPress框架的干扰：

<?php
require __DIR__ . '/vendor/autoload.php';

// 替换为你的密钥文件路径和GA4属性ID
$credentials = json_decode(file_get_contents(__DIR__ . '/client_secrets.json'), true);
$ga4PropertyId = 'properties/123456789';

$client = new Google\Analytics\Data\V1beta\BetaAnalyticsDataClient([
    'credentials' => $credentials,
    'cache' => new \Google\Auth\Cache\NullCache()
]);

$request = new Google\Analytics\Data\V1beta\RunReportRequest();
$request->setProperty($ga4PropertyId);
$request->addDimensions(new Google\Analytics\Data\V1beta\Dimension(['name' => 'date']));
$request->addMetrics(new Google\Analytics\Data\V1beta\Metric(['name' => 'activeUsers']));
$request->setDateRanges([new Google\Analytics\Data\V1beta\DateRange(['start_date' => '7daysAgo', 'end_date' => 'today'])]);

try {
    $response = $client->runReport($request);
    print_r($response);
} catch (Exception $e) {
    echo $e->getMessage();
}

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