JobQuery

Es la consulta necesaria para realizar una búsqueda.

Representación JSON 
{
  "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
  ]
}
Campos
query

string

La cadena de consulta que coincide con los campos de título, descripción y ubicación del trabajo.

La cantidad máxima de caracteres permitida es 255.
queryLanguageCode

string

Es el código de idioma de query. Por ejemplo, “en-US”. Este campo ayuda a interpretar mejor la consulta.

Si no se especifica un valor, el código de idioma de la consulta se detecta automáticamente, lo que podría no ser preciso.

El código de idioma debe tener el formato BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Etiquetas para identificar idiomas.
companies[]

string

Este filtro especifica las entidades de empresa que se buscarán.

Si no se especifica un valor, se buscan trabajos de todas las empresas.

Si se especifican varios valores, se buscarán trabajos de las empresas especificadas.

El formato es “projects/{projectId}/tenants/{tenantId}/empresas/{company_id}”. Por ejemplo, “proyectos/foo/usuarios/bar/empresas/baz”.

Si no se especifica el ID de usuario, se usa el predeterminado. Por ejemplo, “proyectos/foo/empresas/bar”.

Se permiten 20 filtros de empresa como máximo.
locationFilters[]

object (LocationFilter)

El filtro de ubicación especifica las regiones geográficas que contienen los trabajos que se analizarán en la búsqueda. Consulta LocationFilter para obtener más información.

Si no se especifica un valor de ubicación, se recuperan los trabajos que coinciden con los demás criterios de búsqueda, sin importar dónde se encuentren.

Si se especifican varios valores, se recuperan trabajos de cualquiera de las ubicaciones especificadas. Si se especifican valores diferentes para el parámetro LocationFilter.distance_in_miles, se utilizará la distancia máxima proporcionada para todas las ubicaciones.

Se permiten 5 filtros de ubicación como máximo.
jobCategories[]

enum (JobCategory)

El filtro de categoría especifica las categorías de trabajos que se buscarán. Consulta JobCategory para obtener más información.

Si no se especifica un valor, se buscarán trabajos de cualquier categoría.

Si se especifican varios valores, se buscarán trabajos de cualquier categoría especificada.
commuteFilter

object (CommuteFilter)

Permite filtrar trabajos por tiempo de viaje de ida y vuelta con diferentes métodos de transporte (por ejemplo, en automóvil o en transporte público).

Nota: Esto solo funciona cuando especificas un CommuteMethod. En este caso, se ignora locationFilters.

Actualmente, no admitimos el orden por tiempo de traslado.
companyDisplayNames[]

string

Este filtro especifica la empresa exacta Company.display_name de los trabajos que se buscarán.

Si no se especifica un valor, los trabajos de los resultados de la búsqueda se asociarán con cualquier empresa.

Si se especifican varios valores, los resultados de la búsqueda pueden incluir trabajos asociados con cualquiera de las empresas especificadas.

Se permiten 20 filtros de nombre visible de la empresa como máximo.
compensationFilter

object (CompensationFilter)

Este filtro de búsqueda se aplica solo a Job.compensation_info. Por ejemplo, si el filtro se especifica como "Trabajo por hora con una remuneración por hora superior a $15", solo se buscarán trabajos que cumplan con estos criterios. Si no se define un filtro, se buscarán todos los trabajos disponibles.
customAttributeFilter

string

Este filtro especifica una sintaxis estructurada para que coincida con el Job.custom_attributes marcado como filterable.

La sintaxis para esta expresión es un subconjunto de la sintaxis de SQL.

Los operadores admitidos son =, !=, <, <=, > y >=. La izquierda del operador es una clave de campo personalizada y la derecha del operador es un número o una cadena entrecomillada. Se deben escapar los caracteres de barra inversa (\) y comillas (").

Las funciones admitidas son LOWER([field_name]) para realizar una coincidencia que no distingue mayúsculas de minúsculas y EMPTY([field_name]) para filtrar la existencia de una clave.

Las expresiones booleanas (AND/OR/NOT) se admiten hasta 3 niveles de anidación (por ejemplo, “(A AND B AND C) OR NOT D) AND E”), se permite un máximo de 100 comparaciones o funciones en la expresión. La expresión debe tener menos de 6,000 bytes de longitud.

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

boolean

Esta marca controla la característica del corrector ortográfico. Si es falso, el servicio intenta corregir las consultas con errores ortográficos. Por ejemplo, "ingenier" se corrige a "ingeniero".

