Method: projects.jobs.list

Listet Jobs nach Filter auf.

HTTP-Anfrage

GET https://jobs.googleapis.com/v4beta1/{parent=projects/*}/jobs

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Mandanten, unter dem der Job erstellt wird.

Das Format ist „projects/{projectId}/Mandanten/{Mandanten-ID}“. Beispiel: „projects/foo/Mandant/bar“. Wenn keine Mandanten-ID angegeben ist, wird ein Standardmandant erstellt. Beispiel: „projects/foo“.

Abfrageparameter

Parameter
filter

string

Erforderlich. Der Filterstring gibt die aufzuzählenden Jobs an.

Unterstützter Operator: =, AND

Folgende Felder können gefiltert werden:

  • companyName (erforderlich)
  • requisitionId
  • status Verfügbare Werte: OPEN, ABGELAUFEN, ALL. Wenn kein Wert angegeben wird, ist die Standardeinstellung OPEN.

Beispielabfrage:

  • companyName = "projects/foo/Mandanten/bar/company/baz"
  • companyName = "projects/foo/Mandanten/bar/company/baz" UND requisitionId = "req-1"
  • companyName = "projects/foo/Mandanten/bar/company/baz" UND status = "ABGELAUFEN"
pageToken

string

Der Ausgangspunkt für ein Abfrageergebnis.

pageSize

integer

Die maximale Anzahl von Jobs, die pro Ergebnisseite zurückgegeben werden soll.

Wenn jobView auf JobView.JOB_VIEW_ID_ONLY gesetzt ist, beträgt die maximal zulässige Seitengröße 1.000. Andernfalls beträgt die maximal zulässige Seitengröße 100.

Die Standardeinstellung ist 100, wenn kein Wert oder eine Zahl < 1 angegeben wird.

jobView

enum (JobView)

Die gewünschten Jobattribute, die für Jobs in der Suchantwort zurückgegeben wurden. Wenn kein Wert angegeben wird, wird standardmäßig JobView.JOB_VIEW_FULL verwendet.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListJobsResponse.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Authentifizierungsübersicht.