Method: projects.tenants.jobs.search

Sucht mit dem angegebenen SearchJobsRequest nach Jobs.

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 eine Suchberechtigung hat.

HTTP-Anfrage

POST https://jobs.googleapis.com/v4beta1/{parent=projects/*/tenants/*}/jobs:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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 (SearchMode),
  "requestMetadata": {
    object (RequestMetadata)
  },
  "jobQuery": {
    object (JobQuery)
  },
  "enableBroadening": boolean,
  "requirePreciseResultSize": boolean,
  "histogramQueries": [
    {
      object (HistogramQuery)
    }
  ],
  "jobView": enum (JobView),
  "offset": integer,
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "diversificationLevel": enum (DiversificationLevel),
  "customRankingInfo": {
    object (CustomRankingInfo)
  },
  "disableKeywordMatch": boolean
}
Felder
searchMode

enum (SearchMode)

Der Modus einer Suche.

Die Standardeinstellung ist SearchMode.JOB_SEARCH.

requestMetadata

object (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. userId) werden von Nutzern angegeben und müssen eindeutig und einheitlich sein.

jobQuery

object (JobQuery)

Die Abfrage, mit der nach Jobs gesucht wird, beispielsweise mithilfe von Suchbegriffen, Standortfiltern usw.

enableBroadening

boolean

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
(deprecated)

boolean

Dieses Feld ist veraltet.

histogramQueries[]

object (HistogramQuery)

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: * count(string_histogram_facet): zählt die Anzahl der übereinstimmenden Entitäten für jeden einzelnen Attributwert. * count(numeric_histogram_facet, list of buckets): Zählt die Anzahl der übereinstimmenden Entitäten in jedem Bucket.

Datentypen:

  • Histogrammfacette: Facettennamen mit dem Format [a-zA-Z] [a-zA-Z0-9_]+.
  • String: String wie "jeder String mit Backslash-Escape-Zeichen für Zitate (")."
  • Zahl: ganze Zahl und Fließkommazahl wie 10, -1 und -0,01.
  • Liste: Liste der Elemente mit Komma (,), umgeben von eckigen Klammern, z. B. [1, 2, 3] und ["eins", "zwei", "drei"].

Integrierte Konstanten:

  • MIN (Mindestanzahl ähnlich wie Java Double.MIN_VALUE)
  • MAX (maximale Zahl ähnlich wie Java Double.MAX_VALUE)

Integrierte Funktionen

  • bucket(start, end[, label]): Die integrierte Bucket-Funktion erstellt einen Bucket mit einem Bereich von [start, end). Beachten Sie, dass das Ende exklusiv ist, z. B. Bucket (1, MAX, "positive Nummer") oder Bucket (1, 10).

Job-Histogramm-Facetten:

  • companyDisplayName: Histogramm nach Job.company_display_name.
  • Employment_type: Histogramm nach Job.employment_types, z. B. „FULL_TIME“, „PART_TIME“.
  • companySize: Histogramm nach CompanySize, z. B. "KLEIN", "MITTEL", "GROSS".
  • Publish_time_in_month: Histogramm nach Job.posting_publish_time in Monaten. Die Liste der numerischen Buckets muss in Spezifikation angegeben werden.
  • Publish_time_in_year: Histogramm nach Job.posting_publish_time in Jahren. Die Liste der numerischen Buckets muss in Spezifikation angegeben werden.
  • degreeTypes: Histogramm nach Job.degree_types, z. B. "Bachelor", "Master".
  • jobLevel: Histogramm nach Job.job_level, z. B. „Einstiegsniveau“.
  • country: Histogramm nach Ländercode der Jobs, z. B. "US", "FR".
  • admin1: Histogramm nach admin1-Code von Jobs, d. h. ein globaler Platzhalter, der sich auf den Bundesstaat, die Provinz oder den bestimmten Begriff bezieht, den ein Land verwendet, um die geografische Struktur unterhalb der Länderebene zu definieren, z. B. „CA“, „IL“.
  • city: Histogramm nach Kombination aus "Ortsname, admin1-Code". Beispiel: „Mountain View, CA“, „New York, NY“.
  • admin1_country: Histogramm nach einer Kombination aus „admin1 code, country“, z. B. „CA, US“, „IL, US“.
  • city_Coordinate: Histogramm nach den GPS-Koordinaten des Stadtzentrums (Breiten- und Längengrad), z. B. 37.4038522,-122.0987765. Da sich die Koordinaten eines Stadtzentrums ändern können, müssen Kunden diese regelmäßig aktualisieren.
  • Sprache: Histogramm nach Job.language_code, z. B. "en-US", "fr-FR".
  • language: Histogramm nach dem Sprach-Subtag von Job.language_code, z. B. "en", "fr".
  • Kategorie: Histogramm nach JobCategory, z. B. "COMPUTER_UND_IT", "GESUNDHEITSWESEN".
  • base_unit_unit: Histogramm nach CompensationInfo.CompensationUnit des Grundgehalts, z. B. "WEEKLY", "MONTHLY".
  • base_compensation: Histogramm nach dem Grundgehalt. Sie müssen eine Liste mit numerischen Buckets angeben, nach denen die Ergebnisse gruppiert werden sollen.
  • annualized_base_compensation: Histogramm nach dem annualisierten Grundlohn. Hier muss eine Liste von numerischen Buckets angegeben werden, um die Ergebnisse gruppieren zu können.
  • annualized_total_compensation: Histogramm nach dem annualisierten Gesamtlohn. Hier muss eine Liste von numerischen Buckets angegeben werden, um die Ergebnisse gruppieren zu können.
  • string_custom_attribute: Histogramm nach String Job.custom_attributes. Auf Werte kann über eckige Klammern wie string_custom_attribute["key1"] zugegriffen werden.
  • numerische_custom_attribute: Histogramm nach numerischem Job.custom_attributes-Wert. Auf Werte kann über eckige Klammern wie „numerisches_benutzerdefiniertes_Attribut“["key1"] zugegriffen werden. Sie müssen eine Liste mit numerischen Buckets angeben, nach denen die Ergebnisse gruppiert werden sollen.

