REST Resource: projects.jobs

Recurso: Job

Um recurso Job representa uma postagem de vagas de trabalho (também conhecida como "lista de empregos" ou "requisição de trabalho"). Uma vaga pertence a um Company, que é a entidade contratante responsável por ela.

Representação JSON 
{
  "name": string,
  "company": string,
  "requisitionId": string,
  "title": string,
  "description": string,
  "addresses": [
    string
  ],
  "applicationInfo": {
    object (ApplicationInfo)
  },
  "jobBenefits": [
    enum (JobBenefit)
  ],
  "compensationInfo": {
    object (CompensationInfo)
  },
  "customAttributes": {
    string: {
      object (CustomAttribute)
    },
    ...
  },
  "degreeTypes": [
    enum (DegreeType)
  ],
  "department": string,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "incentives": string,
  "languageCode": string,
  "jobLevel": enum (JobLevel),
  "promotionValue": integer,
  "qualifications": string,
  "responsibilities": string,
  "postingRegion": enum (PostingRegion),
  "visibility": enum (Visibility),
  "jobStartTime": string,
  "jobEndTime": string,
  "postingPublishTime": string,
  "postingExpireTime": string,
  "postingCreateTime": string,
  "postingUpdateTime": string,
  "companyDisplayName": string,
  "derivedInfo": {
    object (DerivedInfo)
  },
  "processingOptions": {
    object (ProcessingOptions)
  }
}
Campos
name

string

Necessário durante a atualização da vaga.

O nome do recurso para a vaga. É gerado pelo serviço quando uma vaga é criada.

O formato é "projects/{projectId}/tenants/{tenantId}/jobs/{job_id}". Por exemplo, "projects/foo/tenants/bar/jobs/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/jobs/bar".

O uso deste campo em consultas de job e chamadas de API tem preferência sobre o uso de requisitionId porque esse valor é exclusivo.
company

string

Obrigatório. O nome de recurso da empresa que anuncia a vaga.

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".
requisitionId

string

Obrigatório. O código da requisição, também conhecido como código de postagem, atribuído pelo cliente para identificar uma vaga. Este campo é destinado à identificação do cliente e ao rastreamento de postagens pelos clientes. Não será possível criar um job se houver outro com os mesmos company, languageCode e requisitionId.

O número máximo de caracteres permitido é 255.
title

string

Obrigatório. O título do cargo, como “Engenheiro de software”.

O número máximo de caracteres permitidos é 500.
description

string

Obrigatório. A descrição da vaga, que normalmente inclui uma descrição de vários parágrafos sobre a empresa e informações relacionadas. São fornecidos campos separados no objeto de vaga para responsibilities, qualifications e outras características. É recomendado o uso desses campos separados.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 100.000.
addresses[]

string

É altamente recomendado para melhorar a experiência de atendimento.

Locais em que o empregador está buscando contratar para a vaga.

A especificação do endereço completo do local de contratação permite melhores resultados de API, especialmente pesquisas de vagas por tempo de deslocamento.

No máximo, 50 locais são permitidos para melhor desempenho de pesquisa. Se um job tiver mais locais, é recomendável dividi-lo em vários com requisitionIds exclusivos (por exemplo, "ReqA" se torna "ReqA-1", "ReqA-2" e assim por diante), já que não são permitidos vários jobs com os mesmos company, languageCode e requisitionId. Se o requisitionId original precisar ser preservado, use um campo personalizado para armazenamento. Também é sugerido agrupar os locais próximos uns dos outros na mesma vaga para uma melhor experiência de pesquisa.

O número máximo de caracteres permitidos é 500.
applicationInfo

object (ApplicationInfo)

Informações de candidatura à vaga.
jobBenefits[]

enum (JobBenefit)

Os benefícios incluídos na vaga.
compensationInfo

object (CompensationInfo)

Informações de remuneração do trabalho (também conhecida como "taxa de pagamento"), ou seja, a remuneração que será paga ao funcionário.
customAttributes

