Method: processes.listScriptProcesses

Listen Sie Informationen zu den ausgeführten Skripts eines Skripts auf, 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 aufgelistet sind.

scriptProcessFilter

object (ListScriptProcessesFilter)

Ein Filter zum Begrenzen der Listenergebnisse. Es werden nur Prozesse zurückgegeben, die den Filterkriterien entsprechen.

pageSize

integer

Die maximale Anzahl der zurückgegebenen Prozesse pro Ergebnisseite. Der Standardwert ist 50.

pageToken

string

Das Token zum Fortsetzen einer vorherigen Listenanfrage auf der nächsten Seite. Dies sollte auf den 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 mit Anfrageparametern übereinstimmen.

nextPageToken

string

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht zu OAuth 2.0.

ListScriptProcessesFilter

Filter zur weiteren Angabe, 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, mit dem die zurückgegebenen Prozesse auf Projekte mit einer bestimmten Bereitstellungs-ID beschränkt werden.

functionName

string

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf diejenigen zu beschränken, die von einer Skriptfunktion mit dem angegebenen Funktionsnamen stammen.

startTime

string (Timestamp format)

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf diejenigen zu beschränken, die am oder nach dem angegebenen Zeitstempel gestartet wurden.

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

endTime

string (Timestamp format)

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf solche zu beschränken, die am oder vor dem angegebenen Zeitstempel abgeschlossen wurden.

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

types[]

enum (ProcessType)

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf diejenigen mit einem der angegebenen Prozesstypen zu beschränken.

statuses[]

enum (ProcessStatus)

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf solche mit einem der angegebenen Prozessstatus zu beschränken.

userAccessLevels[]

enum (UserAccessLevel)

Optionales Feld, das verwendet wird, um zurückgegebene Prozesse auf solche mit einer der angegebenen Nutzerzugriffsebenen zu beschränken.