searchMode |
enum (SearchMode)
Modo de una búsqueda. La configuración predeterminada es SearchMode.JOB_SEARCH.
|
jobQuery |
object (JobQuery)
Consulta que se usa para buscar trabajos, como palabras clave, filtros de ubicación, etcétera.
|
enableBroadening |
boolean
Controla si se amplía la búsqueda cuando se generan resultados dispersos. Las consultas ampliadas agregan resultados al final de la lista de resultados que coinciden. La configuración predeterminada es "false".
|
requirePreciseResultSize
(deprecated) |
boolean
Este campo ya no está disponible.
|
histogramQueries[] |
object (HistogramQuery)
Una expresión especifica una solicitud de histograma para los trabajos coincidentes. La sintaxis de expresiones es una llamada a función de agregación con facetas de histograma y otras opciones. Las llamadas a funciones de agregación disponibles son las siguientes: * count(string_histogram_facet): Registra la cantidad de entidades coincidentes para cada valor de atributo distinto. * count(numeric_histogram_facet, list of buckets): Calcula la cantidad de entidades coincidentes dentro de cada bucket. Tipos de datos:
- Faceta de histograma: nombres de facetas con el formato [a-zA-Z][a-zA-Z0-9_]+.
- Cadena: string como "cualquier cadena con barra invertida escape para comillas(")."
- Número: un número entero y un número de punto flotante, como 10, -1 y -0,01.
- Lista: lista de elementos separados por coma(,) entre corchetes, por ejemplo, [1, 2, 3] y ["uno", "dos", "tres"].
Constantes integradas:
- MIN (número mínimo similar a Double.MIN_VALUE de Java)
- MAX (número máximo similar a Double.MAX_VALUE de Java)
Funciones integradas:
- bucket(inicio, fin[, etiqueta]): La función integrada de bucket crea un bucket con un rango de [inicio, fin). Ten en cuenta que el final es exclusivo, por ejemplo, bucket(1, MAX, “número positivo”) o bucket(1, 10).
Facetas de histogramas de trabajo:
- companyDisplayName: histograma por
Job.company_display_name
- employee_type: histograma por
Job.employment_types, por ejemplo, "FULL_TIME", "PART_TIME".
- companySize: histograma por
CompanySize, por ejemplo, “SMALL”, “MEDIUM”, “BIG”.
- publish_time_in_month: Histograma por
Job.posting_publish_time en meses. Se debe especificar la lista de buckets numéricos en la especificación.
- publish_time_in_year: Es un histograma por
Job.posting_publish_time en años. Se debe especificar la lista de buckets numéricos en la especificación.
- AssuredTypes: Histograma por el
Job.degree_types, por ejemplo, "Licenciatura", "Maestría".
- JobLevel: Histograma por
Job.job_level, por ejemplo, "Nivel inicial".
- country: Histograma por el código de país de los trabajos; por ejemplo, "US" o "FR".
- admin1: histograma según el código admin1 de trabajos, que es un marcador de posición global que hace referencia al estado, la provincia o el término específico que usa un país para definir la estructura geográfica debajo del nivel de país (por ejemplo, "CA" o "IL").
- city: histograma mediante una combinación del “nombre de la ciudad, código admin1” (City name, admin1 code). Por ejemplo, "Mountain View, CA", "Nueva York, NY".
- admin1_country: histograma mediante una combinación del "código admin1, país" (por ejemplo, "CA, EE.UU.", "IL, EE.UU.")
- city_Coordinate: Histograma por las coordenadas GPS (latitud y longitud) del centro de la ciudad; por ejemplo, 37.4038522,-122.0987765. Dado que las coordenadas del centro de una ciudad pueden cambiar, es posible que los clientes deban actualizarlas periódicamente.
- configuración regional: histograma según
Job.language_code, por ejemplo, "en-US" o "fr-FR"
- language: Histograma por la subetiqueta de idioma de
Job.language_code, por ejemplo, "en", "fr".
- categoría: histograma según
JobCategory, por ejemplo, "COMPUTER_AND_IT", "HEALTHCARE".
- base_amount_unit: Es un histograma por el
CompensationInfo.CompensationUnit del salario base, por ejemplo, "WEEKLY" o "MONTHLY".
- base_Reward: histograma según el salario base Se debe especificar la lista de buckets numéricos para agrupar los resultados.
- anualized_base_ separador: histograma según el salario base anualizado Se debe especificar la lista de buckets numéricos para agrupar los resultados.
- anualized_total_refund: histograma según el total del salario anualizado. Se debe especificar la lista de buckets numéricos para agrupar los resultados.
- atributo_personalizado_cadena: histograma por cadena
Job.custom_attributes Se puede acceder a los valores con notaciones de corchetes, como string_custom_attribute["key1"].
- Atributo numérico_personalizado: histograma por
Job.custom_attributes numérico Se puede acceder a los valores con notaciones de corchetes, como number_custom_attribute["key1"]. Se debe especificar la lista de buckets numéricos para agrupar los resultados.
Expresiones de ejemplo:
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)
Los atributos de trabajo deseados que se muestran para los trabajos en la respuesta de la búsqueda. El valor predeterminado es JobView.JOB_VIEW_SMALL si no se especifica ningún valor.
|
offset |
integer
Un número entero que especifica el desplazamiento actual (es decir, la ubicación inicial del resultado entre los trabajos que la API considera relevantes) en los resultados de la búsqueda. Este campo solo se considera si no estableces pageToken. El valor máximo permitido es 5,000. De lo contrario, se genera un error. Por ejemplo, 0 significa que se mostrarán resultados a partir del primer trabajo coincidente y 10 significa que se devolverá desde el 11.o trabajo. Esto se puede utilizar para la paginación (por ejemplo, pageSize = 10 y offset = 10 significa que se mostrarán desde la segunda página).
|
pageSize |
integer
Un límite para la cantidad de trabajos que se muestran en los resultados de la búsqueda. Aumentar este valor por sobre el valor predeterminado de 10, puede aumentar el tiempo de respuesta de la búsqueda. El valor puede ser de 1 a 100.
|
pageToken |
string
El token que especifica el desplazamiento actual dentro de los resultados de la búsqueda. Consulta SearchJobsResponse.next_page_token para ver una explicación sobre cómo obtener el siguiente conjunto de resultados de la consulta.
|
orderBy |
string
Los criterios que determinan cómo se ordenan los resultados de la búsqueda. El valor predeterminado es "relevance desc". Las opciones compatibles son las siguientes:
"relevance desc": por relevancia descendente, según lo determinan los algoritmos de la API El umbral de relevancia de los resultados de la búsqueda solo está disponible con este orden."postingPublishTime desc": Por Job.posting_publish_time en orden descendente."postingUpdateTime desc": Por Job.posting_update_time en orden descendente."title": Por Job.title en orden ascendente."title desc": Por Job.title en orden descendente."annualized_base_compensation": por el CompensationInfo.annualized_base_compensation_range del trabajo de menor a mayor. Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda."annualized_base_compensation desc": por el CompensationInfo.annualized_base_compensation_range del trabajo de mayor a menor Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda."annualized_total_compensation": por el CompensationInfo.annualized_total_compensation_range del trabajo de menor a mayor. Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda."annualized_total_compensation desc": por el CompensationInfo.annualized_total_compensation_range del trabajo de mayor a menor Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda."custom_ranking desc": Por la puntuación de relevancia ajustada al SearchJobsRequest.CustomRankingInfo.ranking_expression con el factor de peso asignado por SearchJobsRequest.CustomRankingInfo.importance_level en orden descendente.- Orden por ubicación: Usa la sintaxis especial para ordenar los trabajos por distancia.
"distance_from('Hawaii')": Ordena por distancia desde Hawái.
"distance_from(19.89, 155.5)": Ordena por distancia desde una coordenada.
"distance_from('Hawaii'), distance_from('Puerto Rico')": Ordena según varias ubicaciones. (consulte los detalles que aparecen a continuación).
"distance_from('Hawaii'), distance_from(19.89, 155.5)": Ordena según varias ubicaciones. (consulte los detalles que aparecen a continuación).
La cadena puede tener un máximo de 256 caracteres. Cuando se proporcionan varios centros de distancia, un trabajo que se encuentre cerca de cualquiera de los centros de distancia tendrá una clasificación alta. Cuando un trabajo tenga varias ubicaciones, se usará la más cercana a uno de los centros de distancia. Los empleos que no tengan ubicaciones se clasificarán en la parte inferior. La distancia se calcula con una precisión de 11.3 metros (37.4 pies). Se seguirá aplicando la estrategia de diversificación, a menos que se inhabilite explícitamente en diversificationLevel.
|
diversificationLevel |
enum (DiversificationLevel)
Controla si se muestran trabajos muy similares uno al lado del otro en los resultados de la búsqueda. Los empleos se identifican como muy similares en función de sus cargos, categorías de trabajo y ubicaciones. Los resultados muy similares se agrupan en clústeres para que solo un trabajo representativo del clúster se muestre al usuario en una posición superior en los resultados. Los otros trabajos se mostrarán más abajo en los resultados. El valor predeterminado es DiversificationLevel.SIMPLE si no se especifica ningún valor.
|
customRankingInfo |
object (CustomRankingInfo)
Controla cómo se clasifican los documentos de trabajo sobre la puntuación de relevancia existente (determinada por el algoritmo de la API).
|
disableKeywordMatch |
boolean
Controla si se inhabilita la concordancia exacta de palabras clave en Job.title, Job.description, Job.company_display_name, Job.addresses y Job.qualifications. Cuando se desactiva la opción Inhabilitar la concordancia de palabras clave, la concordancia de palabras clave muestra trabajos que no coinciden con los filtros de categorías determinados cuando haya palabras clave que coincidan. Por ejemplo, para la consulta "gerente de programas", se muestra un resultado incluso si la publicación de trabajo tiene el título "desarrollador de software", que no corresponde a la ontología de "administrador de programas", pero aparece "administrador de programas" en su descripción. Para consultas como “nube” que no contienen una ontología específica de título o ubicación, se muestran trabajos con coincidencias de palabras clave “nube”, sin importar el valor de esta marca. Usa Company.keyword_searchable_job_custom_attributes si se necesitan valores de string de atributos o campos personalizados específicos de la empresa que coincidan a nivel global. Habilitar la concordancia de palabras clave mejora la recuperación de solicitudes de búsqueda posteriores. La configuración predeterminada es "false".
|