La configuración predeterminada es "false": se realiza un corrector ortográfico.
employmentTypes[]

enum (EmploymentType)

El filtro de tipo de empleo especifica el tipo de los trabajos que se buscarán, como EmploymentType.FULL_TIME.

Si no se especifica un valor, los resultados de la búsqueda incluirán trabajos de cualquier tipo.

Si se especifican varios valores, los resultados de la búsqueda incluirán trabajos de cualquiera de los tipos especificados.
languageCodes[]

string

Este filtro especifica la configuración regional de los trabajos que se buscarán, como "en-US".

Si no se especifica un valor, los resultados de la búsqueda pueden contener trabajos de cualquier configuración regional.

Los códigos de idioma deben tener el formato BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Etiquetas para identificar idiomas.

Se permiten 10 filtros de código de idioma como máximo.
publishTimeRange

object (TimestampRange)

Se buscarán los trabajos publicados dentro de un rango especificado por este filtro.
excludedJobs[]

string

Este filtro especifica una lista de los nombres de los trabajos que se excluirán durante la búsqueda.

Se permiten 400 nombres de trabajos excluidos como máximo.

LocationFilter

Región geográfica de la búsqueda.

Representación JSON 
{
  "address": string,
  "regionCode": string,
  "latLng": {
    object (LatLng)
  },
  "distanceInMiles": number,
  "telecommutePreference": enum (TelecommutePreference),
  "negated": boolean
}
Campos
address

string

El nombre de la dirección, como "Mountain View" o "Bay Area".
regionCode

string

Código de región de CLDR para el país o la región de la dirección. Se utiliza para abordar la ambigüedad de la ubicación de entrada del usuario; por ejemplo, "Liverpool" con "Liverpool, NY, EE.UU." o "Liverpool, Reino Unido".

Establece este campo para personalizar la resolución de ubicación hacia un país o territorio específicos. Si no estableces este campo, el comportamiento de la aplicación se restringirá a Estados Unidos de forma predeterminada.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza. Ten en cuenta que este filtro no se aplica a las consultas relacionadas con la Búsqueda de perfiles.
latLng

object (LatLng)

La latitud y la longitud del centro geográfico que se utiliza para realizar la búsqueda. Este campo se ignora si se proporciona address.
distanceInMiles

number

El valor dedistanceInMiles se aplica cuando la ubicación que se busca se identifica como ciudad o más pequeña. Este campo se ignora si la ubicación que se busca es de un estado o superior.
telecommutePreference

enum (TelecommutePreference)

