Firebase

通过托管的 OAuth 认证访问 Firebase Management API。支持对 Firebase 项目及应用（Web、Android、iOS）执行完整的 CRUD 操作。

快速开始

# 列出 Firebase 项目
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/firebase/v1beta1/projects')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://api.maton.ai/firebase/{native-api-path}

Maton 将请求代理至 firebase.googleapis.com，并自动注入您的 OAuth Token。

认证

所有请求均需在 Authorization 请求头中提供 Maton API 密钥：

Authorization: Bearer $MATON_API_KEY

环境变量：将您的 API 密钥设为 MATON_API_KEY：

export MATON_API_KEY="YOUR_API_KEY"

获取您的 API 密钥

1. 在 maton.ai 登录或注册账户
2. 访问 maton.ai/settings
3. 复制您的 API 密钥

连接管理

在 https://api.maton.ai 管理您的 Firebase OAuth 连接。

列出连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=firebase&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'firebase'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：

{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "firebase",
    "metadata": {}
  }
}

在浏览器中打开返回的 url 以完成 OAuth 授权。

删除连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

若您拥有多个 Firebase 连接，请使用 Maton-Connection 请求头指定要使用的连接：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/firebase/v1beta1/projects')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '{connection_id}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

若您拥有多个连接，务必始终包含该请求头，以确保请求路由至目标账户。

安全与权限

• 访问范围限定于已连接 Firebase 账户内的项目、Web 应用、站点、Hosting 渠道和发布版本。
• 所有写操作均需用户显式授权。 在执行任何创建、更新或删除调用前，必须向用户确认目标资源及其预期影响。

API 参考

项目操作

列出项目

列出经身份验证用户可访问的所有 Firebase 项目。

GET /firebase/v1beta1/projects

响应：

{
  "results": [
    {
      "projectId": "my-firebase-project",
      "projectNumber": "123456789",
      "displayName": "My Firebase Project",
      "name": "projects/my-firebase-project",
      "resources": {
        "hostingSite": "my-firebase-project"
      },
      "state": "ACTIVE",
      "etag": "1_bc06d94f-cf77-4689-be01-576702b23f6a"
    }
  ]
}

获取项目

GET /firebase/v1beta1/projects/{projectId}

更新项目

PATCH /firebase/v1beta1/projects/{projectId}?updateMask=displayName
Content-Type: application/json

{
  "displayName": "Updated Project Name"
}

列出可用项目

列出可添加 Firebase 的 Google Cloud 项目。

GET /firebase/v1beta1/availableProjects

向项目添加 Firebase

为现有 Google Cloud 项目启用 Firebase 服务。

POST /firebase/v1beta1/projects/{projectId}:addFirebase
Content-Type: application/json

{}

该操作返回一个长期运行的操作（long-running operation）。可通过以下方式检查操作状态：

GET /firebase/v1beta1/operations/{operationId}

获取 Admin SDK 配置

GET /firebase/v1beta1/projects/{projectId}/adminSdkConfig

Web 应用操作

列出 Web 应用

GET /firebase/v1beta1/projects/{projectId}/webApps

获取 Web 应用

GET /firebase/v1beta1/projects/{projectId}/webApps/{appId}

创建 Web 应用

POST /firebase/v1beta1/projects/{projectId}/webApps
Content-Type: application/json

{
  "displayName": "My Web App"
}

更新 Web 应用

PATCH /firebase/v1beta1/projects/{projectId}/webApps/{appId}?updateMask=displayName
Content-Type: application/json

{
  "displayName": "Updated Web App Name"
}

获取 Web 应用配置

GET /firebase/v1beta1/projects/{projectId}/webApps/{appId}/config

响应：

{
  "projectId": "my-firebase-project",
  "appId": "1:123456789:web:abc123",
  "apiKey": "AIzaSy...",
  "authDomain": "my-firebase-project.firebaseapp.com",
  "storageBucket": "my-firebase-project.firebasestorage.app",
  "messagingSenderId": "123456789",
  "measurementId": "G-XXXXXXXXXX",
  "projectNumber": "123456789"
}

删除 Web 应用

POST /firebase/v1beta1/projects/{projectId}/webApps/{appId}:remove
Content-Type: application/json

{
  "immediate": true
}

恢复 Web 应用

POST /firebase/v1beta1/projects/{projectId}/webApps/{appId}:undelete
Content-Type: application/json

{}

Android 应用操作

列出 Android 应用

GET /firebase/v1beta1/projects/{projectId}/androidApps

获取 Android 应用

GET /firebase/v1beta1/projects/{projectId}/androidApps/{appId}

创建 Android 应用

