列出使用者或代表使用者執行的程序相關資訊,例如程序類型和目前狀態。
HTTP 要求
GET https://script.googleapis.com/v1/processes
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
userProcessFilter |
用於限制清單結果的篩選器;系統只會傳回符合篩選條件的程序。 |
pageSize |
每頁傳回的程序數量上限。預設值為 50。 |
pageToken |
用於繼續先前在下一頁列出要求所需的權杖。這個值應設為先前回應中的 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
提供 Process
資源清單的回應。
JSON 表示法 |
---|
{
"processes": [
{
object ( |
欄位 | |
---|---|
processes[] |
比對要求參數的程序清單。 |
nextPageToken |
下一頁結果的權杖。如果留空,則表示已沒有其他頁面。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/script.processes
詳情請參閱 OAuth 2.0 總覽。
ListUserProcessesFilter
用來進一步指定要列出哪些程序的篩選器。系統只會傳回符合所有指定條件的程序。
JSON 表示法 |
---|
{ "scriptId": string, "deploymentId": string, "projectName": string, "functionName": string, "startTime": string, "endTime": string, "types": [ enum ( |
欄位 | |
---|---|
scriptId |
選填欄位,可將傳回的程序限制為來自具有特定指令碼 ID 的專案。 |
deploymentId |
選填欄位,可將傳回的程序限制為來自具有特定部署 ID 的專案。 |
projectName |
選填欄位,可將傳回的程序限制為專案名稱含有特定字串的專案。 |
functionName |
選填欄位,可將傳回的程序限制在具備指定函式名稱的指令碼函式觸發的程序。 |
startTime |
選填欄位,可將傳回的程序限制在指定時間戳記當天或之後啟動的程序。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
endTime |
選填欄位,可將傳回的程序限制在指定時間戳記當天或之前完成的程序。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
types[] |
選填欄位,可將傳回的程序限制為具有其中一種指定程序類型的程序。 |
statuses[] |
這個選填欄位可用於限制傳回的程序,僅傳回具有任一指定程序狀態的程序。 |
userAccessLevels[] |
選用欄位,用於將傳回的程序限制為具有其中一個指定使用者存取層級的程序。 |