Beispielausdrücke:

  • count(admin1)
  • count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])
  • count(string_custom_attribute["some-string-custom-attribute"])
  • count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
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_SMALL verwendet.

offset

integer

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 pageToken nicht festgelegt ist.

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

integer

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

string

Das Token, das den aktuellen Offset in den Suchergebnissen angibt. Informationen dazu, wie Sie den nächsten Satz von Abfrageergebnissen erhalten, finden Sie unter SearchJobsResponse.next_page_token.

orderBy

string

Die Kriterien, nach denen die Suchergebnisse sortiert werden. Standardwert ist "relevance desc".

Unterstützte Optionen sind:

  • "relevance desc": absteigend nach Relevanz, wie von den API-Algorithmen bestimmt. Die Relevanzschwellenwerte von Abfrageergebnissen sind nur bei dieser Sortierung verfügbar.
  • "postingPublishTime desc": Nach Job.posting_publish_time absteigend.
  • "postingUpdateTime desc": Nach Job.posting_update_time absteigend.
  • "title": Nach Job.title aufsteigend.
  • "title desc": Nach Job.title absteigend.
  • "annualized_base_compensation": Nach CompensationInfo.annualized_base_compensation_range des Jobs aufsteigend. Jobs, für die keine jährliche Grundvergütung angegeben ist, werden am Ende der Suchergebnisse gestellt.
  • "annualized_base_compensation desc": Nach CompensationInfo.annualized_base_compensation_range des Jobs absteigend. Jobs, für die keine jährliche Grundvergütung angegeben ist, werden am Ende der Suchergebnisse gestellt.
  • "annualized_total_compensation": Nach CompensationInfo.annualized_total_compensation_range des Jobs aufsteigend. Jobs, für die keine jährliche Grundvergütung angegeben ist, werden am Ende der Suchergebnisse gestellt.
  • "annualized_total_compensation desc": Nach CompensationInfo.annualized_total_compensation_range des Jobs absteigend. Jobs, für die keine jährliche Grundvergütung angegeben ist, werden am Ende der Suchergebnisse gestellt.
  • "custom_ranking desc": Nach dem Relevanzwert, angepasst an den SearchJobsRequest.CustomRankingInfo.ranking_expression mit dem Gewichtungsfaktor, der durch SearchJobsRequest.CustomRankingInfo.importance_level in absteigender Reihenfolge zugewiesen wird.
  • Standortsortierung: Verwenden Sie die spezielle Syntax, um Aufträge nach Entfernung zu sortieren:
    "distance_from('Hawaii')": Sortieren Sie nach der Entfernung von Hawaii.
    "distance_from(19.89, 155.5)": Sortierung nach Entfernung zu einer Koordinate.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": Nach mehreren Standorten sortieren. Weitere Informationen finden Sie unten.
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": Nach mehreren Standorten sortieren. Weitere Informationen finden Sie unten.
    Der String darf maximal 256 Zeichen lang sein. Wenn mehrere Entfernungszentren angegeben werden, hat ein Job, der sich in der Nähe eines der Entfernungszentren befindet, einen hohen Rang. Wenn ein Auftrag mehrere Standorte hat, wird der Standort verwendet, der einem der Entfernungszentren am nächsten liegt. Jobs ohne Standorte werden ganz unten angeordnet. Die Entfernung wird mit einer Genauigkeit von 11,3 Metern berechnet. Die Diversifizierungsstrategie wird weiterhin angewendet, sofern sie in diversificationLevel nicht explizit deaktiviert ist.
diversificationLevel

enum (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 DiversificationLevel.SIMPLE verwendet.

customRankingInfo

object (CustomRankingInfo)

Steuert, welches Ranking Jobdokumente über den vorhandenen Relevanzwert (über den API-Algorithmus) hinweg erhalten.

disableKeywordMatch

boolean

Steuert, ob die Keyword-Option „Genau passend“ für Job.title, Job.description, Job.company_display_name, Job.addresses, Job.qualifications deaktiviert wird. Wenn die Option zum Deaktivieren der Keyword-Übereinstimmung deaktiviert ist, werden bei einer Keyword-Übereinstimmung Jobs zurückgegeben, die nicht den angegebenen Kategoriefiltern entsprechen, wenn übereinstimmende Keywords vorhanden sind. Für die Abfrage "Programmmanager" wird beispielsweise ein Ergebnis zurückgegeben, auch wenn die Stellenausschreibung den Titel "Softwareentwickler" trägt, der nicht in die "Programmmanager"-Ontologie fällt, jedoch "Programmmanager" in der Beschreibung enthält.

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 Company.keyword_searchable_job_custom_attributes, wenn unternehmensspezifische, global übereinstimmende benutzerdefinierte Feld-/Attributstringwerte erforderlich sind. Durch Aktivieren der Keyword-Option wird der Abruf nachfolgender Suchanfragen verbessert.

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.