Sucht mit dem angegebenen SearchJobsRequest
nach Jobs.
Dieser API-Aufruf ist für den Anwendungsfall mit einer Ausrichtung auf passive Jobsuchende bestimmt (z. B. Jobsuchende, die sich für E-Mail-Benachrichtigungen zu potenziellen freien Stellen registriert haben). Er hat andere Einstellungen für Algorithmen, die auf passive Jobsuchende ausgerichtet sind.
Bei diesem Aufruf werden die visibility
der in der Datenbank vorhandenen Jobs eingeschränkt und es werden nur Jobs zurückgegeben, für die der Aufrufer über eine Suchberechtigung verfügt.
HTTP-Anfrage
POST https://jobs.googleapis.com/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Der Ressourcenname des Mandanten, in dem gesucht werden soll. 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“. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung | |
---|---|
{ "searchMode": enum ( |
Felder | |
---|---|
searchMode |
Der Modus einer Suche. Die Standardeinstellung ist |
requestMetadata |
Erforderlich. Die Metainformationen, die vom Jobsuchenden erfasst werden. Diese Informationen werden verwendet, um die Suchqualität des Dienstes zu verbessern. Die Kennungen (z. B. |
jobQuery |
Die Abfrage, mit der nach Jobs gesucht wird, beispielsweise mithilfe von Suchbegriffen, Standortfiltern usw. |
enableBroadening |
Gibt an, ob die Suche erweitert werden soll, wenn sie zu wenig Ergebnisse geliefert hat. Bei erweiterten Suchanfragen werden die Ergebnisse an das Ende der Trefferliste angehängt. Die Standardeinstellung ist "false". |
requirePreciseResultSize |
Dieses Feld ist veraltet. |
histogramQueries[] |
Ein Ausdruck gibt eine Histogrammanforderung für übereinstimmende Jobs an. Die Ausdruckssyntax ist ein Aufruf der Aggregationsfunktion mit Histogrammfacetten und anderen Optionen. Verfügbare Aggregationsfunktionsaufrufe sind: * Datentypen:
Integrierte Konstanten:
Integrierte Funktionen
Job-Histogramm-Facetten:
Beispielausdrücke:
|
jobView |
Die gewünschten Jobattribute, die für Jobs in der Suchantwort zurückgegeben wurden. Wenn kein Wert angegeben wird, wird standardmäßig |
offset |
Eine ganze Zahl, die den aktuellen Offset (d. h. Position des Startergebnisses für die Jobs, die von der API als relevant eingestuft werden) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn Der maximal zulässige Wert beträgt 5.000. Andernfalls wird ein Fehler ausgegeben. Zum Beispiel bedeutet 0, dass Ergebnisse ab dem ersten übereinstimmenden Job zurückgegeben werden, und 10, dass die Rückgabe ab dem elften Job erfolgt. Dies kann zur Paginierung verwendet werden. Beispielsweise bedeuten die Einstellungen "pageSize = 10" und "offset = 10", dass Ergebnisse ab der zweiten Seite zurückgegeben werden. |
pageSize |
Ein Limit für die Anzahl der in den Suchergebnissen zurückgegebenen Jobs. Wenn ein höherer Wert als der Standardwert von 10 ausgewählt wird, kann dies zu längeren Antwortzeiten bei der Suche führen. Der Wert kann im Bereich von 1 bis 100 liegen. |
pageToken |
Das Token, das den aktuellen Offset in den Suchergebnissen angibt. Informationen dazu, wie Sie den nächsten Satz von Abfrageergebnissen erhalten, finden Sie unter |
orderBy |
Die Kriterien, nach denen die Suchergebnisse sortiert werden. Standardwert ist Unterstützte Optionen sind:
|
diversificationLevel |
Steuert, ob sehr ähnliche Jobs in den Suchergebnissen nebeneinander angezeigt werden. Jobs werden aufgrund ihrer Titel, Jobkategorien und Standorte als sehr ähnlich identifiziert. Sehr ähnliche Ergebnisse werden in einem Cluster zusammengefasst, sodass dem Stellensuchenden in den Ergebnissen nur ein repräsentativer Job des Clusters angezeigt wird, während die anderen Jobs in den Ergebnissen weiter unten angezeigt werden. Wenn kein Wert angegeben wird, wird standardmäßig |
customRankingInfo |
Steuert, welches Ranking Jobdokumente über den vorhandenen Relevanzwert (über den API-Algorithmus) hinweg erhalten. |
disableKeywordMatch |
Steuert, ob die Keyword-Option „Genau passend“ für Bei Abfragen wie "Cloud", die keine titel- oder ortsspezifische Ontologie enthalten, werden Jobs mit "Cloud"-Keyword-Übereinstimmungen unabhängig vom Wert dieses Flags zurückgegeben. Verwenden Sie Die Standardeinstellung ist "false". |
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SearchJobsResponse
.
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.