Method: processes.listScriptProcesses

Listet Informationen zu den ausgeführten Prozessen eines Skripts auf, z. B. Prozesstyp und 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 werden.

scriptProcessFilter

object (ListScriptProcessesFilter)

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

pageSize

integer

Die maximale Anzahl von zurückgegebenen Prozessen pro Ergebnisseite. Die Standardeinstellung ist 50.

pageToken

string

Das Token, mit dem eine vorherige Listenanfrage auf der nächsten Seite fortgesetzt wird. Dieser 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 den Anfrageparametern entsprechen.

nextPageToken

string

Token für die nächste Ergebnisseite. Wenn das Feld leer ist, gibt es keine weiteren Seiten mehr.

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 zur weiteren Festlegung, 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 zurückgegebene Prozesse auf diejenigen beschränkt werden, die aus Projekten mit einer bestimmten Bereitstellungs-ID stammen.

functionName

string

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

startTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 diejenigen beschränkt werden, die am oder vor dem angegebenen Zeitstempel abgeschlossen wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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, mit dem zurückgegebene Prozesse auf diejenigen mit einem der angegebenen Prozessstatus beschränkt werden können.

userAccessLevels[]

enum (UserAccessLevel)

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