map (key: string, value: object (CustomAttribute))

Um mapa de campos para manter atributos de vaga personalizados filtráveis e não filtráveis não cobertos pelos campos estruturados fornecidos.

As chaves do mapa são strings de até 64 bytes e precisam corresponder ao padrão: [a-zA-Z][a-zA-Z0-9_]*. Por exemplo, chave0DestaForma ou CHAVE_1_DESTA_FORMA.

No máximo, 100 chaves filtráveis e 100 não filtráveis são compatíveis. Para stringValues filtrável, em todas as chaves são permitidos no máximo 200 valores, com cada string com até 255 caracteres. Para stringValues não filtrável, o tamanho total máximo de stringValues em todas as chaves é de 50 KB.
degreeTypes[]

enum (DegreeType)

Os níveis de escolaridade desejados para o cargo, como Bacharelado e Mestrado.
department

string

O departamento ou a área funcional dentro da empresa com a vaga em aberto.

O número máximo de caracteres permitido é 255.
employmentTypes[]

enum (EmploymentType)

Os tipos de emprego de uma vaga, por exemplo, full time ou part time.
incentives

string

Uma descrição de bônus, comissões e outros incentivos de remuneração associados ao cargo que não sejam o salário ou pagamento.

O número máximo de caracteres permitidos é 10.000.
languageCode

string

O idioma da postagem. Este campo é diferente de qualquer requisito de fluência associado ao cargo.

Os códigos de idioma precisam estar no formato BCP-47, como “pt-BR” ou “en-US”. Para mais informações, consulte Tags para identificar idiomas{: class="external" target="_blank" } (em inglês).

Se esse campo não for especificado e Job.description estiver presente, o código do idioma detectado com base em Job.description será atribuído. Caso contrário, o padrão será "en_US".
jobLevel

enum (JobLevel)

O nível de experiência associado à vaga, como “Nível básico”.
promotionValue

integer

Um valor de promoção da vaga de emprego, conforme determinado pelo cliente. O valor determina a ordem de classificação das vagas retornadas na pesquisa usando a chamada de vagas em destaque, com os valores promocionais mais elevados sendo retornados primeiro e os empates sendo resolvidos por ordem de relevância. Somente as vagas com promotionValue > 0 são retornadas na FEATURED_JOB_SEARCH.

O valor padrão é 0, e os valores negativos são tratados como 0.
qualifications

string

Uma descrição das qualificações necessárias para realizar o trabalho. É recomendável usar este campo como alternativa ao campo description, que é mais geral.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 10.000.
responsibilities

string

Uma descrição das responsabilidades do cargo. É recomendável usar este campo como alternativa ao campo description, que é mais geral.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 10.000.
postingRegion

enum (PostingRegion)

A PostingRegion da vaga (por exemplo, estado ou país) em que a vaga está disponível. Se este campo estiver definido, um LocationFilter em uma consulta de pesquisa na região da vaga encontrará essa vaga se o local exato não estiver especificado. Se este campo for definido como PostingRegion.NATION ou PostingRegion.ADMINISTRATIVE_AREA, é recomendável configurar a vaga Job.addresses no mesmo nível de local deste campo.
visibility
(deprecated)

enum (Visibility)

Obsoleto. A tarefa é visível apenas para o proprietário.

A visibilidade da vaga.

Se nada for especificado, o padrão será Visibility.ACCOUNT_ONLY.
jobStartTime

string (Timestamp format)

O carimbo de data/hora de início da vaga no fuso horário UTC. Normalmente, este campo é usado para contratações. Carimbos de data/hora inválidos são ignorados.
jobEndTime

string (Timestamp format)

O carimbo de data/hora da vaga. Normalmente, este campo é usado para contratações. Carimbos de data/hora inválidos são ignorados.
postingPublishTime

string (Timestamp format)

