跳轉到

Gemini Credentials API

此 API 處於 Beta 階段。端點位於 /v1beta/ 之下。

Credentials API 可讓你建立、擷取、更新、列出及刪除由伺服器管理的憑證(例如 API 金鑰、OAuth2 權杖、HTTP Bearer 權杖與環境變數),用來驗證工具呼叫與 MCP 伺服器。

方法

方法 HTTP 要求
建立憑證 POST /v1beta/credentials 建立新的憑證。
列出憑證 GET /v1beta/credentials 列出憑證。
取得憑證 GET /v1beta/credentials/{id} 依 ID 取得憑證。
更新憑證 PATCH /v1beta/credentials/{id} 更新憑證。
刪除憑證 DELETE /v1beta/credentials/{id} 刪除憑證。

資源

Credential

儲存在 Secret Manager 中、由伺服器管理的憑證資源。

屬性:

id:必填 string

僅供輸出。識別碼。此憑證的唯一識別碼。


**type**:必填 `string enum` 僅供輸出。憑證的類型。 可能的值: - `bearer_token`:以標頭形式注入的靜態權杖。無更新邏輯。 - `oauth2`:使用儲存的更新權杖,自動更新已過期的存取權杖。 - `environment_variable`:注入沙箱容器的環境變數。

**status**:`string enum` 僅供輸出。憑證目前的狀態。 可能的值: - `active`:憑證處於啟用狀態,可供使用。 - `revoked`:憑證已遭撤銷,不再有效。

create_time:string

僅供輸出。憑證建立的時間戳記。


update_time:string

僅供輸出。憑證上次更新的時間戳記。