调用G Suite Reports API获取Meet活动报告返回null，求排查

你现在遇到的核心问题是错误地把服务账号的JSON私钥直接当作access token使用——这完全不符合Google API的认证逻辑，服务器根本不会认可这个"token"，自然返回空结果。下面我会帮你梳理遗漏的关键步骤，以及给出正确的实现方式：

首先，你必须理解的核心逻辑 #

服务账号的JSON私钥不是直接可用的访问凭证，你需要用这个私钥向Google认证服务器申请有效的OAuth 2.0 Access Token，只有拿到这个token后，才能用来调用API接口。

遗漏的关键步骤&正确实现方式 #

1. 使用Google官方Java客户端库（推荐，避免手动踩坑）

手动处理HTTP请求和签名非常容易出错，Google已经提供了封装好的客户端库，帮你搞定认证和API调用的所有细节。

首先添加Maven依赖到你的项目：

<dependencies>
    <!-- Google Admin Reports API 客户端 -->
    <dependency>
        <groupId>com.google.apis</groupId>
        <artifactId>google-api-services-admin-reports</artifactId>
        <version>v1-rev20240229-2.0.0</version>
    </dependency>
    <!-- OAuth2 认证库 -->
    <dependency>
        <groupId>com.google.auth</groupId>
        <artifactId>google-auth-library-oauth2-http</artifactId>
        <version>1.20.0</version>
    </dependency>
</dependencies>

然后是正确的代码实现：

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.admin.reports.Reports;
import com.google.api.services.admin.reports.ReportsScopes;
import com.google.api.services.admin.reports.model.Activities;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.ServiceAccountCredentials;

import java.io.FileInputStream;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Collections;

public class MeetActivityReporter {
    private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
    // 替换成你的Google Workspace域管理员邮箱（必须是域内管理员账号）
    private static final String ADMIN_EMAIL = "your-admin@your-domain.com";

    public static void main(String[] args) {
        try {
            // 加载服务账号凭证
            ServiceAccountCredentials credentials = ServiceAccountCredentials.fromStream(
                    new FileInputStream("C:/Users/Administrateur/Desktop/GoogleApis/Interoperability-googleApis/target/classes/my-first-project-274515-361633451f1c.json"))
                    // 指定API所需的权限范围
                    .createScoped(Collections.singleton(ReportsScopes.ADMIN_REPORTS_AUDIT_READONLY))
                    // 关键：委派域管理员权限，因为Reports API需要域级访问权限
                    .createDelegated(ADMIN_EMAIL);

            // 构建Reports API客户端
            Reports service = new Reports.Builder(GoogleNetHttpTransport.newTrustedTransport(), JSON_FACTORY,
                    new HttpCredentialsAdapter(credentials))
                    .setApplicationName("Meet Activity Reporter")
                    .build();

            // 调用API获取Meet结束的活动记录
            Activities activities = service.activities().list("all", "meet")
                    .setEventName("call_ended")
                    .setMaxResults(10L)
                    .execute();

            // 打印结果
            System.out.println("--------------- Result: " + activities.toPrettyString());
        } catch (IOException | GeneralSecurityException e) {
            e.printStackTrace();
        }
    }
}

2. 必须完成服务账号的域权限委派

这是最容易被忽略的关键步骤：

1. 登录Google Workspace管理控制台（admin.google.com）
2. 进入「安全」>「API控制」>「域范围委派」
3. 添加你的服务账号的客户端ID（可以从JSON私钥文件的client_id字段找到）
4. 授予权限范围：https://www.googleapis.com/auth/admin.reports.audit.readonly

没有这一步，服务账号无法代表域管理员访问Reports API，会直接返回权限错误。

3. 你的原始代码的其他问题

• 直接把JSON私钥拼到URL里，导致请求的access_token参数完全无效，服务器无法识别
• 没有处理HTTP错误场景（比如401未授权、403权限不足），所以即使接口返回错误，你也只会得到null

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