O carimbo de data/hora da publicação mais recente da vaga. O valor padrão é o tempo que a solicitação leva para chegar ao servidor. Carimbos de data/hora inválidos são ignorados.
postingExpireTime

string (Timestamp format)

É altamente recomendado para melhorar a experiência de atendimento.

O carimbo de data/hora de expiração da vaga. Após esse carimbo de data/hora, a vaga é marcada como expirada e deixa de ser exibida nos resultados da pesquisa. O job expirado não pode ser listado pela API jobs.list, mas pode ser recuperado com a API jobs.get, atualizado com a API jobs.patch ou excluído com a API jobs.delete. Uma vaga expirada pode ser atualizada e aberta novamente usando um carimbo de data/hora de expiração futuro. A atualização de um job expirado falhará se houver outro job aberto com os mesmos company, languageCode e requisitionId.

As vagas expiradas são mantidas no sistema por 90 dias. No entanto, a contagem geral de vagas expiradas não pode exceder três vezes o número máximo de vagas em aberto nos últimos sete dias. Se esse limite for excedido, os jobs expirados serão limpos na ordem de data de expiração mais próxima. As vagas expiradas deixarão de ser acessíveis depois de serem apagadas.

Carimbos de data/hora inválidos são ignorados e tratados como se o prazo de validade não fosse fornecido.

Se o carimbo de data/hora for anterior à solicitação instantânea, o job será tratado como expirado imediatamente na criação. Não é possível atualizar esse tipo de job. Ao criar um job com carimbo de data/hora no passado, o postingPublishTime precisa ser definido antes de postingExpireTime. O objetivo desse recurso é permitir que outros objetos, como Application, indiquem um job que não existia no sistema antes de expirar. Se você quiser modificar uma tarefa que expirou na criação, exclua-a e crie uma nova.

Se esse valor não for fornecido na criação da vaga ou for inválido, a postagem expirará em 30 dias contados a partir do horário de criação dela. Por exemplo, se a vaga foi criada em 01/01/2017 às 13h UTC com data de validade não especificada, ela expirará após as 13h UTC de 31/01/2017.

Se esse valor não for fornecido na atualização da vaga, ele dependerá das máscaras de campo definidas por UpdateJobRequest.update_mask. Se as máscaras de campo incluírem jobEndTime ou estiverem vazias, o que significa que todos os campos serão atualizados, a oferta de emprego vai expirar 30 dias após o horário da última atualização. Do contrário, a data de expiração não será atualizada.
postingCreateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que a vaga foi criada.
postingUpdateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que a vaga foi atualizada pela última vez.
companyDisplayName

string

Apenas saída. O nome da empresa que oferece a vaga.
derivedInfo

object (DerivedInfo)

Apenas saída. Detalhes derivados sobre a vaga.
processingOptions

object (ProcessingOptions)

Opções para processamento de vagas.

ApplicationInfo

Detalhes da candidatura à vaga.

Representação JSON 
{
  "emails": [
    string
  ],
  "instruction": string,
  "uris": [
    string
  ]
}
Campos
emails[]

string

Use este campo para especificar os endereços de e-mail que receberão currículos ou inscrições.

O número máximo de caracteres permitidos para cada entrada é 255.
instruction

string

Use este campo para fornecer instruções, como "Envie sua inscrição por e-mail para...", que um candidato pode seguir para se candidatar à vaga.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitido é 3.000.
uris[]

string

Use este campo de URI para direcionar um candidato para um site. Por exemplo, para acessar um formulário de inscrição on-line.

O número máximo de caracteres permitidos para cada entrada é 2.000.

JobBenefit

Um enum que representa os benefícios incluídos no cargo para os funcionários.

