Method: projects.jobs.searchForAlert

Busca trabajos con el SearchJobsRequest proporcionado.

Esta llamada a la API está diseñada para el caso de uso de segmentación de personas que buscan empleo pasivos (por ejemplo, personas que se registraron para recibir alertas por correo electrónico sobre posibles oportunidades de trabajo) y tiene diferentes ajustes algorítmicos que se orientan a quienes buscan trabajo pasivo.

Esta llamada restringe el visibility de los trabajos presentes en la base de datos y solo muestra los trabajos que el emisor tiene permiso para buscar.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El nombre del recurso del usuario en el que se buscará.

El formato es “projects/{projectId}/tenants/{tenantId}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

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

enum (SearchMode)

Modo de una búsqueda.

La configuración predeterminada es SearchMode.JOB_SEARCH.
requestMetadata

object (RequestMetadata)

Obligatorio. La metainformación recopilada sobre el usuario que busca empleo, que se usa para mejorar la calidad de las búsquedas del servicio. Los usuarios proporcionan los identificadores (como userId), que deben ser únicos y coherentes.
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".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SearchJobsResponse.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Descripción general de la autenticación.