Permite que el cliente muestre trabajos que no tienen una ubicación establecida, específicamente, trabajos a distancia (el servicio considera este trabajo como una ubicación especial. Job.posting_region indica si un trabajo permite trabajar desde casa. Si estableces este campo como TelecommutePreference.TELECOMMUTE_ALLOWED, se buscarán trabajos a distancia y se ignorarán address y latLng. Si no la estableces o la estableces como TelecommutePreference.TELECOMMUTE_EXCLUDED, no se buscarán empleos desde casa.

Se puede usar este filtro por sí solo para buscar solo empleos que permitan trabajar desde casa. También se puede combinar con otro filtro de ubicación para buscar una combinación de ubicaciones de trabajo, como "Mountain View" o empleos que permitan "trabajar desde casa". Sin embargo, cuando se usa en conjunto con otros filtros de ubicación, se puede considerar los trabajos desde casa como menos relevantes que otros trabajos incluidos en la respuesta de la búsqueda.

Este campo solo se usa para solicitudes de búsqueda de trabajo.
negated

boolean

Establece si se debe aplicar la negación al filtro para que se excluyan los perfiles que coincidan con el filtro.

Actualmente, solo se admite en la búsqueda de perfiles.

TelecommutePreference

Especifica si quieres incluir trabajos desde casa.

Enums
TELECOMMUTE_PREFERENCE_UNSPECIFIED El valor predeterminado si no se especifica la preferencia de trabajo desde casa.
TELECOMMUTE_EXCLUDED Excluye los trabajos desde casa.
TELECOMMUTE_ALLOWED Permite trabajos desde casa.

CommuteFilter

Parámetros necesarios para la búsqueda según el traslado.

Representación JSON 
{
  "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.
}
Campos
commuteMethod

enum (CommuteMethod)

Obligatorio. Es el medio de transporte que se usará para calcular el tiempo de viaje diario.
startCoordinates

object (LatLng)

Obligatorio. La latitud y la longitud de la ubicación desde la que se calculará el tiempo de viaje diario.
travelDuration

string (Duration format)

Obligatorio. El tiempo de viaje máximo en segundos. El valor máximo permitido es 3600s (una hora). El formato es 123s.

Una duración en segundos con hasta nueve dígitos decimales, terminados en “s”. Ejemplo: "3.5s".
allowImpreciseAddresses

boolean

Si es true, es posible que también se muestren trabajos sin direcciones en el nivel de la calle. En el caso de las direcciones en la ciudad, se usa el centro de esta. En el caso de las direcciones estatales y a otros niveles menos específicos, se usa la coincidencia de texto. Si este campo se configura como false o no se especifica, las búsquedas de traslado solo mostrarán trabajos que incluyan direcciones a nivel de calle.
Campo de unión traffic_option. Factor del tráfico que se debe tener en cuenta cuando se busca por viaje diario. traffic_option puede ser solo uno de los siguientes:
roadTraffic

enum (RoadTraffic)

Especifica la densidad de tráfico que se usará para calcular el tiempo de viaje de ida y vuelta al trabajo.
departureTime

object (TimeOfDay)

La hora de salida que se usa para calcular el impacto del tráfico, representada como google.type.TimeOfDay en la zona horaria local.

Actualmente, el modelo de tráfico está restringido a la resolución a nivel de hora.

CommuteMethod

Medio de traslado.

Enums
COMMUTE_METHOD_UNSPECIFIED No se especificó el método de viaje diario.
DRIVING El tiempo de traslado se calcula según el tiempo de conducción.
TRANSIT El tiempo de viaje diario se calcula en función del transporte público, lo que incluye autobús, metro y otros.
WALKING El tiempo de viaje diario se calcula en función de la duración del viaje a pie.
CYCLING El tiempo de viaje diario se calcula según el tiempo en bicicleta.

RoadTraffic

La densidad de tráfico que se usará para calcular el tiempo de viaje de ida y vuelta al trabajo.

Enums
ROAD_TRAFFIC_UNSPECIFIED No se especificó la situación del tráfico en la ruta.
TRAFFIC_FREE Tiempo de traslado óptimo sin considerar el efecto del tráfico.
BUSY_HOUR El cálculo del tiempo de traslado considera el efecto del nivel máximo de tráfico.

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.
seconds

integer

Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999.

CompensationFilter

Filtro del importe y el tipo de remuneración del trabajo.

Representación JSON 
{
  "type": enum (FilterType),
  "units": [
    enum (CompensationUnit)
  ],
  "range": {
    object (CompensationRange)
  },
  "includeJobsWithUnspecifiedCompensationRange": boolean
}
Campos
type

enum (FilterType)

Obligatorio. Tipo de filtro.
units[]

enum (CompensationUnit)

Obligatorio. Especifica el CompensationInfo.CompensationUnit de las base compensation entry's deseadas.
range

object (CompensationRange)

Rango de remuneración
includeJobsWithUnspecifiedCompensationRange

boolean

Si se configura como verdadera, se incluirán los trabajos con campos de rango de remuneración sin especificar.

FilterType

Especifica el tipo de filtro.

Enums
FILTER_TYPE_UNSPECIFIED Tipo de filtro no especificado. El marcador de posición INVALID no se debe usar.
UNIT_ONLY

Filtrar por unidad de base compensation entry's. Un trabajo solo es una coincidencia si contiene una CompensationEntry base y su unidad coincide con units. Propaga uno o más units.

Consulta CompensationInfo.CompensationEntry para conocer la definición de la entrada de remuneración base.
UNIT_AND_AMOUNT

Filtra por unidad de base compensation entry's y por importe o rango. Un trabajo solo es una coincidencia si contiene una CompensationEntry base y la unidad de la entrada base coincide con los CompensationUnit proporcionados y el rango o la cantidad se superponen con la CompensationRange proporcionada.

Consulta CompensationInfo.CompensationEntry para conocer la definición de la entrada de remuneración base.

Configura exactamente un units y propaga range.
ANNUALIZED_BASE_AMOUNT

Filtrar por importe de remuneración base anualizado y unidad de base compensation entry's. Propaga range y cero o más units.
ANNUALIZED_TOTAL_AMOUNT

Filtra por el importe de remuneración total anualizado y la unidad de base compensation entry's . Propaga range y cero o más units.

TimestampRange

Mensaje que representa un período entre dos marcas de tiempo.

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Comienzo del período (inclusive)
endTime

string (Timestamp format)

Final del período (excluido).