列出脚本的已执行进程的相关信息,例如进程类型和当前状态。
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[] |
可选字段,用于将返回的进程限制为具有某个指定用户访问权限级别的进程。 |