Method: projects.jobs.patch

Actualiza el trabajo especificado.

Por lo general, el contenido actualizado aparece en los resultados de la búsqueda en 10 segundos, pero puede demorar hasta 5 minutos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
job.name

string

Obligatorio durante la actualización del trabajo.

El nombre del recurso para el trabajo. El servicio lo genera cuando se crea un trabajo.

El formato es “projects/{projectId}/tenants/{tenantId}/jobs/{job_id}”. Por ejemplo, “projects/foo/tenants/bar/jobs/baz”.

Si no se especifica el ID de usuario, se usa el predeterminado. Por ejemplo, “projects/foo/jobs/bar”.

Se prefiere el uso de este campo en consultas de trabajo y llamadas a la API, en lugar de requisitionId, ya que este valor es único.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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

Obligatorio. El nombre de recurso de la empresa que publica el trabajo.

El formato es “projects/{projectId}/tenants/{tenantId}/empresas/{company_id}”. Por ejemplo, “proyectos/foo/usuarios/bar/empresas/baz”.

Si no se especifica el ID de usuario, se usa el predeterminado. Por ejemplo, “proyectos/foo/empresas/bar”.

job.requisitionId

string

Obligatorio. El cliente asigna el ID de requerimiento, también conocido como ID de publicación, para identificar un trabajo. Este campo está diseñado para que lo usen los clientes para identificar a los clientes y hacer un seguimiento de las publicaciones. No se puede crear un trabajo si hay otro con los mismos company, languageCode y requisitionId.

La cantidad máxima de caracteres permitida es 255.

job.title

string

Obligatorio. El título del trabajo, como "Ingeniero de software"

La cantidad máxima de caracteres permitida es 500.

job.description

string

Obligatorio. La descripción del trabajo, que, por lo general, incluye una descripción de varios párrafos sobre la empresa y la información relacionada. En el objeto de trabajo, se proporcionan campos independientes para responsibilities, qualifications y otras características del trabajo. Se recomienda el uso de estos campos del trabajo independientes.

Este campo acepta la entrada HTML y la limpia, además de aceptar las etiquetas de lenguaje marcado de lista no ordenada, lista ordenada, cursiva y negrita.

La cantidad máxima de caracteres permitida es 100,000.

job.addresses[]

string

Muy recomendable para obtener la mejor experiencia de servicio.

Ubicaciones donde el empleador busca contratar a esta oferta de trabajo.

Especificar las direcciones completas de las ubicaciones de contratación permite obtener mejores resultados en la API, especialmente las búsquedas de empleo por tiempo de viaje diario.

Se permiten 50 ubicaciones como máximo, para garantizar el mejor rendimiento de la búsqueda. Si un trabajo tiene más ubicaciones, se sugiere dividirlo en varios trabajos con requisitionId únicos (p.ej., “ReqA” se convierte en “ReqA-1”, “ReqA-2”, etc.), ya que no se permiten varios trabajos con los mismos company, languageCode y requisitionId. Si se debe conservar el objeto requisitionId original, se debe usar un campo personalizado para el almacenamiento. Además, se sugiere agrupar las ubicaciones cercanas en el mismo trabajo para garantizar una mejor experiencia de búsqueda.

La cantidad máxima de caracteres permitida es 500.

job.applicationInfo

object (ApplicationInfo)

Información de solicitudes de empleo.

job.jobBenefits[]

enum (JobBenefit)

Los beneficios que incluye el trabajo.

job.compensationInfo

object (CompensationInfo)

Información sobre la remuneración del trabajo (también conocida como "tasa paga"), es decir, la remuneración que se pagará al empleado

job.customAttributes

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

Un mapa de campos que conserva atributos de trabajos personalizados filtrables y no filtrables que no están cubiertos por los campos estructurados proporcionados.

Las claves del mapa son cadenas de hasta 64 bytes y deben coincidir con el siguiente patrón: [a-zA-Z][a-zA-Z0-9_]*. Por ejemplo, key0LikeThis o KEY_1_LIKE_THIS.

Se admiten un máximo de 100 claves filtrables y un máximo de 100 no filtrables. En el caso de stringValues que se puede filtrar, se permiten un máximo de 200 valores en todas las claves, cada cadena no más de 255 caracteres. En el caso de stringValues que no se pueden filtrar, el tamaño total máximo de stringValues en todas las claves es de 50 KB.

job.degreeTypes[]

enum (DegreeType)

Los títulos de educación deseados para el trabajo, como licenciatura o maestría.

job.department

string

El departamento o área funcional dentro de la empresa que ofrece el puesto

La cantidad máxima de caracteres permitida es 255.

job.employmentTypes[]

enum (EmploymentType)

Los tipos de empleo de un trabajo, por ejemplo, full time o part time.

job.incentives

string

Una descripción de los bonos, las comisiones o cualquier otro incentivo de remuneración asociado con el trabajo, que no incluye el salario

La cantidad máxima de caracteres permitida es 10,000.

job.languageCode

string

El idioma de la publicación. Este campo es diferente de cualquier requisito de fluidez en idiomas asociado con el trabajo

Los códigos de idioma deben tener el formato BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Etiquetas para identificar idiomas{: class="external" target="_blank" }.

Si no se especifica este campo y aparece Job.description, se asigna el código de idioma detectado en función de Job.description; de lo contrario, se establece de forma predeterminada como "en_US".

job.jobLevel

enum (JobLevel)

El nivel de experiencia asociado con el trabajo, como "Nivel inicial"

job.promotionValue

integer

Un valor de promoción del trabajo, según lo determine el cliente. El valor determina el orden de los trabajos que se muestran cuando se usa la llamada de búsqueda de trabajos destacados. Los valores promocionales más altos se muestran primero y se resuelven las igualdades por orden de relevancia. Solo se mostrarán los trabajos que tengan promotionValue >0 en una FEATURED_JOB_SEARCH.

