JobQuery

Die für die Durchführung einer Suchabfrage erforderliche Abfrage.

JSON-Darstellung 
{
  "query": string,
  "queryLanguageCode": string,
  "companies": [
    string
  ],
  "locationFilters": [
    {
      object (LocationFilter)
    }
  ],
  "jobCategories": [
    enum (JobCategory)
  ],
  "commuteFilter": {
    object (CommuteFilter)
  },
  "companyDisplayNames": [
    string
  ],
  "compensationFilter": {
    object (CompensationFilter)
  },
  "customAttributeFilter": string,
  "disableSpellCheck": boolean,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "languageCodes": [
    string
  ],
  "publishTimeRange": {
    object (TimestampRange)
  },
  "excludedJobs": [
    string
  ]
}
Felder
query

string

Der Abfragestring, der einen Abgleich mit den Feldern für die Position, die Beschreibung und den Standort ausführt.

Es sind maximal 255 Zeichen zulässig.
queryLanguageCode

string

Der Sprachcode von query. Zum Beispiel: "en-US". Mit diesem Feld lässt sich die Abfrage besser interpretieren.

Wenn kein Wert angegeben ist, wird der Abfragesprachcode automatisch erkannt, der möglicherweise nicht genau ist.

Der Sprachcode muss im BCP-47-Format angegeben werden, z. B. „en-US“ oder „sr-Latn“. Weitere Informationen finden Sie unter Tags zur Identifizierung von Sprachen.
companies[]

string

In diesem Filter werden die zu durchsuchenden Unternehmensentitäten angegeben.

Wenn kein Wert angegeben ist, werden alle Unternehmen nach Jobs durchsucht.

Sind mehrere Werte angegeben, wird in den angegebenen Unternehmen nach Jobs gesucht.

Das Format ist „projects/{projectId}/Mandanten/{MandantenId}/company/{company_id}“. Beispiel: „projects/foo/Mandanten/bar/company/baz“.

Wenn keine Mandanten-ID angegeben ist, wird der Standardmandant verwendet. Beispiel: „projects/foo/company/bar“.

Es sind höchstens 20 Unternehmensfilter zulässig.
locationFilters[]

object (LocationFilter)

Im Standortfilter werden geografische Regionen angegeben, in denen die Jobs liegen, die gesucht werden. Weitere Informationen findest du unter LocationFilter.

Wird kein Wert für den Standort angegeben, werden Jobs entsprechend den anderen Suchkriterien abgerufen, ungeachtet des jeweiligen Standorts.

Wenn mehrere Werte angegeben sind, werden Aufträge von einem der angegebenen Standorte abgerufen. Wenn für den Parameter LocationFilter.distance_in_miles unterschiedliche Werte angegeben werden, wird für alle Standorte die angegebene maximale Entfernung verwendet.

Es sind höchstens fünf Standortfilter zulässig.
jobCategories[]

enum (JobCategory)

Im Kategoriefilter werden die Kategorien der zu suchenden Jobs angegeben. Weitere Informationen findest du unter JobCategory.

Wenn kein Wert angegeben wird, wird nach Jobs aus beliebigen Kategorien gesucht.

Wenn mehrere Werte angegeben sind, können die Suchergebnisse zu einer beliebigen der angegebenen Kategorien gehören.
commuteFilter

object (CommuteFilter)

Ermöglicht das Filtern von Jobs nach dem Anfahrtsweg mit unterschiedlichen Verkehrsmitteln (z. B. mit dem Auto oder öffentlichen Verkehrsmitteln).

Hinweis: Dies funktioniert nur, wenn Sie CommuteMethod angeben. In diesem Fall wird locationFilters ignoriert.

Derzeit unterstützen wir keine Sortierung nach Anfahrtszeit.
companyDisplayNames[]

string

In diesem Filter wird die genaue Unternehmens-Company.display_name der zu suchenden Jobs angegeben.

Wird kein Wert angegeben, können die Suchergebnisse Jobs in beliebigen Unternehmen enthalten.

Wenn mehrere Werte angegeben sind, können die Suchergebnisse zu einem beliebigen der angegebenen Unternehmen gehören.

Es sind maximal 20 Filter für Anzeigenamen von Unternehmen zulässig.
compensationFilter

object (CompensationFilter)

