Method: projects.jobs.patch

Atualiza a vaga especificada.

Normalmente, o conteúdo atualizado torna-se visível nos resultados da pesquisa em dez segundos, mas pode levar até cinco minutos.

Solicitação HTTP

PATCH https://jobs.googleapis.com/v4beta1/{job.name=projects/*/jobs/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
job.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.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "job": {
    "name": string,
    "company": string,
    "requisitionId": string,
    "title": string,
    "description": string,
    "addresses": [
      string
    ],
    "applicationInfo": {
      "emails": [
        string
      ],
      "instruction": string,
      "uris": [
        string
      ]
    },
    "jobBenefits": [
      enum (JobBenefit)
    ],
    "compensationInfo": {
      "entries": [
        {
          object (CompensationEntry)
        }
      ],
      "annualizedBaseCompensationRange": {
        object (CompensationRange)
      },
      "annualizedTotalCompensationRange": {
        object (CompensationRange)
      }
    },
    "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": {
      "seconds": string,
      "nanos": integer
    },
    "jobEndTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingPublishTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingExpireTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingCreateTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingUpdateTime": {
      "seconds": string,
      "nanos": integer
    },
    "companyDisplayName": string,
    "derivedInfo": {
      "locations": [
        {
          object (Location)
        }
      ],
      "jobCategories": [
        enum (JobCategory)
      ]
    },
    "processingOptions": {
      "disableStreetAddressResolution": boolean,
      "htmlSanitization": enum (HtmlSanitization)
    }
  },
  "updateMask": string
}
Campos
job.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".

job.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.

job.title

string

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

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

job.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.

job.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.

job.applicationInfo

object (ApplicationInfo)

Informações de candidatura à vaga.

job.jobBenefits[]

enum (JobBenefit)

Os benefícios incluídos na vaga.

job.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.

job.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.

job.degreeTypes[]

enum (DegreeType)

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

job.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.

job.employmentTypes[]

enum (EmploymentType)

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

job.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.

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

job.jobLevel

enum (JobLevel)

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

job.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.

job.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.

job.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.

job.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.

job.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.

job.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.

job.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.

job.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.

job.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.

job.postingCreateTime

string (Timestamp format)

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

job.postingUpdateTime

string (Timestamp format)

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

job.companyDisplayName

string

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

job.derivedInfo

object (DerivedInfo)

Apenas saída. Detalhes derivados sobre a vaga.

job.processingOptions

object (ProcessingOptions)

Opções para processamento de vagas.

updateMask

string (FieldMask format)

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

Se updateMask for fornecido, somente os campos especificados em job serão atualizados. Do contrário, todos os campos serão atualizados.

Uma máscara para restringir os campos que serão atualizados. Somente campos de nível superior de Job são aceitos.

Lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Job.

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.