El valor predeterminado es 0 y los valores negativos se consideran 0.

job.qualifications

string

Una descripción de las cualificaciones necesarias para realizar el trabajo. Se recomienda usar este campo como alternativa al campo description, que es más general.

Este campo acepta la entrada HTML y la limpia, además de aceptar las etiquetas de lenguaje marcado de lista no ordenada, lista ordenada, cursiva y negrita.

La cantidad máxima de caracteres permitida es 10,000.

job.responsibilities

string

Una descripción de las responsabilidades del trabajo. Se recomienda usar este campo como alternativa al campo description, que es más general.

Este campo acepta la entrada HTML y la limpia, además de aceptar las etiquetas de lenguaje marcado de lista no ordenada, lista ordenada, cursiva y negrita.

La cantidad máxima de caracteres permitida es 10,000.

job.postingRegion

enum (PostingRegion)

El PostingRegion del trabajo (por ejemplo, el estado o el país) en el que el trabajo está disponible. Si se configura este campo, una LocationFilter en una búsqueda dentro de la región del empleo encontrará esta publicación de empleo si no se especifica una coincidencia de ubicación exacta. Si este campo se configura como PostingRegion.NATION o PostingRegion.ADMINISTRATIVE_AREA, se recomienda configurar el trabajo Job.addresses en el mismo nivel de ubicación que este campo.

job.visibility
(deprecated)

enum (Visibility)

Obsoleto. Solo el propietario puede ver el trabajo.

La visibilidad del trabajo.

El valor predeterminado es Visibility.ACCOUNT_ONLY si no se especifica.

job.jobStartTime

string (Timestamp format)

La marca de tiempo de inicio del trabajo en la zona horaria UTC. Por lo general, se usa este campo para los compromisos de contrato. Se ignoran las marcas de tiempo no válidas.

job.jobEndTime

string (Timestamp format)

La marca de tiempo de finalización del trabajo Por lo general, se usa este campo para los compromisos de contrato. Se ignoran las marcas de tiempo no válidas.

job.postingPublishTime

string (Timestamp format)

La marca de tiempo de la publicación más reciente de esta publicación de empleo. El valor predeterminado es la hora en la que el servidor recibe la solicitud. Se ignoran las marcas de tiempo no válidas.

job.postingExpireTime

string (Timestamp format)

Muy recomendable para obtener la mejor experiencia de servicio.

La marca de tiempo de vencimiento del trabajo. Después de esta marca de tiempo, el trabajo se marca como vencido y ya no aparece en los resultados de la búsqueda. La API de jobs.list no puede enumerar el trabajo vencido, pero se puede recuperar con la API de jobs.get, actualizarse con la API de jobs.patch o borrarlo con la API de jobs.delete. Un trabajo vencido se puede actualizar y volver a abrir con una marca de tiempo de vencimiento futura. La actualización de un trabajo vencido falla si hay otro disponible con los mismos company, languageCode y requisitionId.

Los trabajos vencidos se conservan en nuestro sistema durante 90 días. Sin embargo, el recuento general de trabajos vencidos no puede exceder 3 veces la cantidad máxima de trabajos disponibles en los 7 días anteriores. Si se supera este umbral, los trabajos vencidos se borran en orden de vencimiento. Una vez que se hayan limpiado, no se podrá acceder a los trabajos vencidos.

Las marcas de tiempo no válidas se ignoran y se consideran como tiempo de vencimiento que no se proporcionó.

Si la marca de tiempo es anterior a la realización de la solicitud instantánea, el trabajo se considera como vencido inmediatamente después de su creación. No se puede actualizar este tipo de trabajo. Cuando se crea un trabajo con una marca de tiempo de pasado, postingPublishTime debe establecerse antes de postingExpireTime. El propósito de esta función es permitir que otros objetos, como Application, hagan referencia a un trabajo que no existía en el sistema antes de su vencimiento. Si quieres modificar un trabajo que venció cuando creaste, bórralo y crea uno nuevo.

Si este valor no se proporciona en el momento de la creación del trabajo o no es válido, la publicación del trabajo vencerá 30 días después de la creación del trabajo. Por ejemplo, si el trabajo se creó el 2017/01/01 a las 13:00 a.m. UTC con una fecha de vencimiento no especificada, el trabajo vencerá después del 31/01/2017 a las 13:00 a.m. UTC.

Si este valor no se proporciona en la actualización del trabajo, depende de las máscaras de campo que establece UpdateJobRequest.update_mask. Si las máscaras de campo incluyen jobEndTime, o las máscaras están vacías significa que todos los campos se actualizan, la publicación de trabajo vence 30 días después de la última actualización del trabajo. De lo contrario, no se actualiza la fecha de vencimiento.

job.postingCreateTime

string (Timestamp format)

Solo salida. La marca de tiempo en la que se creó esta publicación de empleo.

job.postingUpdateTime

string (Timestamp format)

Solo salida. La marca de tiempo de la última actualización de esta publicación de empleo.

job.companyDisplayName

string

Solo salida. Nombre visible de la empresa que publica el trabajo

job.derivedInfo

object (DerivedInfo)

Solo salida. Detalles derivados de la publicación de empleo.

job.processingOptions

object (ProcessingOptions)

Opciones para el procesamiento de trabajos.

updateMask

string (FieldMask format)

Muy recomendable para obtener la mejor experiencia de servicio.

Si se proporciona updateMask, solo se actualizan los campos especificados en job. De lo contrario, se actualizan todos los campos.

Una máscara de campo que restringe los campos que se actualizan. Solo se admiten los campos de nivel superior de Job.

Una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Job.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Descripción general de la autenticación.