Dieser Suchfilter wird nur auf Job.compensation_info angewendet. Wenn der Filter beispielsweise als "Job auf Stundenbasis mit einem Stundensatz > 15 $" angegeben ist, wird nur nach Jobs gesucht, die diese Kriterien erfüllen. Ist kein Filter definiert, werden alle offenen Jobs durchsucht.
customAttributeFilter

string

Dieser Filter gibt eine strukturierte Syntax für den Abgleich mit dem Job.custom_attributes an, der als filterable gekennzeichnet ist.

Die Syntax für diesen Ausdruck ist Teil der SQL-Syntax.

Unterstützte Operatoren sind: =, !=, <, <=, > und >=, wobei die linke Seite des Operators ein benutzerdefinierter Feldschlüssel und die rechte Seite eine Zahl oder ein String in Anführungszeichen ist. Sie müssen den umgekehrten Schrägstrich (\) und Anführungszeichen (") verwenden.

Unterstützte Funktionen sind LOWER([field_name]), um eine Übereinstimmung ohne Beachtung der Groß-/Kleinschreibung durchzuführen, und EMPTY([field_name]), um nach dem Vorhandensein eines Schlüssels zu filtern.

Boolesche Ausdrücke (AND/OR/NOT) werden bis zu einer Verschachtelung von drei Ebenen unterstützt, zum Beispiel "((A AND B AND C) OR NOT D) AND E"). Dabei darf der Ausdruck maximal 100 Vergleiche/Funktionen enthalten. Die Länge des Ausdrucks muss kleiner als 6.000 Byte sein.

Beispielabfrage: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10
disableSpellCheck

boolean

Mit diesem Flag wird die Rechtschreibprüfung gesteuert. Wenn es auf "false" gesetzt ist, versucht der Dienst, falsch geschriebene Abfragen zu korrigieren. Beispielsweise wird dann "Ingenier" in "Ingenieur" geändert.

Die Standardeinstellung ist "false". Es wird also eine Rechtschreibprüfung durchgeführt.
employmentTypes[]

enum (EmploymentType)

Der Filter für Beschäftigungstypen gibt die Beschäftigungsart der zu durchsuchenden Jobs an, z. B. EmploymentType.FULL_TIME.

Wenn kein Wert angegeben wird, enthalten Jobs in den Suchergebnissen alle Beschäftigungstypen.

Sind mehrere Werte angegeben, weisen die Jobs in den Suchergebnissen einen der angegebenen Beschäftigungstypen auf.
languageCodes[]

string

In diesem Filter wird die Sprache der zu suchenden Jobs angegeben, z. B. "en-US".

Ist kein Wert angegeben, können die Suchergebnisse Jobs in einer beliebigen Sprache enthalten.

Sprachcodes müssen im BCP-47-Format angegeben werden, z. B. "en-US" oder "sr-Latn". Weitere Informationen finden Sie unter Tags zur Identifizierung von Sprachen.

Es sind höchstens zehn Sprachcodefilter zulässig.
publishTimeRange

object (TimestampRange)

Es wird nach Jobs gesucht, die in einem durch diesen Filter angegebenen Bereich veröffentlicht wurden.
excludedJobs[]

string

Dieser Filter gibt eine Liste von Jobnamen an, die während der Suche ausgeschlossen werden sollen.

Es sind maximal 400 ausgeschlossene Jobnamen zulässig.

LocationFilter

Geografische Region der Suche.

JSON-Darstellung 
{
  "address": string,
  "regionCode": string,
  "latLng": {
    object (LatLng)
  },
  "distanceInMiles": number,
  "telecommutePreference": enum (TelecommutePreference),
  "negated": boolean
}
Felder
address

string

Der Name der Adressangabe, z. B. "Mountain View" oder "Bay Area".
regionCode

string

CLDR-Regionscode des Landes bzw. der Region der Adresse. Hiermit wird die Mehrdeutigkeit des vom Nutzer eingegebenen Ortes behandelt, z. B. "Liverpool" und "Liverpool, NY, US" oder "Liverpool, UK".

Legen Sie dieses Feld fest, um die Standortauflösung auf ein bestimmtes Land oder Gebiet auszurichten. Wenn dieses Feld nicht festgelegt ist, bezieht sich das Anwendungsverhalten standardmäßig auf die USA.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz. Dieser Filter gilt nicht für Suchanfragen in Bezug auf die Profilsuche.
latLng