Tipos enumerados
JOB_BENEFIT_UNSPECIFIED Valor padrão caso o tipo não seja especificado.
CHILD_CARE O cargo inclui acesso a programas de assistência infantil, como creche.
DENTAL O cargo inclui serviços odontológicos cobertos por um plano de assistência odontológica.
DOMESTIC_PARTNER O cargo oferece benefícios específicos para companheiros(as).
FLEXIBLE_HOURS O cargo permite horário de trabalho flexível.
MEDICAL O cargo inclui serviços médicos cobertos por um plano de assistência médica.
LIFE_INSURANCE O cargo inclui um seguro de vida fornecido pelo empregador ou disponível para compra pelo funcionário.
PARENTAL_LEAVE O cargo permite licença para cuidar de filho recém-nascido.
RETIREMENT_PLAN O cargo inclui um plano de aposentadoria fornecido pelo empregador ou disponível para compra pelo funcionário.
SICK_DAYS O cargo permite licença remunerada por motivo de doença.
VACATION O cargo inclui férias remuneradas.
VISION O cargo inclui serviços oftalmológicos cobertos por um plano de assistência oftalmológica.

CompensationInfo

Detalhes da remuneração da vaga.

Representação JSON 
{
  "entries": [
    {
      object (CompensationEntry)
    }
  ],
  "annualizedBaseCompensationRange": {
    object (CompensationRange)
  },
  "annualizedTotalCompensationRange": {
    object (CompensationRange)
  }
}
Campos
entries[]

object (CompensationEntry)

Informações sobre remuneração da vaga.

No máximo, uma entrada pode ser do tipo CompensationInfo.CompensationType.BASE, que é conhecido como entrada de remuneração base da vaga.
annualizedBaseCompensationRange

object (CompensationRange)

Apenas saída. Faixa de remuneração com base anual. Calculada como CompensationEntry.amount da entrada de remuneração base vezes CompensationEntry.expected_units_per_year.

Consulte CompensationEntry para ver uma explicação sobre anualização de remuneração.
annualizedTotalCompensationRange

object (CompensationRange)

Apenas saída. Faixa de remuneração total anual. Calculada como CompensationEntry.amount vezes CompensationEntry.expected_units_per_year de todas as entradas de remuneração.

Consulte CompensationEntry para ver uma explicação sobre anualização de remuneração.

CompensationEntry

Uma entrada de remuneração que representa um componente de remuneração, como pagamento base, bônus ou outro tipo.

Anualização: uma entrada de remuneração pode ser anual se contiver amount ou range válidos. – e o expectedUnitsPerYear dele está definido ou pode ser derivado. O intervalo anual é determinado como (amount ou range) vezes expectedUnitsPerYear.

Representação JSON 
{
  "type": enum (CompensationType),
  "unit": enum (CompensationUnit),
  "description": string,
  "expectedUnitsPerYear": number,

  // Union field compensation_amount can be only one of the following:
  "amount": {
    object (Money)
  },
  "range": {
    object (CompensationRange)
  }
  // End of list of possible types for union field compensation_amount.
}
Campos
type

enum (CompensationType)

Tipo de remuneração.

O padrão é CompensationType.COMPENSATION_TYPE_UNSPECIFIED.
unit

enum (CompensationUnit)

Frequência do valor especificado.

O padrão é CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
description

string

Descrição da remuneração. Por exemplo, ela pode indicar termos patrimoniais ou fornecer contexto adicional para um bônus estimado.
expectedUnitsPerYear

number

Número esperado de unidades pagas a cada ano. Se não for especificado, quando Job.employment_types for FULLTIME, um valor padrão será inferido com base em unit. Valores padrão: “HOURLY: 2080”, “DAILY: 260”, “WEEKLY: 52”, “MONTHLY: 12” e “ANNUAL: 1”.
Campo de união compensation_amount. Valor de remuneração. Pode ser um valor fixo ou um intervalo flutuante. compensation_amount só pode ser de um dos seguintes tipos:
amount

object (Money)

Valor de remuneração.
range

object (CompensationRange)

Intervalo de remuneração.

CompensationType

O tipo de remuneração.

