Google Cloud Natural Language API 403报错时如何集成API Key到Python示例

报错根因说明 #

你运行官方示例代码时触发的403错误，本质是Google Cloud官方Python客户端默认的自动认证逻辑，会优先读取gcloud SDK生成的端用户凭证，这类凭证本身不被Natural Language API的调用端点支持；而API Key属于独立的认证维度，无法被默认的自动认证流程识别，需要在客户端初始化时手动指定。

合规配置步骤（无硬编码） #

合规要求：API Key必须通过运行时环境变量读取，禁止直接硬编码在代码中

1. 配置环境变量存储API Key #

• Windows PowerShell 执行：setx GOOGLE_API_KEY "你的实际API Key值"，配置完成后重启终端生效
• macOS/Linux 终端执行：将export GOOGLE_API_KEY="你的实际API Key值"写入_/.bashrc或/.zshrc配置文件，执行source ~/.bashrc 或对应配置文件命令生效

2. 修改官方示例的客户端初始化代码 #

官方原示例的客户端初始化逻辑为自动认证，需要调整为手动传入API Key参数，完整可运行的代码参考如下，其余业务逻辑和官方示例保持一致：

import os
from google.cloud import language_v1

# 从环境变量读取API Key，避免硬编码泄露
api_key = os.getenv("GOOGLE_API_KEY")
if not api_key:
    raise EnvironmentError("未检测到环境变量GOOGLE_API_KEY的配置")

# 初始化客户端，手动指定API Key认证
client = language_v1.LanguageServiceClient(
    client_options={
        "api_endpoint": "language.googleapis.com",
        "api_key": api_key
    }
)

# 以下为官方原有实体分析逻辑，无需修改
document = language_v1.Document(
    content="需要进行实体分析的目标文本",
    type_=language_v1.Document.Type.PLAIN_TEXT
)

response = client.analyze_entities(
    request={
        "document": document,
        "encoding_type": language_v1.EncodingType.UTF8
    }
)

这个实现和你测试通过的curl命令逻辑完全对齐，请求会自动拼接API Key参数完成认证，不会加载原有的gcloud端用户凭证，不会触发原403权限报错。

注意事项 #

• 该API Key认证方式仅适用于无用户身份的公开场景调用、快速调试场景；如果是生产级带权限管控的调用，仍推荐使用服务账号认证体系
• 禁止将存储API Key的环境变量配置、代码文件提交到公开代码仓库，避免密钥泄露
• 如果出现客户端参数不识别的报错，执行pip install --upgrade google-cloud-language将依赖升级到最新版本即可

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