咨询：无需客户端登录，通过Firebase与Cloud Functions获取Google Analytics ga:sessions

当然可以！你已经搭好了Firebase + Cloud Functions的架构，这刚好是绕开客户端登录、安全获取GA数据的完美方案——核心思路是把GA API的请求逻辑放到Cloud Functions中执行，客户端只需要调用你自己的云函数，完全不用处理GA的认证或登录流程。

下面是具体的实现步骤：

1. 前期准备：配置权限与API启用 #

• 先确认和Firebase绑定的Google Cloud项目已经启用了Analytics Reporting API V4，可以在Google Cloud控制台的API库中搜索并启用。
• 给Cloud Functions默认使用的服务账号添加GA权限：
  1. 打开Google Cloud控制台的IAM页面
  2. 找到名为[你的项目ID]@appspot.gserviceaccount.com的服务账号（这是Firebase云函数默认使用的账号）
  3. 给它添加Analytics Viewer权限（只读需求足够，需要修改数据的话选Analytics Editor）

2. 编写Cloud Functions代码（Node.js示例） #

先在你的Firebase Functions项目中安装依赖：

npm install googleapis

然后创建一个HTTP可调用函数来请求GA数据：

const functions = require("firebase-functions");
const { google } = require("googleapis");

// 初始化Analytics Reporting API客户端
const analyticsreporting = google.analyticsreporting("v4");

// 云函数：获取会话计数
exports.getSessionCount = functions.https.onCall(async (data, context) => {
  // 如果不需要客户端登录，可以跳过这段auth检查；如果要限制访问，可在这里加验证逻辑
  // if (!context.auth) {
  //   throw new functions.https.HttpsError('unauthenticated', '需要登录才能访问');
  // }

  try {
    // 云函数环境会自动加载项目服务账号完成认证
    const auth = new google.auth.GoogleAuth({
      scopes: ["https://www.googleapis.com/auth/analytics.readonly"],
    });
    const authClient = await auth.getClient();
    google.options({ auth: authClient });

    // 调用GA Reporting API获取会话数据
    const response = await analyticsreporting.reports.batchGet({
      requestBody: {
        reportRequests: [
          {
            viewId: "你的GA视图ID", // 替换成你自己的GA视图ID
            dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
            metrics: [{ expression: "ga:sessions" }],
          },
        ],
      },
    });

    // 解析返回的会话数
    const sessionCount = response.data.reports[0].data.totals[0].values[0];
    return { sessionCount: parseInt(sessionCount) };
  } catch (error) {
    functions.logger.error("GA API请求失败:", error);
    throw new functions.https.HttpsError("internal", "获取数据失败，请稍后重试");
  }
});

3. 客户端调用云函数获取数据 #

在你的前端代码中，直接调用这个云函数即可，不需要任何GA登录流程：

// 确保已经初始化了Firebase
import { getFunctions, httpsCallable } from "firebase/functions";

const functions = getFunctions();
const getSessionCount = httpsCallable(functions, "getSessionCount");

// 调用函数并渲染数据到页面
getSessionCount()
  .then((result) => {
    const sessionCount = result.data.sessionCount;
    console.log("最近7天会话数:", sessionCount);
    document.getElementById("session-count").textContent = sessionCount;
  })
  .catch((error) => {
    console.error("获取会话数失败:", error);
  });

关键说明 #

• 为什么不需要客户端登录？：云函数运行在Google Cloud的可信环境中，使用项目的服务账号自动完成GA API的认证，完全不需要用户在客户端登录Google账号。
• 安全注意事项：如果你的GA数据不需要公开，建议在云函数中添加访问控制（比如限制特定域名或Firebase用户）；如果是公开数据，要确保云函数的Invoker权限设置正确（可在Google Cloud控制台给云函数添加allUsers的Cloud Functions Invoker权限，允许未认证访问）。

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