Para valores de remuneração especificados em valores não monetários, descreva o esquema de remuneração no CompensationEntry.description.

Por exemplo, o formato de gorjeta é descrito em CompensationEntry.description (por exemplo, "espera-se de 15 a 20% de gorjetas com base na conta do cliente") e uma estimativa das gorjetas fornecidas no CompensationEntry.amount ou CompensationEntry.range (US$ 10 por hora).

Por exemplo, a equidade é descrita em CompensationEntry.description (por exemplo, "1% - 2% de participação de capital ao longo de 4 anos, um penhasco de 1 ano") e o valor estimado em CompensationEntry.amount ou CompensationEntry.range. Se nenhuma estimativa de valor for possível, as unidades serão CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED e esclarecidas no campo CompensationEntry.description.

Tipos enumerados
COMPENSATION_TYPE_UNSPECIFIED Valor padrão.
BASE Remuneração base: refere-se ao valor fixo de dinheiro pago a um funcionário por um empregador em troca do trabalho realizado. A remuneração base não inclui benefícios, bônus ou outras remunerações em potencial de um empregador.
BONUS Bônus.
SIGNING_BONUS Bônus pela assinatura do contrato.
EQUITY Patrimônio.
PROFIT_SHARING Divisão de lucros.
COMMISSIONS Comissão.
TIPS Gorjetas.
OTHER_COMPENSATION_TYPE Outro tipo de remuneração.

CompensationUnit

Frequência de pagamento.

Tipos enumerados
COMPENSATION_UNIT_UNSPECIFIED Valor padrão.
HOURLY Por hora.
DAILY Por dia.
WEEKLY Por semana.
MONTHLY Por mês.
YEARLY Por ano.
ONE_TIME Uma vez.
OTHER_COMPENSATION_UNIT Outras unidades de remuneração.

Money

Representa um montante em dinheiro com o respectivo tipo de moeda.

Representação JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

O código de moeda de três letras definido no ISO 4217.
units

string (int64 format)

As unidades inteiras do montante. Por exemplo, se currencyCode for "USD", 1 unidade equivale a um dólar americano.
nanos

integer

Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se units for positivo, nanos terá que ser positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos precisará ser negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

CompensationRange

Intervalo de remuneração.

Representação JSON 
{
  "maxCompensation": {
    object (Money)
  },
  "minCompensation": {
    object (Money)
  }
}
Campos
maxCompensation

object (Money)

O valor máximo de remuneração. Se deixado em branco, o valor será definido como o máximo de remuneração e o código da moeda será definido para corresponder ao currency code de minOffset.
minCompensation

object (Money)

O valor mínimo de remuneração. Se deixado em branco, o valor será definido como zero e o código da moeda será definido para corresponder ao currency code de maxOffset.

DegreeType

Nível de escolaridade definido na Classificação Internacional Normalizada da Educação (ISCED, na sigla em inglês).

