Method: processes.list

Informationen zu Prozessen auflisten, die von oder im Auftrag eines Nutzers durchgeführt wurden, z. B. Prozesstyp und aktueller Status.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
userProcessFilter

object (ListUserProcessesFilter)

Ein Filter zum Einschränken der Listenergebnisse. 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. 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 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.

ListUserProcessesFilter

Filter zur weiteren Festlegung, welche Prozesse aufgelistet werden sollen. Es werden nur Prozesse zurückgegeben, die alle angegebenen Bedingungen erfüllen.

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

string

Optionales Feld, mit dem zurückgegebene Prozesse auf diejenigen beschränkt werden, die aus Projekten mit einer bestimmten Skript-ID stammen.

deploymentId

string

Optionales Feld, mit dem zurückgegebene Prozesse auf diejenigen beschränkt werden, die aus Projekten mit einer bestimmten Bereitstellungs-ID stammen.

projectName

string

Optionales Feld, mit dem zurückgegebene Prozesse auf diejenigen beschränkt werden, die von Projekten mit Projektnamen stammen, die einen bestimmten String enthalten.

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.