GCP Endpoint使用服务账号配置Try this API功能遇问题求助

我之前也碰到过类似的坑，官方文档的示例确实有点误导性，结合实际配置经验，给你拆解两个核心问题的解决方案：

一、修复"authorizationUrl缺失"导致的功能禁用问题 #

虽然官方文档里把authorizationUrl设为空，但GCP开发者门户的API Explorer需要这个字段来发起OAuth2授权流程。对于服务账号的implicit flow，你需要填入Google的标准OAuth2授权地址：

修改你的securityDefinitions配置如下：

securityDefinitions:
  google_service_account_dev:
    authorizationUrl: "https://accounts.google.com/o/oauth2/v2/auth"
    flow: "implicit"
    type: "oauth2"
    x-google-issuer: "[...]@appspot.gserviceaccount.com"
    x-google-jwks_uri: "https://www.googleapis.com/robot/v1/metadata/x509/[...]@appspot.gserviceaccount.com"
    x-google-audiences: "[...].appspot.com"

这个地址是Google OAuth2的标准授权端点，填入后门户就能识别这个安全定义并启用"Try this API"功能。

二、API Key的配置位置（替代过时文档的方法） #

旧文档里的APIs Explorer Settings板块已经被移除，现在需要直接在OpenAPI规范中定义API Key的安全规则，让门户自动显示输入框：

1. 在securityDefinitions中添加API Key的定义：

securityDefinitions:
  # 保留你已有的服务账号配置
  google_service_account_dev:
    ...
  # 新增API Key配置
  api_key:
    type: "apiKey"
    name: "key"
    in: "query"

2. 在API的根级别或具体接口级别添加security规则，允许两种认证方式二选一：

# 根级别配置（所有接口生效）
security:
  - google_service_account_dev: []
  - api_key: []

这样开发者门户的"Try this API"区域就会出现API Key的输入框，用户可以直接粘贴自己的API Key进行测试。

最后验证步骤 #

修改完OpenAPI规范后，记得重新部署你的Endpoints配置：

gcloud endpoints services deploy your-openapi-spec.yaml

等待部署完成后刷新开发者门户，"Try this API"功能应该就能正常启用，同时支持服务账号OAuth2和API Key两种认证方式。

内容的提问来源于stack exchange，提问作者Michał Herman