Tipos enumerados
DEGREE_TYPE_UNSPECIFIED Valor padrão. Não representa nenhuma formação ou educação infantil. Mapeia para o código ISCED 0. Ex.: jardim de infância.
PRIMARY_EDUCATION Educação primária, normalmente a primeira etapa do ensino obrigatório. Código ISCED 1. Ex.: ensino fundamental I.
LOWER_SECONDARY_EDUCATION Educação secundária baixa. Primeiro estágio do ensino secundário após a educação primária. Normalmente, com um currículo baseado em matérias. Código ISCED 2. Ex.: ensino fundamental II.
UPPER_SECONDARY_EDUCATION Educação secundária média. Segunda e última fase da educação secundária, que prepara para o ensino superior e/ou fornece competências profissionais relevantes. Normalmente tem mais opções de matérias e fluxos. Código ISCED 3. Ex.: ensino médio.
ADULT_REMEDIAL_EDUCATION Educação pós-secundária não superior. Cursos que proporcionam experiências de aprendizagem baseadas na educação secundária e preparam para a entrada no mercado de trabalho e/ou ensino superior. O conteúdo é mais amplo que o da educação secundária, mas não tão complexo quanto no ensino superior. Código ISCED 4.
ASSOCIATES_OR_EQUIVALENT Graduação tecnológica ou equivalente. Cursos curtos de ensino superior normalmente baseados na prática, específicos para uma profissão. Preparam para a entrada no mercado de trabalho. Esses cursos também podem abrir caminho para outros cursos de educação superior. Código ISCED 5.
BACHELORS_OR_EQUIVALENT Bacharelado ou equivalente. Cursos destinados a fornecer conhecimentos, habilidades e competências acadêmicos e/ou profissionais médios conducentes a um primeiro diploma de nível superior ou qualificação equivalente. Código ISCED 6.
MASTERS_OR_EQUIVALENT Mestrado, especialização ou equivalente. Cursos concebidos para fornecer conhecimentos, habilidades e competências acadêmicos e/ou profissionais avançados conducentes a um segundo diploma de ensino superior ou qualificação equivalente. Código ISCED 7.
DOCTORAL_OR_EQUIVALENT Doutorado ou equivalente. Cursos destinados principalmente a uma qualificação avançada de pesquisa, normalmente concluindo com a entrega e defesa de uma dissertação substantiva de qualidade publicável baseada em uma pesquisa original. Código ISCED 8.

EmploymentType

Um enum que representa o tipo de emprego de uma vaga.

Tipos enumerados
EMPLOYMENT_TYPE_UNSPECIFIED O valor padrão caso o tipo de emprego não esteja especificado.
FULL_TIME Para ser considerado emprego de tempo integral, o cargo exige um determinado número de horas por semana, normalmente 40 horas ou mais.
PART_TIME O cargo exige menos horas por semana do que um emprego de tempo integral, normalmente menos de 40 horas.
CONTRACTOR O cargo é oferecido como uma função contratada, e não de empregado assalariado.
CONTRACT_TO_HIRE O cargo é oferecido como uma função contratada que será convertida em tempo integral no final do contrato. As vagas desse tipo também são retornadas pela pesquisa por EmploymentType.CONTRACTOR.
TEMPORARY O cargo é oferecido como uma oportunidade de emprego temporário, geralmente uma contratação por curto prazo.
INTERN O cargo é uma oportunidade com prazo fixo para estudantes ou candidatos no nível básico terem treinamento no local de trabalho. Muitas vezes é oferecido como um trabalho de férias.
VOLUNTEER O cargo é uma oportunidade de voluntariado, quando não há expectativa de remuneração pelos serviços prestados.
PER_DIEM O cargo exige que o funcionário trabalhe conforme a necessidade, com um horário flexível.
FLY_IN_FLY_OUT A vaga envolve empregar pessoas em áreas remotas e levá-las temporariamente ao local de trabalho, em vez de realocar os funcionários e suas famílias permanentemente.
OTHER_EMPLOYMENT_TYPE A vaga não se enquadra em nenhum dos outros tipos listados.

JobLevel

Um enum que representa o nível de experiência exigido para o cargo.

Tipos enumerados
JOB_LEVEL_UNSPECIFIED O valor padrão caso o nível não seja especificado.
ENTRY_LEVEL Colaboradores individuais no nível básico, normalmente com menos de dois anos de experiência em função semelhante. Inclui estagiários.
EXPERIENCED Colaboradores individuais experientes, normalmente com mais de 2 anos de experiência em função semelhante.
MANAGER Gerentes de nível básico a intermediário que são responsáveis por uma equipe.
DIRECTOR Gerentes de nível sênior que são responsáveis por equipes de gerentes.
EXECUTIVE Gerentes de nível executivo ou superior, incluindo cargos de diretoria.

PostingRegion

Um enum que representa a região da postagem de vagas de trabalho. Na maioria dos casos, não é preciso especificá-la. Se for fornecida uma região, as vagas estarão qualificadas para pesquisas na região especificada.

