JobService.GetGenerationProgress
GetGenerationProgress
Read current state and immutable history without triggering recovery.
Authentication
| 支持组合 | OAuth 2.0 |
|---|---|
| No identity | |
| User identity | |
| Org identity |
所需 scopes：pinpage:read
Request
路径参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
user_id | string | yes | Required. user id. |
job_id | string | yes | Required. job id. |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
afterEventSeq | integer (int64) | — | Optional. after event seq. |
pageSize | integer (int32) | — | Optional. page size. |
pageToken | string | — | Optional. page token. |
uiLocale | string | — | Optional. ui locale. |
Response
200 OK · GetGenerationProgressResponse
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
job | JobSummary | yes | Required. job. |
page_title | string | yes | Required. page title. |
title_revision | integer (int64) | yes | Required. title revision. |
title_origin | string | yes | Required. title origin. |
instruction_locale | string | — | (OPTIONAL) Optional. instruction locale. |
locale_source | string | — | (OPTIONAL) Optional. locale source. |
content_locale | string | — | (OPTIONAL) Optional. content locale. |
content_locales | array<string> | — | (OPTIONAL) Optional. content locales. |
content_locale_source | string | — | (OPTIONAL) Optional. content locale source. |
locale_status | string | yes | Required. locale status. |
steps | array<GenerationProgressStep> | yes | Required. steps. |
events | array<GenerationProgressEvent> | yes | Required. events. |
current_revision | integer (int64) | yes | Required. current revision. |
history_upper_event_seq | integer (int64) | yes | Required. history upper event seq. |
last_event_seq | integer (int64) | yes | Required. last event seq. |
next_page_token | string | — | (OPTIONAL) Optional. next page token. |
progress_available | boolean | yes | Required. progress available. |
resolved_ui_locale | string | yes | Required. resolved ui locale. |
poll_after_ms(nullable) | integer (int32) | — | (OPTIONAL) Optional. poll after ms. |
content_locale_display_name | string | — | (OPTIONAL) Optional. Human-readable content language name(s), localized using resolved_ui_locale, never the instruction language. Empty while metadata is pending. Display only; existing locale and title fields are unchanged. |
错误响应 · google.rpc.Status
非 2xx 响应均按 AIP-193 规范包装为google.rpc.Status，含 code /message /details 三段。details[].reason 是机器可读的具体错误原因码，可用于客户端分支处理。
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
code | integer (int32) | — | The status code, which should be an enum value of google.rpc.Code. |
message | string | — | A developer-facing error message. |
details | array<Any> | — | A list of messages that carry the error details. |
Examples
curl -X GET \
'https://api.appforges.com/v1/users/{user_id}/pinpage-jobs/{job_id}/progress' \
-H 'Authorization: Bearer $ACCESS_TOKEN'OpenAPI spec v0.59.4 · synced 10/11/2026, 11:27:14 PM