如何不借助BigQuery通过API及Python SDK获取Firebase Analytics原始事件

首先明确：Firebase Analytics官方没有提供直接提取原始事件的Python SDK，除了BigQuery集成外，以下是几种可用的替代方式：

• 调用Firebase Analytics REST API（结合Python实现）
  这个API只能获取聚合后的统计数据（比如事件总触发次数、用户维度的聚合指标），拿不到单条原始事件记录。你可以用Python的requests库发送HTTP请求，前提是先获取OAuth2认证令牌。示例代码如下：

  import requests
  
  # 替换为你的项目ID和有效认证令牌
  PROJECT_ID = "your-firebase-project-id"
  ACCESS_TOKEN = "your-oauth2-access-token"
  
  url = f"https://analyticsdata.googleapis.com/v1beta/{PROJECT_ID}:runReport"
  payload = {
      "dimensions": [{"name": "eventName"}],
      "metrics": [{"name": "eventCount"}],
      "dateRanges": [{"startDate": "2024-01-01", "endDate": "2024-01-31"}]
  }
  headers = {"Authorization": f"Bearer {ACCESS_TOKEN}"}
  
  response = requests.post(url, json=payload, headers=headers)
  print(response.json())
  

  注意：此方式仅能获取聚合数据，无法拿到单条原始事件。

• 导出到Cloud Storage后用Python处理
  你可以在Firebase控制台设置定期将Analytics原始数据导出到Google Cloud Storage（GCS），导出文件为JSON格式的原始事件记录。之后用Python的google-cloud-storage库下载并解析这些文件：

  1. 在Firebase控制台的Analytics页面开启「导出到Cloud Storage」功能，设置导出频率（每日/每周）
  2. 安装依赖：pip install google-cloud-storage
  3. 示例代码：

     from google.cloud import storage
     import json
     
     # 初始化GCS客户端
     client = storage.Client()
     bucket = client.get_bucket("your-gcs-bucket-name")
     
     # 遍历导出的JSON文件（路径需根据实际导出设置调整）
     blobs = bucket.list_blobs(prefix="firebase-analytics/exports/")
     for blob in blobs:
         if blob.name.endswith(".json"):
             content = blob.download_as_text()
             events = json.loads(content)
             # 逐条处理原始事件
             for event in events:
                 print(event)
     

  此方式能获取原始事件，但属于批量定期导出，无法实时获取。

• 通过Cloud Functions实现实时捕获
  若需要实时获取原始事件，可以借助Cloud Functions（以Node.js为主，但可联动Python服务）：

  1. 编写Node.js的Cloud Function，通过firebase-functions/analytics模块监听Analytics事件触发
  2. 在Function中将事件数据发送到Python服务（如HTTP请求），或存储到数据库后用Python读取
     这种方式适合实时场景，但需要额外部署Cloud Functions和Python服务，复杂度较高。

总结：如果需要原始事件数据且不想用BigQuery，最直接的方案是导出到Cloud Storage再用Python处理；若仅需聚合数据，可调用Analytics REST API结合Python实现。

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