Esta página foi traduzida pela API Cloud Translation.

JobQuery

Representação JSON
LocationFilter
- Representação JSON
TelecommutePreference
CommuteFilter
- Representação JSON
CommuteMethod
RoadTraffic
TimeOfDay
- Representação JSON
CompensationFilter
- Representação JSON
FilterType
TimestampRange
- Representação JSON

A consulta necessária para executar uma consulta de pesquisa.

Representação JSON

Representação 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 ] }

{
  "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` A string de consulta que corresponde aos campos de cargo, descrição e local da vaga. O número máximo de caracteres permitido é 255.
`queryLanguageCode`	`string` O código de idioma de `query`. Por exemplo, "en-US". Esse campo ajuda a interpretar melhor a consulta. Se um valor não for especificado, o código do idioma da consulta será detectado automaticamente, o que pode não ser preciso. O código de idioma precisa estar no formato BCP-47, como "pt-BR" ou "en-US". Para saber mais informações, consulte Tags para identificar idiomas.
`companies[]`	`string` Este filtro especifica as entidades de empresa para pesquisar. Se um valor não for especificado, as vagas serão pesquisadas em todas as empresas. Se muitos valores forem especificados, as vagas serão pesquisadas nas empresas informadas. O formato é "projects/{projectId}/tenants/{tenantId}/Companies/{company_id}". Por exemplo, "projects/foo/tenants/bar/Companies/baz". Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/empresas/bar". No máximo, 20 filtros de empresa são permitidos.
`locationFilters[]`	`object (LocationFilter)` O filtro de local especifica as regiões geográficas que contêm as vagas de emprego a pesquisar. Consulte `LocationFilter` para mais informações. Se nenhum valor de local for especificado, as vagas que atenderem a outros critérios de pesquisa serão recuperadas, seja qual for o local. Se vários valores forem especificados, as vagas serão recuperadas de qualquer um dos locais especificados. Se valores diferentes forem especificados para o parâmetro `LocationFilter.distance_in_miles`, a distância máxima fornecida será usada para todos os locais. No máximo, cinco filtros de local são permitidos.
`jobCategories[]`	`enum (JobCategory)` O filtro de categoria especifica as categorias de vagas a pesquisar. Consulte `JobCategory` para mais informações. Se um valor não for especificado, serão pesquisadas as vagas de qualquer categoria. Se muitos valores forem especificados, as vagas de qualquer categoria especificada serão pesquisadas.
`commuteFilter`	`object (CommuteFilter)` Permite filtrar vagas por tempo de deslocamento diário em meios de transporte diferentes. Por exemplo, de carro ou transporte público. Observação: isso só funciona quando você especifica um `CommuteMethod`. Nesse caso, `locationFilters` é ignorado. Por enquanto, não há como classificar por tempo de deslocamento diário.
`companyDisplayNames[]`	`string` Este filtro especifica a empresa exata `Company.display_name` das vagas a serem pesquisadas. Se um valor não for especificado, as vagas nos resultados da pesquisa serão associadas a qualquer empresa. Se vários valores forem especificados, as vagas nos resultados da pesquisa poderão ser associadas a qualquer uma das empresas especificadas. No máximo, 20 filtros de nome de exibição da empresa são permitidos.
`compensationFilter`	`object (CompensationFilter)` Este filtro de pesquisa é aplicado apenas a `Job.compensation_info`. Por exemplo, se o filtro for especificado como "Vaga com remuneração por hora > US$ 15", somente as vagas que atenderem a esses critérios serão pesquisadas. Se nenhum filtro for definido, todas as vagas abertas serão pesquisadas.
`customAttributeFilter`	`string` Este filtro especifica uma sintaxe estruturada para corresponder ao `Job.custom_attributes` marcado como `filterable`. A sintaxe dessa expressão é um subconjunto da sintaxe do SQL. Os operadores aceitos são: `=`, `!=`, `<`, `<=`, `>` e `>=`, em que o lado esquerdo do operador é uma chave de campo personalizado e o à direita é um número ou uma string entre aspas. É preciso escapar caracteres de barra invertida (\) e aspas ("). As funções com suporte são `LOWER([field_name])` para executar uma correspondência indiferente a maiúsculas e `EMPTY([field_name])` para filtrar a existência de uma chave. As expressões booleanas (AND/OR/NOT) são compatíveis com até três níveis de aninhamento. Por exemplo, "((A AND B AND C) OR NOT D) AND E"), e pode haver no máximo 100 comparações ou funções na expressão. A expressão precisa ter < 6.000 bytes. Exemplo de consulta: `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10`
`disableSpellCheck`	`boolean` Esta sinalização controla o recurso de verificação ortográfica. Caso seja falso, o serviço tenta corrigir uma consulta com erro ortográfico, por exemplo, "engenaria" é corrigida para "engenharia". Assume falso como padrão: uma verificação ortográfica é realizada.
`employmentTypes[]`	`enum (EmploymentType)` O filtro de tipo de emprego especifica o tipo de emprego das vagas a serem pesquisadas, como `EmploymentType.FULL_TIME`. Se um valor não for especificado, as vagas nos resultados da pesquisa incluirão qualquer tipo de emprego. Se vários valores forem especificados, as vagas nos resultados da pesquisa incluirão qualquer um dos tipos de emprego especificados.
`languageCodes[]`	`string` Este filtro especifica a localidade das vagas a serem pesquisadas. Por exemplo, "pt-BR". Se um valor não for especificado, os resultados da pesquisa poderão incluir vagas em qualquer localidade. Os códigos de idioma precisam estar no formato BCP-47. Por exemplo, “pt-BR” ou “en-US”. Para mais informações, consulte Tags para identificar idiomas. No máximo, dez filtros de código de idioma são permitidos.
`publishTimeRange`	`object (TimestampRange)` Serão pesquisadas as vagas publicadas dentro de um intervalo especificado por este filtro.
`excludedJobs[]`	`string` Este filtro especifica uma lista de nomes de vagas a serem excluídos durante a pesquisa. São permitidos no máximo 400 nomes de vagas excluídos.

LocationFilter

Região geográfica da pesquisa.

Representação JSON
{ "address": string, "regionCode": string, "latLng": { object (`LatLng`) }, "distanceInMiles": number, "telecommutePreference": enum (`TelecommutePreference`), "negated": boolean }

Campos
`address`	`string` O nome do endereço, como "Mountain View" ou "Bay Area".
`regionCode`	`string` Código regional CLDR do país/região do endereço. Ele é usado para resolver a ambiguidade do local inserido pelo usuário, por exemplo, "Liverpool" em relação a "Liverpool, NY, EUA" ou "Liverpool, Reino Unido". Defina este campo para influenciar a resolução de local de um país ou território específico. Se este campo não for definido, o comportamento do aplicativo será direcionado para os Estados Unidos por padrão. Para mais detalhes, acesse https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para Suíça. Esse filtro não se aplica a consultas relacionadas à pesquisa de perfis.
`latLng`	`object (LatLng)` A latitude e a longitude do centro geográfico a partir do qual pesquisar. Esse campo será ignorado se `address` for informado.
`distanceInMiles`	`number` O distanceInMiles é aplicado quando o local que está sendo pesquisado é identificado como uma cidade ou uma região menor. Este campo é ignorado se o local que está sendo pesquisado for um estado ou maior.
`telecommutePreference`	`enum (TelecommutePreference)` Permite que o cliente retorne vagas de emprego sem um local definido, especificamente vagas de trabalho à distância (o trabalho remoto é considerado pelo serviço um local especial). `Job.posting_region` indica se uma vaga permite trabalho remoto. Se este campo for definido como `TelecommutePreference.TELECOMMUTE_ALLOWED`, as vagas de trabalho remoto serão pesquisadas, e `address` e `latLng` serão ignorados. Se ela não for definida ou for definida como `TelecommutePreference.TELECOMMUTE_EXCLUDED`, as vagas de trabalho remoto não serão pesquisadas. Este filtro pode ser usado sozinho para pesquisar exclusivamente vagas de trabalho remoto ou pode ser combinado com outro filtro de local para procurar uma combinação de locais de vaga, como “Mountain View” ou “trabalho remoto”. No entanto, quando usado em combinação com outros filtros de local, as vagas de trabalho remoto poderão ser tratadas como menos relevantes do que outras vagas na resposta da pesquisa. Esse campo é usado apenas para solicitações de pesquisa de vagas.
`negated`	`boolean` Aplica negação ao filtro para que os perfis correspondentes a ele sejam excluídos. Atualmente aceito apenas na pesquisa de perfis.

TelecommutePreference

Especifique se você quer incluir vagas de trabalho remoto.

Tipos enumerados
`TELECOMMUTE_PREFERENCE_UNSPECIFIED`	Valor padrão se a preferência de trabalho remoto não for especificada.
`TELECOMMUTE_EXCLUDED`	Excluir vagas de trabalho remoto.
`TELECOMMUTE_ALLOWED`	Permitir vagas de trabalho remoto.

CommuteFilter

Parâmetros necessários para a pesquisa de deslocamento diário.

Representação JSON

Representação 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`. }

{
  "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)` Obrigatório. O método de transporte para o cálculo do tempo de deslocamento diário.
`startCoordinates`	`object (LatLng)` Obrigatório. A latitude e a longitude do local de onde o tempo de deslocamento diário será calculado.
`travelDuration`	`string (Duration format)` Obrigatório. O tempo máximo de viagem em segundos. O valor máximo permitido é `3600s` (uma hora). O formato é `123s`. Uma duração em segundos com até nove dígitos fracionários, encerrada por "`s`". Exemplo: `"3.5s"`.
`allowImpreciseAddresses`	`boolean` Se for `true`, as vagas sem endereços no nível da rua também poderão ser retornadas. No caso de endereços no nível da cidade, o centro da cidade é usado. Para endereços no nível do estado e mais imprecisos, é usada a correspondência de texto. Se este campo for definido como `false` ou não for especificado, somente trabalhos que incluam endereços no nível da rua serão retornados pela pesquisa de deslocamento diário.
Campo de união `traffic_option`. Fator de trânsito a ser considerado ao pesquisar por deslocamento diário. `traffic_option` só pode ser de um dos seguintes tipos:
`roadTraffic`	`enum (RoadTraffic)` Especifica a intensidade do trânsito a ser usada no cálculo do tempo de deslocamento diário.
`departureTime`	`object (TimeOfDay)` O horário de partida usado para calcular o impacto do trânsito, representado como `google.type.TimeOfDay` no fuso horário local. Atualmente, o modelo de trânsito é restrito à resolução no nível de hora.

CommuteMethod

Método de deslocamento diário.

Enums
`COMMUTE_METHOD_UNSPECIFIED`	O método de deslocamento diário não é especificado.
`DRIVING`	O tempo de deslocamento diário é calculado com base no tempo ao volante.
`TRANSIT`	O tempo de deslocamento diário é calculado com base no transporte público, incluindo ônibus, metrô, entre outros.
`WALKING`	O tempo de deslocamento diário é calculado com base no tempo de caminhada.
`CYCLING`	O tempo de deslocamento diário é calculado com base no tempo em bicicleta.

RoadTraffic

A densidade do tráfego a ser usada no cálculo do tempo de deslocamento diário.

Tipos enumerados
`ROAD_TRAFFIC_UNSPECIFIED`	A situação do trânsito não é especificada.
`TRAFFIC_FREE`	O deslocamento diário ideal sem considerar qualquer impacto no trânsito.
`BUSY_HOUR`	O cálculo do deslocamento diário considera o impacto máximo do trânsito.

TimeOfDay

Representa um horário do dia. A data e o fuso horário não são relevantes ou são especificados em outro lugar. Uma API pode permitir segundos bissextos. Os tipos relacionados são google.type.Date e google.protobuf.Timestamp.

Representação JSON
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer }

Campos
`hours`	`integer` Horas do dia no formato de 24 horas. Precisa ser de 0 a 23. Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
`minutes`	`integer` Minutos da hora do dia. Precisa ser de 0 a 59.
`seconds`	`integer` Segundos do minutos do horário. Normalmente precisa ser de 0 a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.
`nanos`	`integer` Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999.

CompensationFilter

Filtra por valor e tipo de remuneração da vaga.

Representação JSON
{ "type": enum (`FilterType`), "units": [ enum (`CompensationUnit`) ], "range": { object (`CompensationRange`) }, "includeJobsWithUnspecifiedCompensationRange": boolean }

Campos
`type`	`enum (FilterType)` Obrigatório. Tipo de filtro.
`units[]`	`enum (CompensationUnit)` Obrigatório. Especifique o `base compensation entry's` `CompensationInfo.CompensationUnit` desejado.
`range`	`object (CompensationRange)` Intervalo de remuneração.
`includeJobsWithUnspecifiedCompensationRange`	`boolean` Se definido como verdadeiro, as vagas com campos de intervalo de remuneração não especificados serão incluídas.

FilterType

Especifique o tipo de filtragem.

Tipos enumerados
`FILTER_TYPE_UNSPECIFIED`	Tipo de filtro não especificado. Nunca use o titular da posição INVALID.
`UNIT_ONLY`	Filtrar por unidade de `base compensation entry's`. Será retornada uma correspondência somente se houver uma vaga que contém CompaniesEntry base e a unidade dela corresponde ao `units` informado. Preencha um ou mais `units`. Consulte `CompensationInfo.CompensationEntry` para ver a definição de entrada de remuneração base.
`UNIT_AND_AMOUNT`	Filtre por `base compensation entry's` unidade e quantidade / intervalo. Haverá correspondência de vaga somente se ela incluir CompaniesEntry base e a unidade da entrada base corresponder ao `CompensationUnit` fornecido, e o valor ou intervalo se sobrepuser ao `CompensationRange` fornecido. Consulte `CompensationInfo.CompensationEntry` para ver a definição de entrada de remuneração base. Defina exatamente um `units` e preencha `range`.
`ANNUALIZED_BASE_AMOUNT`	Filtre por valor de remuneração com base anual e unidade de `base compensation entry's`. Preencha `range` e zero ou mais `units`.
`ANNUALIZED_TOTAL_AMOUNT`	Filtre por valor de remuneração total anual e `base compensation entry's` unidade . Preencha `range` e zero ou mais `units`.

TimestampRange

Mensagem que representa um período entre dois carimbos de data/hora.

Representação JSON
{ "startTime": string, "endTime": string }

Campos

Campos
`startTime`	`string (Timestamp format)` Início do período (inclusivo).
`endTime`	`string (Timestamp format)` Fim do período (exclusivo).

startTime

string (Timestamp format)

Início do período (inclusivo).

endTime

string (Timestamp format)

Fim do período (exclusivo).