jobQuery |
object (JobQuery)
Consulta usada para pesquisar vagas, como palavra-chave, filtros de local etc.
|
enableBroadening |
boolean
Controla se a pesquisa precisa ser ampliada quando produzir resultados escassos. Consultas ampliadas acrescentam resultados no final da lista de resultados correspondentes. O padrão é "false".
|
requirePreciseResultSize
(deprecated) |
boolean
O uso desse campo foi descontinuado.
|
histogramQueries[] |
object (HistogramQuery)
Uma expressão especifica uma solicitação de histograma para as vagas correspondentes. A sintaxe de expressão é uma chamada de função de agregação com atributos de histograma e outras opções. As chamadas de função de agregação disponíveis são: * count(string_histogram_facet): conta o número de entidades correspondentes para cada valor de atributo distinto. * count(numeric_histogram_facet, list of buckets): conta o número de entidades correspondentes em cada bucket. Tipos de dados:
- Atributo do histograma: nomes de atributo com formato [a-zA-Z][a-zA-Z0-9_]+.
- String: por exemplo, qualquer string com escape de barra invertida para aspas (").
- Número: número inteiro e número de ponto flutuante como 10, -1 e -0,01.
- Lista: lista de elementos com separador de vírgula (,) entre colchetes, por exemplo, [1, 2, 3] e ["um", "dois", "três"].
Constantes integradas:
- MIN (número mínimo semelhante a java Double.MIN_VALUE)
- MAX (número máximo semelhante a java Double.MAX_VALUE)
Funções integradas:
- bucket(start, end[, label]): essa função integrada cria um bucket com a faixa [start, end). Observe que o final é exclusivo, por exemplo, bucket(1, MAX, "positive number") ou bucket(1, 10).
Atributos do histograma de vaga:
- companyDisplayName: histograma por
Job.company_display_name.
- Employ_type: histograma por
Job.employment_types, por exemplo, "FULL_TIME", "PART_TIME".
- companySize: histograma por
CompanySize, por exemplo, "MENOR", "MEDIUM", "GRANDE".
- publish_time_in_month: histograma por
Job.posting_publish_time em meses. Precisa especificar a lista de buckets numéricos na especificação.
- publish_time_in_year: histograma por
Job.posting_publish_time em anos. Precisa especificar a lista de buckets numéricos na especificação.
- degreeTypes: histograma por
Job.degree_types, por exemplo, "Bacharelado", "Masters".
- jobLevel: histograma por
Job.job_level, por exemplo, "Nível básico".
- country: histograma por código de país das vagas, por exemplo, "US", "FR".
- admin1: histograma pelo código de vagas do admin1, que é um marcador global que se refere ao estado, à província ou ao termo que um país usa para definir a estrutura geográfica abaixo do nível do país, por exemplo, "CA", "IL".
- city: histograma por uma combinação de "nome da cidade, código admin1". Por exemplo, "Mountain View, CA", "New York, NY".
- admin1_country: histograma por uma combinação de "código admin1, país", por exemplo, "CA, US", "IL, US".
- city_coordinate: histograma por coordenadas de GPS do centro da cidade (latitude e longitude), por exemplo, 37.4038522,-122.0987765. Como as coordenadas do centro da cidade podem mudar, talvez os clientes precisem atualizá-las periodicamente.
- locale: histograma por
Job.language_code, por exemplo, "en-US", "fr-FR".
- language: histograma por subtag de idioma do
Job.language_code, por exemplo, "en", "fr".
- categoria: histograma por
JobCategory, por exemplo, "COMPUTER_AND_IT", "HEALTHCARE".
- base_offset_unit: histograma por
CompensationInfo.CompensationUnit do salário-base, por exemplo, "WEEKLY", "MONTH".
- base_compensation: histograma por salário base. É necessário especificar a lista de buckets numéricos para agrupar os resultados.
- anualized_base_compensation: histograma por salário base anual. Precisa especificar a lista de buckets numéricos para agrupar os resultados.
- anualized_total_compensation: histograma por total do salário anual. Precisa especificar a lista de buckets numéricos para agrupar os resultados.
- string_custom_attribute: histograma por string
Job.custom_attributes. Os valores podem ser acessados por meio de notação de colchetes, como string_custom_attribute["key1"].
- numeric_custom_attribute: histograma por
Job.custom_attributes numérico. Os valores podem ser acessados por meio da notação de colchetes, como numeric_custom_attribute["key1"]. É necessário especificar a lista de buckets numéricos para agrupar os resultados.
Exemplos de expressões:
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)
Os atributos desejados da vaga retornados para vagas na resposta da pesquisa. O padrão será JobView.JOB_VIEW_SMALL se nenhum valor for especificado.
|
offset |
integer
Um número inteiro que especifica o deslocamento atual (ou seja, o local do resultado inicial, dentre as vagas consideradas relevantes pela API) nos resultados da pesquisa. Este campo só é considerado se pageToken não estiver definido. O valor máximo permitido é 5000. Valores maiores geram erro. Por exemplo, 0 significa retornar resultados a partir da primeira vaga de emprego e 10 significa pesquisar a partir da 11ª vaga. Isso pode ser usado para paginação. Por exemplo, pageSize = 10 e offset = 10 significa pesquisar a partir da segunda página.
|
pageSize |
integer
Um limite no número de vagas de emprego retornadas nos resultados da pesquisa. Um valor acima do padrão de 10 pode aumentar o tempo de resposta da pesquisa. O valor pode estar entre 1 e 100.
|
pageToken |
string
O token que especifica o deslocamento atual nos resultados da pesquisa. Consulte SearchJobsResponse.next_page_token para saber como conseguir o próximo conjunto de resultados da consulta.
|
orderBy |
string
Os critérios que determinam como os resultados da pesquisa são classificados. O padrão é "relevance desc". As opções compatíveis são:
"relevance desc": por relevância em ordem decrescente, conforme determinado pelos algoritmos da API. O limite de relevância dos resultados da consulta só está disponível com essa ordem."postingPublishTime desc": por Job.posting_publish_time em ordem decrescente."postingUpdateTime desc": por Job.posting_update_time em ordem decrescente."title": por Job.title em ordem crescente."title desc": por Job.title em ordem decrescente."annualized_base_compensation": por CompensationInfo.annualized_base_compensation_range do job em ordem crescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa."annualized_base_compensation desc": por CompensationInfo.annualized_base_compensation_range do job em ordem decrescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa."annualized_total_compensation": por CompensationInfo.annualized_total_compensation_range do job em ordem crescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa."annualized_total_compensation desc": por CompensationInfo.annualized_total_compensation_range do job em ordem decrescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa."custom_ranking desc": pela pontuação de relevância ajustada para SearchJobsRequest.CustomRankingInfo.ranking_expression com o fator de ponderação atribuído por SearchJobsRequest.CustomRankingInfo.importance_level em ordem decrescente.- Classificação de local: use a sintaxe especial para ordenar tarefas por distância:
"distance_from('Hawaii')": ordenar por distância do Havaí.
"distance_from(19.89, 155.5)": ordenar pela distância de uma coordenada.
"distance_from('Hawaii'), distance_from('Puerto Rico')": ordenar por vários locais. Confira os detalhes a seguir.
"distance_from('Hawaii'), distance_from(19.89, 155.5)": ordenar por vários locais. Confira os detalhes a seguir.
A string pode ter no máximo 256 caracteres. Quando vários centros de distância são fornecidos, uma vaga próxima a qualquer um dos centros de distância tem uma classificação alta. Quando uma vaga tiver vários locais, será usado o local mais próximo de um dos centros de distância. As vagas sem locais serão classificadas na parte inferior. A distância é calculada com uma precisão de 11,3 metros. A estratégia de diversificação ainda será aplicada, a menos que seja explicitamente desativada em diversificationLevel.
|
diversificationLevel |
enum (DiversificationLevel)
Controla se as vagas altamente semelhantes são retornadas próximas umas das outras nos resultados da pesquisa. Elas são identificadas como altamente semelhantes com base nos cargos, categorias de trabalho e locais. Resultados altamente semelhantes são agrupados de modo que apenas uma vaga representativa do cluster é exibida para o candidato a emprego mais acima nos resultados, e as outras vagas são exibidas mais abaixo. O padrão será DiversificationLevel.SIMPLE se nenhum valor for especificado.
|
customRankingInfo |
object (CustomRankingInfo)
Controla como os documentos da vaga são classificados acima da pontuação de relevância atual (determinada pelo algoritmo da API).
|
disableKeywordMatch |
boolean
Controla se a correspondência exata de palavra-chave será desativada em Job.title, Job.description, Job.company_display_name, Job.addresses, Job.qualifications. Quando a correspondência de palavras-chave está desativada, uma correspondência de palavra-chave retorna vagas diferentes de determinados filtros de categoria quando há palavras-chave correspondentes. Por exemplo, para a consulta "gerente de programa", um resultado é retornado mesmo que a publicação da vaga tenha o título "desenvolvedor de software", que não se encaixa na ontologia "gerente de programa", mas tem "gerente de programa" na descrição. Para consultas como "cloud", que não contêm ontologia específica de título ou local, as vagas com correspondência da palavra-chave "cloud" são retornadas, independentemente do valor dessa sinalização. Use Company.keyword_searchable_job_custom_attributes se forem necessários valores de string de campo/atributo personalizados de correspondência global específicos da empresa. Ativar a correspondência de palavras-chave melhora os resultados das solicitações de pesquisa subsequentes. O padrão é "false".
|
