- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Procura vagas usando o SearchJobsRequest
fornecido.
Esta chamada de API destina-se ao caso de uso de segmentação de candidatos passivos. Por exemplo, candidatos que se inscreveram para receber alertas por e-mail sobre possíveis oportunidades de trabalho. Ela tem diferentes ajustes algorítmicos destinados a candidatos passivos.
Essa chamada restringe o visibility
das vagas presentes no banco de dados e retorna apenas as que o autor da chamada tem permissão para pesquisar.
Solicitação HTTP
POST https://jobs.googleapis.com/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O nome do recurso do locatário a ser pesquisado. O formato é "projects/{projectId}/tenants/{tenantId}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo". |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON | |
---|---|
{ "searchMode": enum ( |
Campos | |
---|---|
searchMode |
Modo de uma pesquisa. O valor padrão é |
requestMetadata |
Obrigatório. Metainformação coletada sobre o pesquisador de vagas e usada para melhorar a qualidade de pesquisa do serviço. Os identificadores (como |
jobQuery |
Consulta usada para pesquisar vagas, como palavra-chave, filtros de local etc. |
enableBroadening |
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 |
O uso desse campo foi descontinuado. |
histogramQueries[] |
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: * Tipos de dados:
Constantes integradas:
Funções integradas:
Atributos do histograma de vaga:
Exemplos de expressões:
|
jobView |
Os atributos desejados da vaga retornados para vagas na resposta da pesquisa. O padrão será |
offset |
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 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 |
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 |
O token que especifica o deslocamento atual nos resultados da pesquisa. Consulte |
orderBy |
Os critérios que determinam como os resultados da pesquisa são classificados. O padrão é As opções compatíveis são:
|
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á |
customRankingInfo |
Controla como os documentos da vaga são classificados acima da pontuação de relevância atual (determinada pelo algoritmo da API). |
disableKeywordMatch |
Controla se a correspondência exata de palavra-chave será desativada em 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 O padrão é "false". |
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de SearchJobsResponse
.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/jobs
https://www.googleapis.com/auth/cloud-platform
Para saber mais, consulte a Visão geral da autenticação.