列出有关脚本的已执行进程的信息,例如进程类型和当前状态。
HTTP 请求
GET https://script.googleapis.com/v1/processes:listScriptProcesses
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
scriptId |
列出其进程的项目的脚本 ID。 |
scriptProcessFilter |
用于限制列表结果的过滤条件;仅返回与过滤条件匹配的进程。 |
pageSize |
每页结果返回的最大进程数。默认值为 50。 |
pageToken |
用于在下一页上继续之前的列表请求的令牌。此值应设为上一个响应中 |
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
包含 Process
资源列表的响应。
JSON 表示法 |
---|
{
"processes": [
{
object ( |
字段 | |
---|---|
processes[] |
与请求参数匹配的进程的列表。 |
nextPageToken |
用于下一页结果的令牌。如果为空,则表示没有更多剩余页面。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/script.processes
如需了解详情,请参阅 OAuth 2.0 概览。
ListScriptProcessesFilter
用于进一步指定要列出的进程的过滤条件。仅返回符合所有指定条件的进程。
JSON 表示法 |
---|
{ "deploymentId": string, "functionName": string, "startTime": string, "endTime": string, "types": [ enum ( |
字段 | |
---|---|
deploymentId |
可选字段,用于将返回的进程限制为来自具有特定部署 ID 的项目的进程。 |
functionName |
可选字段,用于将返回的进程限制为源自具有指定函数名称的脚本函数的进程。 |
startTime |
可选字段,用于将返回的进程限制为在指定时间戳或之后启动的进程。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
endTime |
可选字段,用于将返回的进程限制为在指定时间戳或之前完成的进程。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
types[] |
可选字段,用于将返回的进程限制为具有指定进程类型之一的进程。 |
statuses[] |
可选字段,用于将返回的进程限制为具有指定进程状态之一的进程。 |
userAccessLevels[] |
可选字段,用于将返回的进程限制为具有指定用户访问权限级别之一的进程。 |