Tipos enumerados
POSTING_REGION_UNSPECIFIED Se a região não for especificada, a vaga só será retornada se corresponder a LocationFilter.
ADMINISTRATIVE_AREA

Além da correspondência exata com o local, a vaga será retornada quando LocationFilter na consulta de pesquisa estiver na mesma área político-administrativa que a vaga retornada. Por exemplo, se uma vaga ADMINISTRATIVE_AREA for postada em “CA, EUA”, ela será retornada se LocationFilter tiver “Mountain View”.

A área político-administrativa se refere à subdivisão administrativa superior de um país. Por exemplo, estado dos EUA, região da Itália, nação constituinte do Reino Unido e prefeitura do Japão.
NATION Além da correspondência com o local exato, a vaga será retornada quando LocationFilter na consulta de pesquisa for no mesmo país que essa vaga. Por exemplo, se uma vaga NATION_WIDE for postada em “EUA”, ela será retornada se LocationFilter tiver o valor “Mountain View”.
TELECOMMUTE O cargo permite que os funcionários trabalhem remotamente (à distância). Se os locais forem fornecidos com esse valor, a vaga será considerada como tendo um local, mas o trabalho remoto será permitido.

Questões de visibilidade

Obsoleto. Todos os recursos são visíveis apenas para o proprietário.

Um enum que representa quem tem acesso de visualização ao recurso.

Tipos enumerados
VISIBILITY_UNSPECIFIED Valor padrão.
ACCOUNT_ONLY O recurso é visível apenas para a conta do GCP proprietária.
SHARED_WITH_GOOGLE O recurso é visível para o proprietário e pode ficar visível para outros aplicativos e processos no Google.
SHARED_WITH_PUBLIC O recurso é visível para o proprietário e pode ficar visível para todos os outros clientes da API.

DerivedInfo

Detalhes derivados sobre a vaga.

Representação JSON 
{
  "locations": [
    {
      object (Location)
    }
  ],
  "jobCategories": [
    enum (JobCategory)
  ]
}
Campos
locations[]

object (Location)

Locais estruturados da vaga, resolvidos a partir de Job.addresses.

locations correspondem exatamente a Job.addresses, na mesma ordem.
jobCategories[]

enum (JobCategory)

Categorias de emprego derivadas de Job.title e Job.description.

JobCategory

Um enum representa a categorização ou o foco principal do papel específico. Este valor é diferente do setor associado a um papel, que está relacionado à categorização da empresa que lista a vaga de trabalho.

