列出指令碼執行程序的相關資訊,例如程序類型和目前狀態。
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 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
endTime |
選用欄位,限制只傳回在指定時間戳記當天或之前完成的程序。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
types[] |
這個選填欄位是用來限制傳回的程序,只有具有其中一種指定程序類型的程序。 |
statuses[] |
此為選填欄位,用來限制傳回的程序只有具有任一指定程序狀態的使用者。 |
userAccessLevels[] |
這是選填欄位,用途是限制系統只傳回具有指定使用者存取層級的程序。 |