POST /firebase/v1beta1/projects/{projectId}/androidApps
Content-Type: application/json

{
  "displayName": "My Android App",
  "packageName": "com.example.myapp"
}

更新 Android 应用

PATCH /firebase/v1beta1/projects/{projectId}/androidApps/{appId}?updateMask=displayName
Content-Type: application/json

{
  "displayName": "Updated Android App Name"
}

获取 Android 应用配置

返回 google-services.json 配置文件。

GET /firebase/v1beta1/projects/{projectId}/androidApps/{appId}/config

删除 Android 应用

POST /firebase/v1beta1/projects/{projectId}/androidApps/{appId}:remove
Content-Type: application/json

{
  "immediate": true
}

列出 SHA 证书

GET /firebase/v1beta1/projects/{projectId}/androidApps/{appId}/sha

添加 SHA 证书

POST /firebase/v1beta1/projects/{projectId}/androidApps/{appId}/sha
Content-Type: application/json

{
  "shaHash": "1234567890ABCDEF1234567890ABCDEF12345678",
  "certType": "SHA_1"
}

删除 SHA 证书

DELETE /firebase/v1beta1/projects/{projectId}/androidApps/{appId}/sha/{shaId}

iOS 应用操作

列出 iOS 应用

GET /firebase/v1beta1/projects/{projectId}/iosApps

获取 iOS 应用

GET /firebase/v1beta1/projects/{projectId}/iosApps/{appId}

创建 iOS 应用

POST /firebase/v1beta1/projects/{projectId}/iosApps
Content-Type: application/json

{
  "displayName": "My iOS App",
  "bundleId": "com.example.myapp"
}

更新 iOS 应用

PATCH /firebase/v1beta1/projects/{projectId}/iosApps/{appId}?updateMask=displayName
Content-Type: application/json

{
  "displayName": "Updated iOS App Name"
}

获取 iOS 应用配置

返回 GoogleService-Info.plist 配置文件。

GET /firebase/v1beta1/projects/{projectId}/iosApps/{appId}/config

删除 iOS 应用

POST /firebase/v1beta1/projects/{projectId}/iosApps/{appId}:remove
Content-Type: application/json

{
  "immediate": true
}

Google Analytics 操作

获取 Analytics 详情

GET /firebase/v1beta1/projects/{projectId}/analyticsDetails

添加 Google Analytics

POST /firebase/v1beta1/projects/{projectId}:addGoogleAnalytics
Content-Type: application/json

{
  "analyticsAccountId": "123456789"
}

移除 Google Analytics

POST /firebase/v1beta1/projects/{projectId}:removeAnalytics
Content-Type: application/json

{
  "analyticsPropertyId": "properties/123456789"
}

可用区域

列出可用区域

GET /firebase/v1beta1/projects/{projectId}/availableLocations

分页

使用 pageSize 和 pageToken 实现分页：

GET /firebase/v1beta1/projects?pageSize=10&pageToken={nextPageToken}

当存在更多结果时，响应中将包含 nextPageToken：

{
  "results": [...],
  "nextPageToken": "..."
}

代码示例

JavaScript

const response = await fetch(
  'https://api.maton.ai/firebase/v1beta1/projects',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const data = await response.json();

Python

import os
import requests

response = requests.get(
    'https://api.maton.ai/firebase/v1beta1/projects',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
)
data = response.json()

创建 Web 应用

import os
import requests

response = requests.post(
    'https://api.maton.ai/firebase/v1beta1/projects/my-project/webApps',
    headers={
        'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}',
        'Content-Type': 'application/json'
    },
    json={'displayName': 'My New Web App'}
)
data = response.json()

注意事项

• 项目 ID 是 Firebase 项目的全局唯一标识符
• 应用 ID 格式为 1:PROJECT_NUMBER:PLATFORM:HASH
• PATCH 请求需携带 updateMask 查询参数，用于指定待更新字段（例如：?updateMask=displayName）
• 创建操作为异步执行，返回一个 Operation 对象
• 可通过 /firebase/v1beta1/operations/{operationId} 查询操作状态
• 已删除的应用可在 30 天内通过 undelete 接口恢复
• 重要：使用 curl 命令时，若 URL 中包含方括号，请使用 curl -g 禁用 glob 解析
• 重要：将 curl 输出管道传递给 jq 或其他命令时，在部分 Shell 环境中环境变量（如 $MATON_API_KEY）可能无法正确展开

错误处理

相关资源

• Firebase Management API 概览
• Firebase Management REST API 参考文档
• Projects 资源
• Web Apps 资源
• Android Apps 资源
• iOS Apps 资源
• Maton 社区
• Maton 支持