Method: processes.listScriptProcesses

Informationen zu den durch ein Skript ausgeführten Prozessen auflisten, z. B. den Prozesstyp und den aktuellen Status.

HTTP-Anfrage

GET https://script.googleapis.com/v1/processes:listScriptProcesses

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
scriptId

string

Die Skript-ID des Projekts, dessen Prozesse aufgeführt sind.

scriptProcessFilter

object (ListScriptProcessesFilter)

Ein Filter, mit dem die Listenergebnisse begrenzt werden. Es werden nur Prozesse zurückgegeben, die den Filterkriterien entsprechen.

pageSize

integer

Die maximale Anzahl zurückgegebener Prozesse pro Ergebnisseite. Die Standardeinstellung ist 50.

pageToken

string

Das Token zum Fortsetzen einer vorherigen Listenanfrage auf der nächsten Seite. Hier sollte der Wert von nextPageToken aus einer vorherigen Antwort festgelegt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort mit der Liste der Process-Ressourcen.

JSON-Darstellung
{
  "processes": [
    {
      object (Process)
    }
  ],
  "nextPageToken": string
}
Felder
processes[]

object (Process)

Liste der Prozesse, die Anfrageparametern entsprechen.

nextPageToken

string

Token für die nächste Ergebnisseite. Wenn das Feld leer ist, sind keine weiteren Seiten übrig.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/script.processes

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListScriptProcessesFilter

Filter, mit dem genauer angegeben wird, welche Prozesse aufgelistet werden sollen. Es werden nur Prozesse zurückgegeben, die alle angegebenen Bedingungen erfüllen.

JSON-Darstellung
{
  "deploymentId": string,
  "functionName": string,
  "startTime": string,
  "endTime": string,
  "types": [
    enum (ProcessType)
  ],
  "statuses": [
    enum (ProcessStatus)
  ],
  "userAccessLevels": [
    enum (UserAccessLevel)
  ]
}
Felder
deploymentId

string

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf diejenigen zu beschränken, die aus Projekten mit einer bestimmten Bereitstellungs-ID stammen.

functionName

string

Optionales Feld, mit dem zurückgegebene Prozesse auf diejenigen beschränkt werden, die aus einer Skriptfunktion mit dem angegebenen Funktionsnamen stammen.

startTime

string (Timestamp format)

Optionales Feld, mit dem zurückgegebene Prozesse auf Prozesse beschränkt werden, die am oder nach dem angegebenen Zeitstempel gestartet wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Optionales Feld, mit dem zurückgegebene Prozesse auf Prozesse beschränkt werden, die am oder vor dem angegebenen Zeitstempel abgeschlossen wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

types[]

enum (ProcessType)

Optionales Feld, mit dem zurückgegebene Prozesse auf Prozesse mit einem der angegebenen Prozesstypen beschränkt werden.

statuses[]

enum (ProcessStatus)

Optionales Feld, mit dem zurückgegebene Prozesse auf Prozesse mit einem der angegebenen Prozessstatus beschränkt werden.

userAccessLevels[]

enum (UserAccessLevel)

Optionales Feld, mit dem zurückgegebene Prozesse auf Nutzer mit einer der angegebenen Nutzerzugriffsebenen beschränkt werden.