---
title: "API Enablement"
type: concept
tags: [google-cloud, oauth, api]
---

## Definition
API Enablement 是在 Google Cloud Console 中为项目启用特定 API 服务的操作。即使 OAuth 认证成功，如果目标 API 未启用，调用时仍会返回 `403 accessNotConfigured` 错误。

## Two-Layer Authorization Model

| 层级 | 控制内容 | 错误示例 |
|------|---------|---------|
| OAuth 授权 | 用户身份认证 | 未授权/权限不足 |
| API Enablement | 是否允许调用 API | `403 accessNotConfigured` |

## 操作步骤
1. 进入 **Google Cloud Console** → **APIs & Services** → **Library**
2. 搜索目标 API（如 Gmail API、Calendar API）
3. 点击 **Enable** 启用
4. 等待生效（通常 30 秒 ~ 2 分钟，有延迟）
5. 重新执行 OAuth 授权（因旧 token 不包含新权限）

## 典型错误
> Gmail API has not been used in project XXX

表示：该 Google Cloud 项目未启用 Gmail API

## 相关概念
- [[OAuth]]：第一层认证
- [[Google-Cloud-Console]]：管理 API 启用的控制台
- [[Gmail-API]]：Google Workspace API 示例
- [[Calendar-API]]：日历 API
- [[Drive-API]]：云端硬盘 API
- [[测试用户]]：OAuth 授权配置

## 相关工具
- [[gog CLI]]：一个同时需要 OAuth + API Enablement 才能正常工作的 CLI 工具