取得批次¶
GET https://generativelanguage.googleapis.com/v1beta/batches/{generateContentBatch}
取得長時間執行作業的最新狀態。用戶端可以使用此方法,依 API 服務建議的間隔輪詢作業結果。
參數¶
generateContentBatch: required string
批次 ID。組成資源名稱 batches/{generateContentBatch}。
範例請求
curl -X GET "https://generativelanguage.googleapis.com/v1beta/batches/$BATCH_ID" \
-H "x-goog-api-key: $GEMINI_API_KEY"
回應¶
**error**: `Status` 作業失敗或取消時的錯誤結果。
**code**: `integer` 狀態碼,應為 google.rpc.Code 的列舉值。 **message**: `string` 面向開發人員的錯誤訊息,應以英文撰寫。任何面向使用者的錯誤訊息都應本地化,並透過 google.rpc.Status.details 欄位傳送,或由用戶端本地化。 **details**: `object array` 承載錯誤詳細資訊的訊息清單。API 可使用一組通用的訊息類型。response: object
作業正常且成功的回應。如果原始方法在成功時不傳回資料(例如 Delete),回應為 google.protobuf.Empty。如果原始方法是標準的 Get/Create/Update,回應應為該資源。對於其他方法,回應的類型應為 XxxResponse,其中 Xxx 是原始方法名稱。例如,如果原始方法名稱為 TakeSnapshot(),推斷的回應類型即為 TakeSnapshotResponse。
name: string
由伺服器指派的名稱,僅在最初傳回它的同一個服務內具唯一性。如果使用預設的 HTTP 對應,name 應為以 operations/{unique_id} 結尾的資源名稱。
metadata: object
與作業相關聯的服務專屬中繼資料。通常包含進度資訊,以及建立時間等常見中繼資料。有些服務可能不提供這類中繼資料。任何傳回長時間執行作業的方法,都應記錄其中繼資料類型(如有)。
done: boolean
如果值為 false,表示作業仍在進行中。如果為 true,表示作業已完成,且可取得 error 或 response。
範例回應
{
"error": {
"code": 0,
"message": "string",
"details": [
{}
]
},
"response": {},
"name": "string",
"metadata": {},
"done": true
}