object (LatLng)

Breiten- und Längengrad des geografischen Mittelpunkts, von dem aus gesucht werden soll. Dieses Feld wird ignoriert, wenn address angegeben ist.
distanceInMiles

number

distanceInMiles wird angewendet, wenn der gesuchte Ort als Stadt oder kleinere Ortschaft erkannt wird. Dieses Feld wird ignoriert, wenn es sich bei dem gesuchten Standort um einen Bundesstaat oder eine größere Region handelt.
telecommutePreference

enum (TelecommutePreference)

Ermöglicht dem Client, Jobs ohne festgelegten Standort zurückzugeben, insbesondere Telearbeitsplätze (Telearbeitsplätze werden vom Dienst als spezieller Standort betrachtet. Job.posting_region gibt an, ob ein Job Telearbeit ermöglicht. Wenn dieses Feld auf TelecommutePreference.TELECOMMUTE_ALLOWED gesetzt ist, werden Telearbeitsplätze gesucht und address und latLng ignoriert. Wenn die Richtlinie nicht konfiguriert oder auf TelecommutePreference.TELECOMMUTE_EXCLUDED gesetzt ist, werden Telearbeitsplätze nicht gesucht.

Diesen Filter kann man allein verwenden, um ausschließlich nach Telearbeitsplätzen zu suchen, oder ihn mit einem anderen Standortfilter für eine Kombinationssuche verwenden, z. B. "Mountain View" oder "Telearbeitsplätze". Wenn diese Einstellung aber zusammen mit anderen Standortfiltern verwendet wird, werden Telearbeitsplätze in einer Suchantwort möglicherweise als weniger relevant als andere Jobs bewertet.

Dieses Feld wird nur für Jobsuchanfragen verwendet.
negated

boolean

Wird Negation auf den Filter angewendet, so werden Profile, die dem Filter entsprechen, ausgeschlossen.

Wird derzeit nur bei der Profilsuche unterstützt.

TelecommutePreference

Geben Sie an, ob Telearbeitsplätze eingeschlossen werden sollen.

Enums
TELECOMMUTE_PREFERENCE_UNSPECIFIED Standardwert, wenn die Telearbeitsvoreinstellung nicht angegeben ist.
TELECOMMUTE_EXCLUDED Ausschließen von Telearbeitsplätzen.
TELECOMMUTE_ALLOWED Telearbeitsplätze zulassen.

CommuteFilter

Parameter für die Suche in Abhängigkeit vom Arbeitsweg.

JSON-Darstellung 
{
  "commuteMethod": enum (CommuteMethod),
  "startCoordinates": {
    object (LatLng)
  },
  "travelDuration": string,
  "allowImpreciseAddresses": boolean,

  // Union field traffic_option can be only one of the following:
  "roadTraffic": enum (RoadTraffic),
  "departureTime": {
    object (TimeOfDay)
  }
  // End of list of possible types for union field traffic_option.
}
Felder
commuteMethod

enum (CommuteMethod)

Erforderlich. Die Beförderungsart, für die die Anfahrtszeit berechnet wird.
startCoordinates

object (LatLng)

Erforderlich. Der Breiten- und Längengrad des Ortes, ab dem die Anfahrtszeit berechnet werden soll.
travelDuration

string (Duration format)

Erforderlich. Die maximale Fahrtzeit in Sekunden. Der maximal zulässige Wert ist 3600s (eine Stunde). Das Format ist 123s.

Dauer in Sekunden mit bis zu neun Nachkommastellen und einem 's' an letzter Stelle. Beispiel: "3.5s".
allowImpreciseAddresses

boolean

Bei true werden auch Jobs ohne Straßenadresse zurückgegeben. Für Adressen auf Stadtebene wird das Stadtzentrum verwendet. Für Adressen auf Bundesstaats- und höherer Ebene wird ein Textabgleich verwendet. Ist der Wert für dieses Feld auf false gesetzt oder nicht angegeben, werden bei der Suche in Abhängigkeit vom Arbeitsweg nur Straßenadressen zurückgegeben.
Union-Feld traffic_option. Verkehrsfaktor, der bei der Suche in Abhängigkeit vom Arbeitsweg zu berücksichtigen ist. Für traffic_option ist nur einer der folgenden Werte zulässig:
roadTraffic

enum (RoadTraffic)

Gibt die Verkehrsdichte an, die für die Berechnung der Anfahrtszeit verwendet werden soll.
departureTime

object (TimeOfDay)

Die zur Berechnung der Auswirkungen durch das Verkehrsaufkommen verwendete Startzeit, angegeben als google.type.TimeOfDay in der lokalen Zeitzone.

Derzeit ist das Verkehrsmodell auf die Auflösung auf Stundenebene beschränkt.

CommuteMethod

Beförderungsart für den Arbeitsweg.

Enums
COMMUTE_METHOD_UNSPECIFIED Die Anfahrtsmethode ist nicht angegeben.
DRIVING Die Zeit für den Arbeitsweg wird auf Grundlage der Fahrzeit berechnet.
TRANSIT Die Zeit für den Arbeitsweg wird basierend auf den öffentlichen Verkehrsmitteln wie Bus, U-Bahn und U-Bahn berechnet.
WALKING Die Zeit für den Arbeitsweg wird auf Grundlage der Gehzeit berechnet.
CYCLING Die Zeit für den Arbeitsweg wird auf Grundlage der Zeit mit dem Fahrrad berechnet.

RoadTraffic

Die zur Berechnung der Anfahrtszeit verwendete Verkehrsdichte.

Enums
ROAD_TRAFFIC_UNSPECIFIED Die Straßenverkehrssituation ist nicht angegeben.
TRAFFIC_FREE Optimale Anfahrtszeit ohne Berücksichtigung des Verkehrsaufkommens.
BUSY_HOUR Bei der Berechnung der Anfahrtszeit werden die Verkehrsspitzen berücksichtigt.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.
seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen.

CompensationFilter

Nach Art und Betrag der Vergütung für den Job filtern.

JSON-Darstellung 
{
  "type": enum (FilterType),
  "units": [
    enum (CompensationUnit)
  ],
  "range": {
    object (CompensationRange)
  },
  "includeJobsWithUnspecifiedCompensationRange": boolean
}
Felder
type

enum (FilterType)

Erforderlich. Typ des Filters.
units[]

enum (CompensationUnit)

Erforderlich. Geben Sie die gewünschte base compensation entry's-CompensationInfo.CompensationUnit an.
range

object (CompensationRange)

Vergütungsbereich
includeJobsWithUnspecifiedCompensationRange

boolean

Wenn dieser Wert auf „true“ gesetzt ist, werden Jobs mit nicht angegebenen Feldern für den Vergütungsbereich eingeschlossen.

FilterType

Legt den Filtertyp fest.

Enums
FILTER_TYPE_UNSPECIFIED Filtertyp nicht angegeben. Als Platzhalter sollte niemals INVALID verwendet werden.
UNIT_ONLY

Nach base compensation entry's Einheit filtern. Für einen Job ergibt sich nur dann eine Übereinstimmung, wenn er einen Grundvergütungseintrag hat und die Einheit des Grundvergütungseintrags mit dem angegebenen units übereinstimmt. Füllen Sie ein oder mehrere units aus.

Die Definition des Grundvergütungseintrags finden Sie unter CompensationInfo.CompensationEntry.
UNIT_AND_AMOUNT

Nach base compensation entry's-Einheit und Betrag / Bereich filtern. Für einen Job ergibt sich nur dann eine Übereinstimmung, wenn er einen Grundvergütungseintrag hat, die Einheit des Grundvergütungseintrags dem angegebenen CompensationUnit entspricht und sich der Betrag oder die Spanne mit dem angegebenen CompensationRange überschneidet.

Die Definition des Grundvergütungseintrags finden Sie unter CompensationInfo.CompensationEntry.

Legen Sie genau ein units fest und füllen Sie range aus.
ANNUALIZED_BASE_AMOUNT

Nach jährlichem Grundvergütungsbetrag und base compensation entry's Einheit filtern. Geben Sie range und null oder mehr units ein.
ANNUALIZED_TOTAL_AMOUNT

Nach dem Yearisierten Gesamtvergütungsbetrag und base compensation entry's Einheit filtern . Geben Sie range und null oder mehr units ein.

TimestampRange

Nachricht, die einen Zeitraum zwischen zwei Zeitstempeln darstellt.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Beginn des Zeitraums (einschließlich).
endTime

string (Timestamp format)

Ende des Zeitraums (ausschließlich).