建立憑證¶
此 API 處於 Beta 階段。端點位於 /v1beta/ 之下。
POST https://generativelanguage.googleapis.com/v1beta/credentials
建立新的憑證。
要求主體¶
要求主體的結構取決於互動模式:
**EnvironmentVariableConfig**
環境變數憑證的設定。 **value**:必填 `string` 僅供輸入。環境變數的機密值。僅供寫入;不會在回應中傳回。 ---**injection_location**:必填 `InjectionLocation` 或 `InjectionLocation array` 可將環境變數注入外送 HTTP 要求的位置。至少須包含一個位置。可接受單一位置(例如 "header")或位置陣列。
**可能的類型**:**InjectionLocation**
可能的值: - `header`:注入 HTTP 要求標頭。 - `query`:注入 HTTP URL 查詢參數。 - `body`:注入 HTTP 要求主體。**InjectionLocation array**
可能的值: - `header`:注入 HTTP 要求標頭。 - `query`:注入 HTTP URL 查詢參數。 - `body`:注入 HTTP 要求主體。**HttpBearerConfig**
HTTP Bearer 權杖憑證的設定。 **token**:必填 `string` 僅供輸入。靜態 Bearer 權杖。僅供寫入;不會在回應中傳回。 --- **id**:必填 `string` --- **type**:必填 `object` 值:`bearer_token` --- **header_name**:`string` 選填。要注入權杖的標頭名稱。預設為 'Authorization'。 --- **prefix**:`string` 選填。要加在權杖前面的前綴。預設為 'Bearer'。設為 '' 表示不加前綴。**OAuth2Config**
具備自動權杖更新功能的 OAuth2 憑證設定。 **client_id**:必填 `string` OAuth2 用戶端 ID。 --- **client_secret**:必填 `string` 僅供輸入。OAuth2 用戶端密鑰。僅供寫入;不會在回應中傳回。 --- **refresh_token**:必填 `string` 僅供輸入。OAuth2 更新權杖。僅供寫入;不會在回應中傳回。 --- **token_url**:必填 `string` 用於更新存取權杖的 OAuth2 權杖端點 URL。 --- **id**:必填 `string` --- **type**:必填 `object` 值:`oauth2` --- **scopes**:`string array` 選填。OAuth2 範圍清單。範例要求
curl -X POST "https://generativelanguage.googleapis.com/v1beta/credentials" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"value": "string",
"injection_location": "header",
"id": "string",
"type": "environment_variable"
}'
回應¶
id:必填 string
僅供輸出。識別碼。此憑證的唯一識別碼。
**type**:必填 `string enum` 僅供輸出。憑證的類型。
可能的值: - `bearer_token`:以標頭形式注入的靜態權杖。無更新邏輯。 - `oauth2`:使用儲存的更新權杖,自動更新已過期的存取權杖。 - `environment_variable`:注入沙箱容器的環境變數。**status**:`string enum` 僅供輸出。憑證目前的狀態。
可能的值: - `active`:憑證處於啟用狀態,可供使用。 - `revoked`:憑證已遭撤銷,不再有效。create_time:string
僅供輸出。憑證建立的時間戳記。
update_time:string
僅供輸出。憑證上次更新的時間戳記。
範例回應
{
"id": "string",
"type": "bearer_token",
"status": "active",
"create_time": "string",
"update_time": "string"
}