Enums
JOB_CATEGORY_UNSPECIFIED O valor padrão caso a categoria não seja especificada.
ACCOUNTING_AND_FINANCE Uma vaga na área de contabilidade e finanças, como contador.
ADMINISTRATIVE_AND_OFFICE Uma vaga na área administrativa, como assistente administrativo.
ADVERTISING_AND_MARKETING Uma vaga na área de publicidade e marketing, como gerente de marketing.
ANIMAL_CARE Uma vaga na área de cuidados com os animais, como veterinário.
ART_FASHION_AND_DESIGN Uma vaga na área de arte, moda ou design, como designer.
BUSINESS_OPERATIONS Uma vaga na área de operações comerciais, como gerente de operações comerciais.
CLEANING_AND_FACILITIES Uma vaga na área de limpeza e instalações, como faxineiro.
COMPUTER_AND_IT Uma vaga na área de informática e TI, como administrador de sistemas.
CONSTRUCTION Uma vaga na área de construção, como auxiliar geral.
CUSTOMER_SERVICE Uma vaga na área de atendimento ao cliente, como caixa.
EDUCATION Uma vaga na área de educação, como professor.
ENTERTAINMENT_AND_TRAVEL Uma vaga na área de entretenimento e viagens, como comissário de bordo.
FARMING_AND_OUTDOORS Uma vaga na área agrícola ou ao ar livre, como guarda florestal.
HEALTHCARE Uma vaga na área da saúde, como enfermeira.
HUMAN_RESOURCES Uma vaga na área de recursos humanos, como diretor de recursos humanos.
INSTALLATION_MAINTENANCE_AND_REPAIR Uma vaga na área de instalação, manutenção ou reparo, como eletricista.
LEGAL Uma vaga na área jurídica, como assistente jurídico.
MANAGEMENT Uma vaga na área de gerenciamento, usada normalmente em conjunto com outra categoria, como gerente de loja.
MANUFACTURING_AND_WAREHOUSE Uma vaga em fábrica ou depósito, como técnico de montagem.
MEDIA_COMMUNICATIONS_AND_WRITING Uma vaga na área de mídia, comunicação ou escrita, como relações com a mídia.
OIL_GAS_AND_MINING Uma vaga na área de petróleo, gás ou mineração, como sondador.
PERSONAL_CARE_AND_SERVICES Uma vaga na área de serviços e cuidados pessoais, como cabeleireiro.
PROTECTIVE_SERVICES Uma vaga na área de serviços de proteção, como vigilante.
REAL_ESTATE Uma vaga na área imobiliária, como corretor.
RESTAURANT_AND_HOSPITALITY Uma vaga em hotel ou restaurante, como garçom.
SALES_AND_RETAIL Uma vaga na área de vendas e/ou varejo, como representante de vendas.
SCIENCE_AND_ENGINEERING Uma vaga no setor de ciência e engenharia, como técnico de laboratório.
SOCIAL_SERVICES_AND_NON_PROFIT Uma vaga em serviço social ou em uma organização sem fins lucrativos, como assistente social.
SPORTS_FITNESS_AND_RECREATION Uma vaga na área de esportes, fitness ou recreação, como treinador pessoal.
TRANSPORTATION_AND_LOGISTICS Uma vaga na área de transporte ou logística, como motorista de caminhão.

ProcessingOptions

Opções para processamento de vagas.

Representação JSON 
{
  "disableStreetAddressResolution": boolean,
  "htmlSanitization": enum (HtmlSanitization)
}
Campos
disableStreetAddressResolution

boolean

Se definido como true, o serviço não tentará resolver um endereço mais preciso para a vaga.
htmlSanitization

enum (HtmlSanitization)

Opção para sanitização do conteúdo HTML da vaga. Aplica-se aos campos:

  • description
  • applicationInfo.instruction
  • incentives
  • qualifications
  • responsibilities

As tags HTML desses campos poderão ser removidas se a sanitização não estiver desativada.

O valor padrão é HtmlSanitization.SIMPLE_FORMATTING_ONLY.

HtmlSanitization

Opção para sanitização do conteúdo HTML nos campos preenchidos pelo usuário, como a descrição da vaga. Ao definir essa opção, o usuário pode determinar se e como a sanitização é executada nesses campos.

Enums
HTML_SANITIZATION_UNSPECIFIED Valor padrão.
HTML_SANITIZATION_DISABLED Desativa a sanitização na entrada HTML.
SIMPLE_FORMATTING_ONLY Realiza a sanitização da entrada HTML, só aceita negrito, itálico, lista ordenada e tags de marcação de lista não ordenada.

Métodos

batchCreate

 Começa a executar uma operação de criação de jobs em lote.

batchDelete

 Exclui uma lista de Jobs por filtro.

batchUpdate

 Começa a executar uma operação de jobs de atualização em lote.

create

 Cria uma nova vaga de trabalho.

delete

 Exclui a vaga especificada.

get

 Recupera a vaga especificada com status OPEN ou EXPIRED recente nos últimos 90 dias.

list

 Lista vagas por filtro.

patch

 Atualiza a vaga especificada.
Procura vagas usando o SearchJobsRequest fornecido.

searchForAlert

 Procura vagas usando o SearchJobsRequest fornecido.