Se usó la API de Cloud Translation para traducir esta página.

REST Resource: projects.tenants.jobs

Recurso: Job
- Representación JSON0
Métodos

Recurso: Job

Un recurso "job" representa una publicación de trabajo (también llamada "ficha de trabajo" o "requerimiento de trabajo"). Un trabajo pertenece a Company, que es la entidad que contrata y es responsable del trabajo.

Representación JSON

Representación 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`) } }

{
  "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` 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.
`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”.
`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.
`title`	`string` Obligatorio. El título del trabajo, como "Ingeniero de software" La cantidad máxima de caracteres permitida es 500.
`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.
`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.
`applicationInfo`	`object (ApplicationInfo)` Información de solicitudes de empleo.
`jobBenefits[]`	`enum (JobBenefit)` Los beneficios que incluye el trabajo.
`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
`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.
`degreeTypes[]`	`enum (DegreeType)` Los títulos de educación deseados para el trabajo, como licenciatura o maestría.
`department`	`string` El departamento o área funcional dentro de la empresa que ofrece el puesto La cantidad máxima de caracteres permitida es 255.
`employmentTypes[]`	`enum (EmploymentType)` Los tipos de empleo de un trabajo, por ejemplo, `full time` o `part time`.
`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.
`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".
`jobLevel`	`enum (JobLevel)` El nivel de experiencia asociado con el trabajo, como "Nivel inicial"
`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.
`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.
`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.
`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.
`visibility (deprecated)`	`enum (Visibility)` Este elemento está obsoleto. Obsoleto. Solo el propietario puede ver el trabajo. La visibilidad del trabajo. El valor predeterminado es `Visibility.ACCOUNT_ONLY` si no se especifica.
`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.
`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.
`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.
`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.
`postingCreateTime`	`string (Timestamp format)` Solo salida. La marca de tiempo en la que se creó esta publicación de empleo.
`postingUpdateTime`	`string (Timestamp format)` Solo salida. La marca de tiempo de la última actualización de esta publicación de empleo.
`companyDisplayName`	`string` Solo salida. Nombre visible de la empresa que publica el trabajo
`derivedInfo`	`object (DerivedInfo)` Solo salida. Detalles derivados de la publicación de empleo.
`processingOptions`	`object (ProcessingOptions)` Opciones para el procesamiento de trabajos.

Métodos
`batchCreate`	Comienza a ejecutar una operación de creación de trabajos por lotes.
`batchDelete`	Borra una lista de `Job` por filtro.
`batchUpdate`	Comienza a ejecutar una operación de trabajos de actualización por lotes.
`create`	Crea un trabajo nuevo.
`delete`	Borra el trabajo especificado.
`get`	Recupera el trabajo especificado cuyo estado es OPEN o EXPIRED recientemente dentro de los últimos 90 días.
`list`	Muestra una lista de los trabajos por filtro.
`patch`	Actualiza el trabajo especificado.
`search`	Busca trabajos con el `SearchJobsRequest` proporcionado.
`searchForAlert`	Busca trabajos con el `SearchJobsRequest` proporcionado.

REST Resource: projects.tenants.jobs

Recurso: Job

Métodos

`batchCreate`

`batchDelete`

`batchUpdate`

`create`

`delete`

`get`

`list`

`patch`

`search`

`searchForAlert`