Method: processes.list

Informationen zu Prozessen, die von oder im Namen 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 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.

ListUserProcessesFilter

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

deploymentId

string

Optionales Feld, mit dem die zurückgegebenen Prozesse auf Projekte mit einer bestimmten Bereitstellungs-ID beschränkt werden.

projectName

string

Optionales Feld, mit dem die zurückgegebenen Prozesse auf Projekte mit Projektnamen beschränkt werden, die einen bestimmten String enthalten.

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.