Package google.cloud.talent.v4beta1

Índice

CompanyService

Un servicio que controla la administración de una empresa, incluidos CRUD y enumeración.

CreateCompany

rpc CreateCompany(CreateCompanyRequest) returns (Company)

Crea una entidad de empresa nueva.

Alcances de la 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.

DeleteCompany

rpc DeleteCompany(DeleteCompanyRequest) returns (Empty)

Borra la empresa especificada. Requisito previo: La empresa no tiene trabajos asociados.

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.

GetCompany

rpc GetCompany(GetCompanyRequest) returns (Company)

Recupera la empresa especificada.

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.

ListCompanies

rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse)

Muestra una lista de todas las empresas asociadas con el proyecto.

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.

UpdateCompany

rpc UpdateCompany(UpdateCompanyRequest) returns (Company)

Actualiza la empresa especificada.

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.

Finalización

Un servicio controla la función de autocompletar.

CompleteQuery

rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse)

Completa el prefijo especificado con palabras clave sugeridas. Está diseñado para que lo use un cuadro de búsqueda de trabajo con la función de autocompletar.

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.

EventService

Un servicio administra un informe de eventos de clientes.

CreateClientEvent

rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent)

Informa eventos que se emiten cuando el usuario final interactúa con la aplicación del cliente que usa Cloud Talent Solution. Puedes inspeccionar los eventos creados en las herramientas de autoservicio. Obtén más información sobre las herramientas de autoservicio.

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.

JobService

Un servicio maneja la administración de trabajos, incluidos los CRUD, la enumeración y la búsqueda de trabajos.

BatchCreateJobs

rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation)

Comienza a ejecutar una operación de creación de trabajos por lotes.

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.

BatchDeleteJobs

rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty)

Borra una lista de Job por filtro.

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.

BatchUpdateJobs

rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation)

Comienza a ejecutar una operación de trabajos de actualización por lotes.

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.

CreateJob

rpc CreateJob(CreateJobRequest) returns (Job)

Crea un trabajo nuevo.

Por lo general, el trabajo se puede buscar en 10 segundos, pero puede tardar hasta 5 minutos.

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.

DeleteJob

rpc DeleteJob(DeleteJobRequest) returns (Empty)

Borra el trabajo especificado.

Por lo general, el trabajo no se puede buscar en 10 segundos, pero puede tardar hasta 5 minutos.

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.

GetJob

rpc GetJob(GetJobRequest) returns (Job)

Recupera el trabajo especificado cuyo estado es OPEN o EXPIRED recientemente dentro de los últimos 90 días.

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.

ListJobs

rpc ListJobs(ListJobsRequest) returns (ListJobsResponse)

Muestra una lista de los trabajos por filtro.

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.

SearchJobs

rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse)

Busca trabajos con el SearchJobsRequest proporcionado.

Esta llamada restringe el visibility de los trabajos presentes en la base de datos y solo muestra trabajos en los que el llamador tiene permiso para buscar.

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.

SearchJobsForAlert

rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse)

Busca trabajos con el SearchJobsRequest proporcionado.

Esta llamada a la API está diseñada para el caso de uso de segmentación de personas que buscan empleo pasivos (por ejemplo, personas que se registraron para recibir alertas por correo electrónico sobre posibles oportunidades de trabajo) y tiene diferentes ajustes algorítmicos que se orientan a quienes buscan trabajo pasivo.

Esta llamada restringe el visibility de los trabajos presentes en la base de datos y solo muestra los trabajos que el emisor tiene permiso para buscar.

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.

UpdateJob

rpc UpdateJob(UpdateJobRequest) returns (Job)

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.

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.

TenantService

Un servicio que controla la administración de usuarios, incluidos CRUD y enumeración.

CreateTenant

rpc CreateTenant(CreateTenantRequest) returns (Tenant)

Crea una entidad de usuario nueva.

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.

DeleteTenant

rpc DeleteTenant(DeleteTenantRequest) returns (Empty)

Borra el usuario especificado.

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.

GetTenant

rpc GetTenant(GetTenantRequest) returns (Tenant)

Recupera el usuario especificado.

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.

ListTenants

rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse)

Enumera todas las instancias asociadas con el proyecto.

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.

UpdateTenant

rpc UpdateTenant(UpdateTenantRequest) returns (Tenant)

Actualiza el usuario especificado.

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.

BatchCreateJobsRequest

Solicitar la creación de un lote de trabajos.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

jobs[]

Job

Obligatorio. Los trabajos que se crearán.

BatchDeleteJobsRequest

Solicitud de eliminación de trabajos por lotes.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

filter

string

Obligatorio. La string de filtro especifica los trabajos que se borrarán.

Operador admitido: =, AND

Estos son los campos aptos para filtrar:

  • companyName (obligatorio)
  • requisitionId (obligatorio)

Consulta de ejemplo: companyName = "projects/foo/companies/bar" AND requisitionId = "req-1"

BatchOperationMetadata

Metadatos que se usan para operaciones de larga duración que muestran las APIs de lotes de CTS. Se usa para reemplazar google.longrunning.Operation.metadata.

Campos
state

State

El estado de una operación de larga duración.

state_description

string

Información más detallada sobre el estado de la operación.

success_count

int32

Recuento de elementos correctos dentro de una operación.

failure_count

int32

Recuento de elementos con errores dentro de una operación.

total_count

int32

Recuento de elementos totales dentro de una operación.

create_time

Timestamp

El momento en que se crea la operación por lotes.

update_time

Timestamp

La hora a la que se actualiza el estado de la operación por lotes. Los metadatos y el update_time se actualizan cada minuto; de lo contrario, se muestran los datos almacenados en caché.

end_time

Timestamp

El momento en que finaliza la operación por lotes y google.longrunning.Operation.done se establece en true.

Estado

Enums
STATE_UNSPECIFIED Valor predeterminado
INITIALIZING Se está preparando la operación por lotes para su procesamiento.
PROCESSING La operación por lotes se está procesando de forma activa.
SUCCEEDED Se procesó la operación por lotes y al menos un elemento se procesó correctamente.
FAILED La operación por lotes finalizó y ningún elemento se procesó correctamente.
CANCELLING La operación por lotes está en proceso de cancelación después de que se llama a google.longrunning.Operations.CancelOperation.
CANCELLED La operación por lotes finaliza después de que se llama a google.longrunning.Operations.CancelOperation. Todos los artículos procesados antes de la cancelación se muestran en la respuesta.

BatchUpdateJobsRequest

Solicitud para actualizar un lote de trabajos.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

jobs[]

Job

Obligatorio. Los trabajos que se actualizarán.

update_mask

FieldMask

Muy recomendable para obtener la mejor experiencia de servicio. Ten en cuenta que también aumentará la latencia cuando verifiques el estado de una operación por lotes.

Si se proporciona update_mask, 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.

Si se proporciona update_mask, Job dentro de JobResult solo contendrá campos que están actualizados, más el ID del trabajo. De lo contrario, Job incluirá todos los campos, lo que puede generar una respuesta muy grande.

ClientEvent

Un evento que se emite cuando un usuario final interactúa con la aplicación que implementa Cloud Talent Solution. Proporcionar esta información mejora la calidad de los resultados para los clientes de la API, lo que permite que el servicio funcione de forma óptima. La cantidad de eventos enviada debe coincidir con otras llamadas, como las búsquedas de trabajo, que el cliente envía al servicio.

Campos
request_id

string

Muy recomendable para obtener la mejor experiencia de servicio.

Un ID único generado en las respuestas de la API. Se puede encontrar en ResponseMetadata.request_id.

event_id

string

Obligatorio. Un identificador único que genera la aplicación cliente.

create_time

Timestamp

Obligatorio. Es la marca de tiempo del evento.

event_notes

string

Notas sobre el evento proporcionadas por otros usuarios y reclutadores; por ejemplo, comentarios sobre por qué se agregó un perfil a favoritos

job_event

JobEvent

Un evento que se emite cuando un usuario interactúa con la aplicación que implementa Cloud Talent Solution.

CommuteFilter

Parámetros necesarios para la búsqueda según el traslado.

Campos
commute_method

CommuteMethod

Obligatorio. Es el medio de transporte que se usará para calcular el tiempo de viaje diario.

start_coordinates

LatLng

Obligatorio. La latitud y la longitud de la ubicación desde la que se calculará el tiempo de viaje diario.

travel_duration

Duration

Obligatorio. El tiempo de viaje máximo en segundos. El valor máximo permitido es 3600s (una hora). El formato es 123s.

allow_imprecise_addresses

bool

Si es true, es posible que también se muestren trabajos sin direcciones en el nivel de la calle. En el caso de las direcciones en la ciudad, se usa el centro de esta. En el caso de las direcciones estatales y a otros niveles menos específicos, se usa la coincidencia de texto. Si este campo se configura como false o no se especifica, las búsquedas de traslado solo mostrarán trabajos que incluyan direcciones a nivel de calle.

Campo de unión traffic_option. Factor del tráfico que se debe tener en cuenta cuando se busca por viaje diario. traffic_option puede ser solo uno de los siguientes:
road_traffic

RoadTraffic

Especifica la densidad de tráfico que se usará para calcular el tiempo de viaje de ida y vuelta al trabajo.

departure_time

TimeOfDay

La hora de salida que se usa para calcular el impacto del tráfico, representada como google.type.TimeOfDay en la zona horaria local.

Actualmente, el modelo de tráfico está restringido a la resolución a nivel de hora.

RoadTraffic

La densidad de tráfico que se usará para calcular el tiempo de viaje de ida y vuelta al trabajo.

Enums
ROAD_TRAFFIC_UNSPECIFIED No se especificó la situación del tráfico en la ruta.
TRAFFIC_FREE Tiempo de traslado óptimo sin considerar el efecto del tráfico.
BUSY_HOUR El cálculo del tiempo de traslado considera el efecto del nivel máximo de tráfico.

CommuteMethod

Medio de traslado.

Enums
COMMUTE_METHOD_UNSPECIFIED No se especificó el método de viaje diario.
DRIVING El tiempo de traslado se calcula según el tiempo de conducción.
TRANSIT El tiempo de viaje diario se calcula en función del transporte público, lo que incluye autobús, metro y otros.
WALKING El tiempo de viaje diario se calcula en función de la duración del viaje a pie.
CYCLING El tiempo de viaje diario se calcula según el tiempo en bicicleta.

Empresa

Un recurso Company representa una empresa en el servicio. Una empresa es la entidad que posee publicaciones de empleo, es decir, la entidad que contrata y es responsable de emplear a quienes postulan al puesto de trabajo.

Campos
name

string

Obligatorio durante la actualización de la empresa.

El nombre del recurso de una empresa. El servicio lo genera cuando se crea una empresa.

El formato es "proyectos/{project_id}/usuarios/{instancia_id}/empresas/{empresa_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”.

display_name

string

Obligatorio. El nombre visible de la empresa, por ejemplo, “Google LLC”.

external_id

string

Obligatorio. Es el identificador de la empresa del cliente, que se utiliza para identificar de manera única a la empresa.

La cantidad máxima de caracteres permitida es 255.

size

CompanySize

El tamaño de la empresa del empleador.

headquarters_address

string

La dirección de la oficina central de la empresa, que puede ser diferente de la ubicación del trabajo. El servicio intenta determinar la ubicación geográfica de la dirección proporcionada y asigna una ubicación más específica a DerivedInfo.headquarters_location siempre que sea posible.

hiring_agency

bool

Se establece como true si es la agencia de contratación que publica trabajos para otros empleadores.

La configuración predeterminada es "false" si no se proporciona.

eeo_text

string

Texto de renuncia de responsabilidad legal sobre la igualdad de oportunidades en el empleo, que se asociará con todos los trabajos y, por lo general, se mostrará en todas las funciones.

La cantidad máxima de caracteres permitida es 500.

website_uri

string

El URI que representa el sitio web principal o la página principal de la empresa (por ejemplo, "https://www.google.com").

La cantidad máxima de caracteres permitida es 255.

career_site_uri

string

Es el URI del sitio o la página de empleos del empleador en su sitio web, por ejemplo, "https://careers.google.com".

image_uri

string

Un URI que aloja el logotipo de la empresa del empleador.

keyword_searchable_job_custom_attributes[]

string

Es una lista de claves de Job.custom_attributes filtrables, cuyos string_values correspondientes se usan en las búsquedas de palabras clave. Los trabajos con string_values en estas claves de campo especificadas se muestran si alguno de los valores coincide con la palabra clave de la búsqueda. Los valores de campos personalizados con paréntesis, corchetes y símbolos especiales no se pueden buscar tal como están, y esas consultas de palabras clave deben estar entre comillas.

derived_info

DerivedInfo

Solo salida. Son los detalles derivados de la empresa.

suspended

bool

Solo salida. Indica si el servicio marcó una empresa como suspendida de la disponibilidad pública debido a que el contenido del trabajo parece ser sospechoso, abusivo o spam.

DerivedInfo

Son los detalles derivados de la empresa.

Campos
headquarters_location

Location

La ubicación estructurada de la sede central de la empresa, que se obtiene a partir del Company.headquarters_address, si se proporciona.

CompanySize

Una enumeración que representa el tamaño de la empresa.

Enums
COMPANY_SIZE_UNSPECIFIED El valor predeterminado si no se especifica el tamaño.
MINI La empresa tiene menos de 50 empleados.
SMALL La empresa tiene entre 50 y 99 empleados.
SMEDIUM La empresa tiene entre 100 y 499 empleados.
MEDIUM La empresa tiene entre 500 y 999 empleados
BIG La empresa tiene entre 1,000 y 4,999 empleados.
BIGGER La empresa tiene entre 5,000 y 9,999 empleados.
GIANT La empresa tiene 10,000 empleados o más.

CompensationFilter

Filtro del importe y el tipo de remuneración del trabajo.

Campos
type

FilterType

Obligatorio. Tipo de filtro.

units[]

CompensationUnit

Obligatorio. Especifica el CompensationInfo.CompensationUnit de las base compensation entry's deseadas.

range

CompensationRange

Rango de remuneración

include_jobs_with_unspecified_compensation_range

bool

Si se configura como verdadera, se incluirán los trabajos con campos de rango de remuneración sin especificar.

FilterType

Especifica el tipo de filtro.

Enums
FILTER_TYPE_UNSPECIFIED Tipo de filtro no especificado. El marcador de posición INVALID no se debe usar.
UNIT_ONLY

Filtrar por unidad de base compensation entry's. Un trabajo solo es una coincidencia si contiene una CompensationEntry base y su unidad coincide con units. Propaga uno o más units.

Consulta CompensationInfo.CompensationEntry para conocer la definición de la entrada de remuneración base.

UNIT_AND_AMOUNT

Filtra por unidad de base compensation entry's y por importe o rango. Un trabajo solo es una coincidencia si contiene una CompensationEntry base y la unidad de la entrada base coincide con los CompensationUnit proporcionados y el rango o la cantidad se superponen con la CompensationRange proporcionada.

Consulta CompensationInfo.CompensationEntry para conocer la definición de la entrada de remuneración base.

Configura exactamente un units y propaga range.

ANNUALIZED_BASE_AMOUNT

Filtrar por importe de remuneración base anualizado y unidad de base compensation entry's. Propaga range y cero o más units.

ANNUALIZED_TOTAL_AMOUNT

Filtra por el importe de remuneración total anualizado y la unidad de base compensation entry's . Propaga range y cero o más units.

CompensationInfo

Detalles de la remuneración del trabajo.

Campos
entries[]

CompensationEntry

Información sobre la remuneración del trabajo

Como máximo, una entrada puede ser del tipo CompensationInfo.CompensationType.BASE, que se conoce como entrada de remuneración base para el trabajo.

annualized_base_compensation_range

CompensationRange

Solo salida. Rango de remuneración base anualizado. Se calcula como la entrada de remuneración base CompensationEntry.amount veces CompensationEntry.expected_units_per_year.

Consulta CompensationEntry para obtener una explicación sobre la anualización de las compensaciones.

annualized_total_compensation_range

CompensationRange

Solo salida. Rango de remuneración total anualizado. Se calcula como la totalidad de las entradas de compensación CompensationEntry.amount por CompensationEntry.expected_units_per_year.

Consulta CompensationEntry para obtener una explicación sobre la anualización de las compensaciones.

CompensationEntry

Una entrada de remuneración que representa un componente de la remuneración, como el salario base, un bono o un tipo de remuneración diferente

Anualización: Se puede anualizar una entrada de compensación si contiene amount o range válidos. - y su expected_units_per_year está configurado o se puede derivar. Su rango anualizado se determina como (amount o range) multiplicado por expected_units_per_year.

Campos
type

CompensationType

Tipo de remuneración

El valor predeterminado es CompensationType.COMPENSATION_TYPE_UNSPECIFIED.

unit

CompensationUnit

Frecuencia del importe especificado

El valor predeterminado es CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.

description

string

Descripción de la remuneración Por ejemplo, podrían indicar términos sobre el capital o proporcionar contexto adicional para una bonificación estimada.

expected_units_per_year

DoubleValue

Cantidad esperada de unidades que se pagan cada año. Si no se especifica, cuando Job.employment_types es FULLTIME, se infiere un valor predeterminado en función de unit. Valores predeterminados: HOURLY: 2080 - DAILY: 260 - WEEKLY: 52 - MONTHLY: 12 - ANNUAL: 1

Campo de unión compensation_amount. Importe de remuneración. Puede ser un importe fijo o un rango flotante. compensation_amount puede ser solo uno de los siguientes:
amount

Money

Importe de remuneración.

range

CompensationRange

Rango de remuneración

CompensationRange

Rango de remuneración.

Campos
max_compensation

Money

El importe máximo de la remuneración. Si se deja vacío, el valor se establece en un valor de remuneración máximo y el código de moneda se configura para que coincida con el currency code de min_benefit.

min_compensation

Money

El importe mínimo de la remuneración. Si se deja vacío, el valor se establece en cero, y el código de moneda se configura para que coincida con el currency code de max_benefit.

CompensationType

El tipo de remuneración.

Para los importes de remuneración especificados en importes no monetarios, describe el esquema de remuneraciones en CompensationEntry.description.

Por ejemplo, el formato de propina se describe en CompensationEntry.description (por ejemplo, "Se esperan propinas del 15 al 20% según la factura del cliente") y una estimación de las propinas que se proporcionan en CompensationEntry.amount o CompensationEntry.range (USD 10 por hora).

Por ejemplo, la participación se describe en CompensationEntry.description (por ejemplo, "1% - 2% de adjudicación de capital durante 4 años, 1 año precipitado") y el valor se estima en CompensationEntry.amount o CompensationEntry.range. Si no es posible obtener una estimación de valor, las unidades son CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED y, luego, se aclaran en el campo CompensationEntry.description.

Enums
COMPENSATION_TYPE_UNSPECIFIED Valor predeterminado
BASE Remuneración base: Se refiere a la cantidad fija de dinero que un empleador paga a un empleado a cambio del trabajo realizado. La remuneración base no incluye beneficios, bonificaciones ni cualquier otra compensación potencial de un empleador.
BONUS Extra.
SIGNING_BONUS bono de contratación
EQUITY Equidad.
PROFIT_SHARING Reparto de ganancias.
COMMISSIONS Comisión.
TIPS se darán sugerencias
OTHER_COMPENSATION_TYPE Otro tipo de remuneración.

CompensationUnit

Frecuencia de pago

Enums
COMPENSATION_UNIT_UNSPECIFIED Valor predeterminado
HOURLY Cada hora.
DAILY Todos los días.
WEEKLY Semanal
MONTHLY Mensualmente.
YEARLY Anual.
ONE_TIME Una vez.
OTHER_COMPENSATION_UNIT Otras unidades de compensación.

CompleteQueryRequest

Parámetros de la función de autocompletar

Campos
parent

string

Obligatorio. Nombre del recurso del usuario en el que se realiza la finalización.

El formato es “projects/{project_id}/tenants/{tenant_id}”, por ejemplo, “proyectos/foo/usuario/bar”.

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

query

string

Obligatorio. La consulta que se usa para generar sugerencias.

La cantidad máxima de caracteres permitida es 255.

language_codes[]

string

La lista de idiomas de la consulta. Corresponde al código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Etiquetas para identificar idiomas.

La cantidad máxima de caracteres permitida es 255.

page_size

int32

Obligatorio. Conteo de resultados de la función de autocompletar.

El tamaño de página máximo permitido es 10.

company

string

Si se proporciona, restringe la función de autocompletar a la empresa especificada.

El formato es "proyectos/{project_id}/usuarios/{instancia_id}/empresas/{empresa_id}"; por ejemplo, "proyectos/foo/usuarios/bar/empresas/baz".

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

scope

CompletionScope

El alcance de la función de autocompletar. El valor predeterminado es CompletionScope.PUBLIC.

type

CompletionType

Tema de la función de autocompletar. El valor predeterminado es CompletionType.COMBINED.

CompletionScope

Enumeración que especifica el alcance de la función de autocompletar.

Enums
COMPLETION_SCOPE_UNSPECIFIED Valor predeterminado.
TENANT Las sugerencias se generan solo a partir de los datos que proporciona el cliente.
PUBLIC Las sugerencias se basan en todos los datos de trabajos en el sistema visible para el cliente.

CompletionType

Enumeración que especifica los temas de la función de autocompletar.

Enums
COMPLETION_TYPE_UNSPECIFIED Valor predeterminado
JOB_TITLE

Sugiere títulos de trabajos para el autocompletado de trabajos.

Para el tipo CompletionType.JOB_TITLE, solo se muestran los trabajos abiertos con el mismo language_codes.

COMPANY_NAME

Sugiere nombres de empresas para autocompletar trabajos.

Para el tipo CompletionType.COMPANY_NAME, solo se muestran las empresas que tienen trabajos disponibles con el mismo language_codes.

COMBINED

Sugiere títulos de trabajos y nombres de empresas para el autocompletado de trabajos.

Para el tipo CompletionType.COMBINED, solo se muestran los trabajos disponibles con el mismo language_codes o las empresas que tienen trabajos disponibles con el mismo language_codes.

CompleteQueryResponse

Respuesta de una consulta con la función de autocompletar.

Campos
completion_results[]

CompletionResult

Resultados de los candidatos de la empresa o el trabajo que coinciden.

metadata

ResponseMetadata

Información adicional para la invocación de la API, como el ID de seguimiento de la solicitud.

CompletionResult

Recurso que representa los resultados de la función de autocompletar.

Campos
suggestion

string

La sugerencia para la consulta.

type

CompletionType

Tema de la función de autocompletar.

image_uri

string

El URI de la imagen de la empresa para COMPANY_NAME.

CreateClientEventRequest

La solicitud del evento de informe

Campos
parent

string

Obligatorio. Nombre del recurso del usuario bajo el que se crea el evento.

El formato es “projects/{project_id}/tenants/{tenant_id}”, por ejemplo, “proyectos/foo/usuario/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado, por ejemplo, “projects/foo”.

client_event

ClientEvent

Obligatorio. Eventos que se emiten cuando el usuario final interactúa con la aplicación del cliente que usa Cloud Talent Solution.

CreateCompanyRequest

La solicitud del método CreateCompany.

Campos
parent

string

Obligatorio. Nombre del recurso del usuario con el que se crea la empresa.

El formato es “projects/{project_id}/tenants/{tenant_id}”, por ejemplo, “proyectos/foo/usuario/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado, por ejemplo, “projects/foo”.

company

Company

Obligatorio. La empresa que se creará.

CreateJobRequest

Crea una solicitud de trabajo.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

job

Job

Obligatorio. El trabajo que se creará.

CreateTenantRequest

La solicitud del método CreateTenant.

Campos
parent

string

Obligatorio. El nombre del recurso del proyecto en el que se crea el usuario.

El formato es “projects/{project_id}”, por ejemplo, “projects/foo”.

tenant

Tenant

Obligatorio. El usuario que se creará.

CustomAttribute

Valores de atributos personalizados que se pueden filtrar o no.

Campos
string_values[]

string

Se debe especificar solamente uno de los valores string_values o long_values.

Este campo se usa para realizar una búsqueda de coincidencia de cadena (CASE_SENSITIVE_MATCH o CASE_INSENSITIVE_MATCH). En el caso de los string_value que se pueden filtrar, se permite una cantidad total máxima de 200 valores, y cada string_value tiene un tamaño en bytes de no más de 500,000 B. En el caso de string_values que no se pueden filtrar, el tamaño máximo total en bytes de string_values no filtrable es de 50 KB.

No se permite una cadena vacía.

long_values[]

int64

Se debe especificar solamente uno de los valores string_values o long_values.

Este campo se utiliza para realizar búsquedas por rango de números. (EQ, GT, GE, LE, LT) en los long_value filtrables.

Actualmente, se admite 1 long_values como máximo.

filterable

bool

Si la marca filterable es verdadera, los valores del campo personalizado se pueden usar para los filtros de atributos personalizados JobQuery.custom_attribute_filter. Si es falso, no se podrán usar estos valores para los filtros de atributos personalizados.

El valor predeterminado es falso.

keyword_searchable

bool

Si la marca keyword_searchable es verdadera, las palabras clave en los campos personalizados se pueden buscar por concordancia de palabras clave. Si es falso, los valores no se pueden buscar por concordancia de palabras clave.

El valor predeterminado es falso.

DegreeType

Es el nivel de grado educativo definido en la Clasificación Estándar Internacional de la Educación (ISCED).

Enums
DEGREE_TYPE_UNSPECIFIED Valor predeterminado No representa un título ni la educación infantil temprana. Se asigna al código ISCED 0. Ej.) Jardín de infantes
PRIMARY_EDUCATION Educación primaria, que suele ser la primera etapa de la educación obligatoria. Código ISCED 1. Ej.: Escuela primaria
LOWER_SECONDARY_EDUCATION Educación secundaria básica; Primera etapa de educación secundaria que se basa en la educación primaria, por lo general, con un plan de estudios más orientado a diferentes materias. Código ISCED 2. Ej.) Escuela media
UPPER_SECONDARY_EDUCATION Educación media; segunda o última etapa de la educación secundaria, donde se prepara la educación terciaria o se proporcionan habilidades relevantes para el empleo. Por lo general, con una mayor variedad de transmisiones y opciones de temas. Código ISCED 3. Ej.) Escuela secundaria
ADULT_REMEDIAL_EDUCATION Educación correctiva para adultos: programas que ofrecen experiencias de aprendizaje que se basan en la educación secundaria y preparan la entrada al mercado laboral o la educación terciaria. El contenido es más amplio que la educación secundaria, pero no tan complejo como la educación terciaria. Código ISCED 4.
ASSOCIATES_OR_EQUIVALENT Associate o equivalente; primeros programas terciarios que suelen estar basados en la práctica, son específicos de la profesión y se preparan para la entrada al mercado laboral. Estos programas también pueden proporcionar una ruta hacia otros programas terciarios. Código ISCED 5.
BACHELORS_OR_EQUIVALENT Licenciatura o equivalente; programas diseñados para proporcionar conocimientos, habilidades y competencias académicos o profesionales de nivel intermedio que conduzcan a un primer título terciario o a una calificación equivalente. Código ISCED 6.
MASTERS_OR_EQUIVALENT Maestría o equivalente; programas diseñados para proporcionar conocimientos, habilidades y competencias académicos o profesionales avanzados que permitan obtener un segundo título terciario o una calificación equivalente. Código ISCED 7.
DOCTORAL_OR_EQUIVALENT Doctorado o equivalente; programas diseñados principalmente para conducir a una calificación en investigación avanzada, que generalmente concluye con el envío y la defensa de una tesertación sustancial de calidad publicable basada en la investigación original. Código ISCED 8.

DeleteCompanyRequest

Solicitud para borrar una empresa.

Campos
name

string

Obligatorio. El nombre del recurso de la empresa que se borrará.

El formato es "proyectos/{project_id}/usuarios/{instancia_id}/empresas/{empresa_id}"; por ejemplo, "proyectos/foo/usuarios/bar/empresas/baz".

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

DeleteJobRequest

Solicitud para borrar un trabajo.

Campos
name

string

Obligatorio. El nombre del recurso del trabajo que se borrará.

El formato es “projects/{project_id}/tenants/{tenant_id}/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”.

DeleteTenantRequest

Solicita borrar un usuario.

Campos
name

string

Obligatorio. El nombre del recurso del usuario que se borrará.

El formato es "projects/{project_id}/tenants/{tenant_id}", por ejemplo, "proyectos/foo/usuarios/bar".

DeviceInfo

Información del dispositivo recopilada del usuario que busca empleo, el candidato o alguna otra entidad que realiza la búsqueda de trabajo. Proporcionar esta información mejora la calidad de los resultados de la búsqueda en todos los dispositivos.

Campos
device_type

DeviceType

Tipo del dispositivo.

id

string

Un ID específico del dispositivo. El ID debe ser un identificador único que distinga al dispositivo de otros dispositivos.

DeviceType

Una enumeración que describe un mecanismo de exposición y un portal de acceso a la API.

Enums
DEVICE_TYPE_UNSPECIFIED No se especificó el tipo de dispositivo.
WEB Un navegador web para computadoras de escritorio, como Chrome, Firefox, Safari o Internet Explorer.
MOBILE_WEB Un navegador web para dispositivos móviles, como un teléfono o una tablet con un navegador Chrome.
ANDROID Una aplicación nativa de los dispositivos Android.
IOS Una aplicación nativa de los dispositivos iOS.
BOT Un bot, a diferencia de un dispositivo operado por personas, como un rastreador web.
OTHER Otros tipos de dispositivos.

EmploymentType

Una enumeración que representa el tipo de empleo de un trabajo

Enums
EMPLOYMENT_TYPE_UNSPECIFIED El valor predeterminado si no se especifica el tipo de empleo.
FULL_TIME El trabajo implica trabajar una cantidad de horas que equivalen a un empleo de tiempo completo, por lo general, de 40 horas por semana o más.
PART_TIME El trabajo implica trabajar menos horas que un trabajo de tiempo completo, por lo general, menos de 40 horas por semana.
CONTRACTOR El trabajo se ofrece como un puesto con contrato, a diferencia de uno con honorarios.
CONTRACT_TO_HIRE El trabajo se ofrece como un trabajo con contrato, con el entendimiento de que se convierte en un puesto de tiempo completo al final del contrato. Los trabajos de este tipo también se muestran cuando se buscan trabajos EmploymentType.CONTRACTOR.
TEMPORARY El trabajo se ofrece como una oportunidad de empleo temporal, por lo general, con un compromiso a corto plazo.
INTERN El trabajo es una oportunidad de empleo a plazo fijo para que los estudiantes o quienes recién comienzan a buscar empleos obtengan capacitación en el trabajo. Por lo general, esto se ofrece como un puesto por el verano.
VOLUNTEER Es una oportunidad para que se ofrezca como voluntario, en la que no se espera una compensación por los servicios prestados.
PER_DIEM El trabajo necesita que un empleado trabaje cuando sea necesario, con un programa flexible.
FLY_IN_FLY_OUT El trabajo implica emplear a personas en áreas remotas y llevarlas temporalmente al lugar de trabajo en lugar de reubicar a los empleados y sus familias de forma permanente.
OTHER_EMPLOYMENT_TYPE El trabajo no coincide con ninguno de los otros tipos de la lista.

GetCompanyRequest

Solicitud para obtener una empresa a partir del nombre.

Campos
name

string

Obligatorio. El nombre de recurso de la empresa que se recuperará.

El formato es “proyectos/{project_id}/usuarios/{instancia_id}/empresas/{empresa_id}”; por ejemplo, “proyectos/api-test-project/usuarios/foo/empresas/bar”.

Si no se especifica el ID de usuario, se usa el usuario predeterminado, por ejemplo, “projects/api-test-project/companies/bar”.

GetJobRequest

Obtén una solicitud de trabajo.

Campos
name

string

Obligatorio. El nombre del recurso del trabajo que se recuperará.

El formato es “projects/{project_id}/tenants/{tenant_id}/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”.

GetTenantRequest

Solicitud para obtener un usuario por nombre.

Campos
name

string

Obligatorio. El nombre de recurso del usuario que se recuperará.

El formato es "projects/{project_id}/tenants/{tenant_id}", por ejemplo, "proyectos/foo/usuarios/bar".

HistogramQuery

La solicitud de histograma.

Campos
histogram_query

string

Una expresión especifica una solicitud de histograma en función de los recursos coincidentes (por ejemplo, trabajos o perfiles) para las búsquedas.

Consulta SearchJobsRequest.histogram_queries y SearchProfilesRequest.histogram_queries para obtener detalles sobre la sintaxis.

HistogramQueryResult

Resultado del histograma que coincide con HistogramQuery especificado en las búsquedas.

Campos
histogram_query

string

Expresión de histograma solicitada.

histogram

map<string, int64>

Un mapa de los valores de la faceta asociada con valores distintos al número de entradas coincidentes con el valor correspondiente.

El formato clave es el siguiente:

  • (para el histograma de cadena) son los valores de cadena almacenados en el campo.
  • (para el bucket numérico con nombre) especificado en la función bucket(), como para bucket(0, MAX, "non-negative"), la clave será non-negative.
  • (para el bucket numérico anónimo) con el formato <low>-<high>, por ejemplo, 0-1000, MIN-0 y 0-MAX

HtmlSanitization

Opción para la limpieza de contenido HTML en los campos de entrada del usuario, por ejemplo, la descripción del trabajo. Cuando se configura esta opción, el usuario puede determinar si se realiza la limpieza en estos campos y de qué manera.

Enums
HTML_SANITIZATION_UNSPECIFIED Valor predeterminado
HTML_SANITIZATION_DISABLED Inhabilita la limpieza en la entrada HTML.
SIMPLE_FORMATTING_ONLY Limpia la entrada HTML y solo acepta etiquetas de lenguaje de marcado de negrita, cursiva, lista ordenada y lista sin ordenar.

Trabajo

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.

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/{project_id}/tenants/{tenant_id}/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 requisition_id, ya que este valor es único.

company

string

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

El formato es “projects/{project_id}/tenants/{tenant_id}/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”.

requisition_id

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, language_code y requisition_id.

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 requisition_id únicos (p.ej., “ReqA” se convierte en “ReqA-1”, “ReqA-2”, etc.), ya que no se permiten varios trabajos con los mismos company, language_code y requisition_id. Si se debe conservar el objeto requisition_id 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.

application_info

ApplicationInfo

Información de solicitudes de empleo.

job_benefits[]

JobBenefit

Los beneficios que incluye el trabajo.

compensation_info

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

custom_attributes

map<string, 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 string_values 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 string_values que no se pueden filtrar, el tamaño total máximo de string_values en todas las claves es de 50 KB.

degree_types[]

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.

employment_types[]

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.

language_code

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_level

JobLevel

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

promotion_value

int32

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.

posting_region

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)

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_start_time

Timestamp

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_end_time

Timestamp

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.

posting_publish_time

Timestamp

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.

posting_expire_time

Timestamp

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 ListJobs no puede enumerar el trabajo vencido, pero se puede recuperar con la API de GetJob, actualizarse con la API de UpdateJob o borrarlo con la API de DeleteJob. 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, language_code y requisition_id.

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, posting_publish_time debe establecerse antes de posting_expire_time. 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 job_end_time, 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.

posting_create_time

Timestamp

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

posting_update_time

Timestamp

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

company_display_name

string

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

derived_info

DerivedInfo

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

processing_options

ProcessingOptions

Opciones para el procesamiento de trabajos.

ApplicationInfo

Son los detalles relacionados con una solicitud de publicación de empleo.

Campos
emails[]

string

Usa este campo para especificar direcciones de correo electrónico a las que se puede enviar una postulación o un currículum.

La cantidad máxima de caracteres permitida para cada entrada es de 255.

instruction

string

Usa este campo para proporcionar instrucciones, como "Envía tu postulación por correo a…", que un candidato debe seguir para postularse al trabajo.

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 3,000.

uris[]

string

Usa este campo de URI para dirigir a un solicitante a un sitio web, por ejemplo, para vincular a un formulario de solicitud en línea.

La cantidad máxima de caracteres permitida para cada entrada es de 2,000.

DerivedInfo

Detalles derivados de la publicación de empleo.

Campos
locations[]

Location

Ubicaciones estructuradas del trabajo, resueltas a partir de Job.addresses

locations coinciden exactamente con Job.addresses en el mismo orden.

job_categories[]

JobCategory

Categorías de trabajo derivadas de Job.title y Job.description.

ProcessingOptions

Opciones para el procesamiento de trabajos.

Campos
disable_street_address_resolution

bool

Si se configura como true, el servicio no intenta resolver una dirección más precisa para el trabajo.

html_sanitization

HtmlSanitization

Opción para la limpieza del contenido HTML del trabajo. Los campos aplicados son los siguientes:

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

Es posible que se quiten las etiquetas HTML de estos campos si no inhabilitas la limpieza.

La configuración predeterminada es HtmlSanitization.SIMPLE_FORMATTING_ONLY.

JobBenefit

Una enumeración que representa los beneficios para los empleados que incluye el trabajo

Enums
JOB_BENEFIT_UNSPECIFIED El valor predeterminado si no se especifica el tipo.
CHILD_CARE El trabajo incluye el acceso a programas que apoyan el cuidado infantil, como las guarderías.
DENTAL El trabajo incluye servicios dentales cubiertos por un plan de seguro dental.
DOMESTIC_PARTNER El trabajo ofrece beneficios específicos para las parejas de convivencia.
FLEXIBLE_HOURS El trabajo permite tener un horario laboral flexible.
MEDICAL El trabajo incluye servicios de salud cubiertos por un plan de seguro médico.
LIFE_INSURANCE El trabajo incluye un plan de seguro de vida proporcionado por el empleador o disponible para que lo compre el empleado.
PARENTAL_LEAVE El trabajo permite que los padres se ausenten para cuidar a un hijo recién nacido.
RETIREMENT_PLAN El trabajo incluye un plan de ahorro para la jubilación proporcionado por el empleador o disponible para que lo compre el empleado.
SICK_DAYS El trabajo permite licencias médicas con goce de remuneraciones.
VACATION El trabajo incluye vacaciones con goce de remuneraciones.
VISION El trabajo incluye servicios oftalmológicos cubiertos por un plan de seguro oftalmológico.

JobCategory

Una enumeración representa la clasificación o el enfoque principal de la función específica. Este valor es diferente del “sector” asociado con una función, que se relaciona con la clasificación de la empresa que publica el trabajo.

Enums
JOB_CATEGORY_UNSPECIFIED El valor predeterminado si no se especifica la categoría.
ACCOUNTING_AND_FINANCE Un trabajo de finanzas y contabilidad, como contador.
ADMINISTRATIVE_AND_OFFICE Un trabajo administrativo y de oficina, como asistente administrativo.
ADVERTISING_AND_MARKETING Un trabajo de publicidad y marketing, como administrador de marketing.
ANIMAL_CARE Un trabajo de cuidado de animales, como veterinario.
ART_FASHION_AND_DESIGN Un trabajo de arte, moda o diseño, como diseñador.
BUSINESS_OPERATIONS Un trabajo de operaciones comerciales, como administrador de operaciones comerciales.
CLEANING_AND_FACILITIES Un trabajo de limpieza y de instalaciones, como personal de custodia.
COMPUTER_AND_IT Un trabajo de computación y TI, como administrador de sistemas.
CONSTRUCTION Un trabajo de construcción, como obrero general.
CUSTOMER_SERVICE Un trabajo de atención al cliente, como cajero.
EDUCATION Un trabajo de educación, como profesor de escuela.
ENTERTAINMENT_AND_TRAVEL Un trabajo de entretenimiento y viajes, como auxiliar de vuelo.
FARMING_AND_OUTDOORS Un trabajo de granja y al aire libre, como guardaparques.
HEALTHCARE Un trabajo de atención médica, como enfermera.
HUMAN_RESOURCES Un trabajo de recursos humanos, como director de recursos humanos.
INSTALLATION_MAINTENANCE_AND_REPAIR Un trabajo de instalación, mantenimiento o reparación, como electricista.
LEGAL Un trabajo jurídico, como asistente jurídico.
MANAGEMENT Un trabajo de administración, a menudo, usado en conjunto con otra categoría, como administrador de tienda.
MANUFACTURING_AND_WAREHOUSE Un trabajo de fabricación o almacenamiento, como técnico de ensamblaje.
MEDIA_COMMUNICATIONS_AND_WRITING Un trabajo de escritura o relacionado con medios de comunicación, como relación con los medios.
OIL_GAS_AND_MINING Un trabajo relacionado con el petróleo, el combustible o la minería, como perforador de alta mar.
PERSONAL_CARE_AND_SERVICES Un trabajo de servicios y cuidado personal, como estilista.
PROTECTIVE_SERVICES Un trabajo de servicios de protección, como guardia de seguridad.
REAL_ESTATE Un trabajo relacionado con propiedades, como agente inmobiliario.
RESTAURANT_AND_HOSPITALITY Un trabajo de restaurante o de recepción, como camarero.
SALES_AND_RETAIL Un trabajo de ventas o del sector minorista, como vendedor.
SCIENCE_AND_ENGINEERING Un trabajo de ingeniería y ciencias, como técnico de laboratorio.
SOCIAL_SERVICES_AND_NON_PROFIT Un trabajo de servicio social o sin fines de lucro, como el trabajo social de casos.
SPORTS_FITNESS_AND_RECREATION Un trabajo de deporte, entrenamiento físico o recreación, como entrenador personal.
TRANSPORTATION_AND_LOGISTICS Un trabajo de transporte o logística, como conductor de camiones.

JobEvent

Un evento que se emite cuando un usuario interactúa con la aplicación que implementa Cloud Talent Solution.

Campos
type

JobEventType

Obligatorio. El tipo del evento (ver JobEventType).

jobs[]

string

Obligatorio. El job name(s) asociado con este evento. Por ejemplo, si se trata de un evento impression, este campo contiene los identificadores de todos los trabajos que se muestran al buscador de trabajo. Si este fuese un evento view, este campo contendría el identificador del trabajo visto.

El formato es “projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}”, por ejemplo, “projects/foo/tenants/bar/jobs/baz”.

profile

string

El profile name asociado a este evento de cliente.

El formato es “projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}”, por ejemplo, “projects/foo/tenants/bar/profiles/baz”.

JobEventType

Una enumeración de un evento que se atribuye al comportamiento del usuario final, como una persona que busca empleo.

Enums
JOB_EVENT_TYPE_UNSPECIFIED Otros valores proporcionados no especifican el evento.
IMPRESSION El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio procesó un trabajo en su vista, como una lista de resultados de la búsqueda en un formato comprimido o recortado. Por lo general, este evento se asocia con los usuarios que ven una lista de trabajos en una sola página.
VIEW El usuario que busca empleo, o cualquier otra entidad que interactúa con el servicio, vio los detalles de un trabajo, incluida la descripción completa. Este evento no se aplica a la visualización de un fragmento de un trabajo que aparece como parte de los resultados de la búsqueda de trabajos. La visualización de un fragmento se asocia a un impression).
VIEW_REDIRECT El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio realizó una acción para ver un trabajo y se redireccionó a un sitio web diferente para el trabajo.
APPLICATION_START El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio comenzó el proceso o mostró la intención de postularse a un trabajo.
APPLICATION_FINISH El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio envió una postulación a un trabajo.
APPLICATION_QUICK_SUBMISSION El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio envió una postulación a un trabajo con un solo clic, sin ingresar información. Si un usuario que busca empleo realiza esta acción, se debe enviar solo este evento al servicio. No envíes también eventos JobEventType.APPLICATION_START o JobEventType.APPLICATION_FINISH.
APPLICATION_REDIRECT El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio realizó una acción para postularse a un trabajo y se redireccionó a un sitio web diferente para completar la postulación.
APPLICATION_COMPANY_SUBMIT Este evento se debe usar cuando una empresa envía una postulación en nombre de un usuario que busca empleo. Este evento está diseñado para que lo usen las agencias de empleo que intentan ubicar a los candidatos.
BOOKMARK El usuario que busca empleo o cualquier otra entidad que interactúa con el servicio mostró su interés en un trabajo, ya que lo agregó a favoritos o lo guardó.
NOTIFICATION Al usuario que busca empleo u otra entidad que interactúa con el servicio se le envió una notificación, como una alerta por correo electrónico o una notificación del dispositivo, que contiene uno o más listados de trabajos generados por el servicio.
HIRED La entidad que ofrece el trabajo (empleador) contrató al usuario que busca empleo o a cualquier otra entidad que interactúa con el servicio. Este evento solo se debe enviar si el usuario que busca empleo fue contratado mediante una postulación realizada a partir de una búsqueda en el servicio de Cloud Talent Solution.
SENT_CV Un reclutador o una agencia de empleo envió una postulación en nombre del candidato después de interactuar con el servicio para identificar una publicación de trabajo apropiada.
INTERVIEW_GRANTED La entidad que contrata (empleador) concedió una entrevista inicial a la entidad que interactúa con el servicio (por ejemplo, el usuario que busca empleo). Este evento solo se debe enviar si el usuario que busca empleo programó una entrevista como parte de una postulación realizada a partir de una búsqueda o una recomendación en el servicio de Cloud Talent Solution.

JobLevel

Una enumeración que representa el nivel de experiencia necesario para el trabajo

Enums
JOB_LEVEL_UNSPECIFIED El valor predeterminado si no se especifica el nivel.
ENTRY_LEVEL Colaboradores individuales de nivel inicial, por lo general, con menos de 2 años de experiencia en una función similar. Incluye a los practicantes.
EXPERIENCED Colaboradores individuales experimentados, por lo general, con más de 2 años de experiencia en una función similar
MANAGER Administradores de nivel inicial a intermedio, responsables de administrar un equipo de personas
DIRECTOR Administradores de nivel sénior, responsables de administrar equipos de administradores
EXECUTIVE Administradores de nivel ejecutivo y superiores, incluidos los puestos de dirección

JobOperationResult

Es el resultado de las APIs de JobService.BatchCreateJobs o JobService.BatchUpdateJobs. Se usa para reemplazar google.longrunning.Operation.response en caso de éxito.

Campos
job_results[]

JobResult

Lista de resultados de mutación de trabajos de una operación de mutación por lotes. Puede cambiar hasta que el estado de la operación sea FINALIZADO, FALLIDO o CANCELADO.

JobResult

Resultado de la mutación de un trabajo.

Campos
job

Job

Aquí, Job solo contiene información básica, incluidos name, company, language_code y requisition_id. Usa el método getJob para recuperar información detallada del trabajo creado o actualizado.

status

Status

El estado del trabajo procesado. Este campo se propaga si falla el procesamiento de job.

JobQuery

Es la consulta necesaria para realizar una búsqueda.

Campos
query

string

La cadena de consulta que coincide con los campos de título, descripción y ubicación del trabajo.

La cantidad máxima de caracteres permitida es 255.

query_language_code

string

Es el código de idioma de query. Por ejemplo, “en-US”. Este campo ayuda a interpretar mejor la consulta.

Si no se especifica un valor, el código de idioma de la consulta se detecta automáticamente, lo que podría no ser preciso.

El código de idioma debe tener el formato BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Etiquetas para identificar idiomas.

companies[]

string

Este filtro especifica las entidades de empresa que se buscarán.

Si no se especifica un valor, se buscan trabajos de todas las empresas.

Si se especifican varios valores, se buscarán trabajos de las empresas especificadas.

El formato es “projects/{project_id}/tenants/{tenant_id}/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”.

Se permiten 20 filtros de empresa como máximo.

location_filters[]

LocationFilter

El filtro de ubicación especifica las regiones geográficas que contienen los trabajos que se analizarán en la búsqueda. Consulta LocationFilter para obtener más información.

Si no se especifica un valor de ubicación, se recuperan los trabajos que coinciden con los demás criterios de búsqueda, sin importar dónde se encuentren.

Si se especifican varios valores, se recuperan trabajos de cualquiera de las ubicaciones especificadas. Si se especifican valores diferentes para el parámetro LocationFilter.distance_in_miles, se utilizará la distancia máxima proporcionada para todas las ubicaciones.

Se permiten 5 filtros de ubicación como máximo.

job_categories[]

JobCategory

El filtro de categoría especifica las categorías de trabajos que se buscarán. Consulta JobCategory para obtener más información.

Si no se especifica un valor, se buscarán trabajos de cualquier categoría.

Si se especifican varios valores, se buscarán trabajos de cualquier categoría especificada.

commute_filter

CommuteFilter

Permite filtrar trabajos por tiempo de viaje de ida y vuelta con diferentes métodos de transporte (por ejemplo, en automóvil o en transporte público).

Nota: Esto solo funciona cuando especificas un CommuteMethod. En este caso, se ignora location_filters.

Actualmente, no admitimos el orden por tiempo de traslado.

company_display_names[]

string

Este filtro especifica la empresa exacta Company.display_name de los trabajos que se buscarán.

Si no se especifica un valor, los trabajos de los resultados de la búsqueda se asociarán con cualquier empresa.

Si se especifican varios valores, los resultados de la búsqueda pueden incluir trabajos asociados con cualquiera de las empresas especificadas.

Se permiten 20 filtros de nombre visible de la empresa como máximo.

compensation_filter

CompensationFilter

Este filtro de búsqueda se aplica solo a Job.compensation_info. Por ejemplo, si el filtro se especifica como "Trabajo por hora con una remuneración por hora superior a $15", solo se buscarán trabajos que cumplan con estos criterios. Si no se define un filtro, se buscarán todos los trabajos disponibles.

custom_attribute_filter

string

Este filtro especifica una sintaxis estructurada para que coincida con el Job.custom_attributes marcado como filterable.

La sintaxis para esta expresión es un subconjunto de la sintaxis de SQL.

Los operadores admitidos son =, !=, <, <=, > y >=. La izquierda del operador es una clave de campo personalizada y la derecha del operador es un número o una cadena entrecomillada. Se deben escapar los caracteres de barra inversa (\) y comillas (").

Las funciones admitidas son LOWER([field_name]) para realizar una coincidencia que no distingue mayúsculas de minúsculas y EMPTY([field_name]) para filtrar la existencia de una clave.

Las expresiones booleanas (AND/OR/NOT) se admiten hasta 3 niveles de anidación (por ejemplo, “(A AND B AND C) OR NOT D) AND E”), se permite un máximo de 100 comparaciones o funciones en la expresión. La expresión debe tener menos de 6,000 bytes de longitud.

Consulta de muestra: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

disable_spell_check

bool

Esta marca controla la característica del corrector ortográfico. Si es falso, el servicio intenta corregir las consultas con errores ortográficos. Por ejemplo, "ingenier" se corrige a "ingeniero".

La configuración predeterminada es "false": se realiza un corrector ortográfico.

employment_types[]

EmploymentType

El filtro de tipo de empleo especifica el tipo de los trabajos que se buscarán, como EmploymentType.FULL_TIME.

Si no se especifica un valor, los resultados de la búsqueda incluirán trabajos de cualquier tipo.

Si se especifican varios valores, los resultados de la búsqueda incluirán trabajos de cualquiera de los tipos especificados.

language_codes[]

string

Este filtro especifica la configuración regional de los trabajos que se buscarán, como "en-US".

Si no se especifica un valor, los resultados de la búsqueda pueden contener trabajos de cualquier configuración regional.

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.

Se permiten 10 filtros de código de idioma como máximo.

publish_time_range

TimestampRange

Se buscarán los trabajos publicados dentro de un rango especificado por este filtro.

excluded_jobs[]

string

Este filtro especifica una lista de los nombres de los trabajos que se excluirán durante la búsqueda.

Se permiten 400 nombres de trabajos excluidos como máximo.

JobView

Una enumeración que especifica los atributos del trabajo que se muestran en los campos MatchingJob.job o ListJobsResponse.jobs.

Enums
JOB_VIEW_UNSPECIFIED Valor predeterminado
JOB_VIEW_ID_ONLY Una vista de trabajo de solo ID, con los siguientes atributos: Job.name, Job.requisition_id y Job.language_code.
JOB_VIEW_MINIMAL Una vista mínima del trabajo, con los siguientes atributos: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations y Job.language_code.
JOB_VIEW_SMALL Una vista pequeña del trabajo, con los siguientes atributos en los resultados de la búsqueda: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.visibility, Job.language_code y Job.description.
JOB_VIEW_FULL Todos los atributos disponibles se incluyen en los resultados de la búsqueda.

ListCompaniesRequest

Muestra la lista de empresas a las que el cliente tiene acceso de lectura según la LCA.

Campos
parent

string

Obligatorio. Nombre del recurso del usuario con el que se crea la empresa.

El formato es “projects/{project_id}/tenants/{tenant_id}”, por ejemplo, “proyectos/foo/usuario/bar”.

Si no se especifica el ID de usuario, se usará el usuario predeterminado, por ejemplo, “projects/foo”.

page_token

string

El indicador inicial a partir del cual se mostrarán resultados.

page_size

int32

La cantidad máxima de empresas que se mostrarán, como máximo 100. El valor predeterminado es 100 si se proporciona un número negativo.

require_open_jobs

bool

Se configura como verdadero si las empresas solicitadas deben tener trabajos disponibles.

La configuración predeterminada es "false".

Si es verdadero, como máximo se recuperan page_size de las empresas, de las cuales solo se muestran las que tienen trabajos disponibles.

ListCompaniesResponse

El objeto de respuesta de ListCompanies

Campos
companies[]

Company

Las empresas del cliente actual.

next_page_token

string

Un token para recuperar los resultados de la página siguiente.

metadata

ResponseMetadata

Información adicional para la invocación de la API, como el ID de seguimiento de la solicitud.

ListJobsRequest

Solicita una lista de trabajos.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario con el que se crea el trabajo.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

filter

string

Obligatorio. La string de filtro especifica los trabajos que se enumerarán.

Operador admitido: =, AND

Estos son los campos aptos para filtrar:

  • companyName (obligatorio)
  • requisitionId
  • status Valores disponibles: OPEN, EXPIRED, ALL. El valor predeterminado es OPEN si no se especifica ningún valor.

Consulta de muestra:

  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz"
  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz" Y requisitionId = "req-1"
  • nombredeempresa = "proyectos/foo/usuarios/bar/empresas/baz" Y estado = "EXPIRADO"
page_token

string

El punto de partida de los resultados de la búsqueda.

page_size

int32

La cantidad máxima de trabajos que se mostrarán en cada página de resultados.

Si estableces job_view como JobView.JOB_VIEW_ID_ONLY, el tamaño de página máximo permitido es 1,000. De lo contrario, el tamaño de página máximo permitido es 100.

El valor predeterminado es 100 si está vacío o si se especifica un número menor que 1.

job_view

JobView

Los atributos de trabajo deseados que se muestran para los trabajos en la respuesta de la búsqueda. El valor predeterminado es JobView.JOB_VIEW_FULL si no se especifica ningún valor.

ListJobsResponse

Respuesta de enumeración de trabajos.

Campos
jobs[]

Job

Los trabajos de una empresa determinada.

La cantidad máxima de elementos que se muestran depende del campo de límite proporcionado en la solicitud.

next_page_token

string

Un token para recuperar los resultados de la página siguiente.

metadata

ResponseMetadata

Información adicional para la invocación de la API, como el ID de seguimiento de la solicitud.

ListTenantsRequest

Enumera los usuarios para los que el cliente tiene visibilidad de la LCA.

Campos
parent

string

Obligatorio. El nombre del recurso del proyecto en el que se crea el usuario.

El formato es “projects/{project_id}”, por ejemplo, “projects/foo”.

page_token

string

El indicador inicial a partir del cual se mostrarán resultados.

page_size

int32

La cantidad máxima de usuarios que se mostrarán, como máximo 100. El valor predeterminado es 100 si se proporciona un número negativo.

ListTenantsResponse

El objeto de respuesta de lista de usuarios

Campos
tenants[]

Tenant

Usuarios del cliente actual.

next_page_token

string

Un token para recuperar los resultados de la página siguiente.

metadata

ResponseMetadata

Información adicional para la invocación de la API, como el ID de seguimiento de la solicitud.

Ubicación

Un recurso que representa una ubicación con información geográfica completa.

Campos
location_type

LocationType

Es el tipo de una ubicación, que corresponde al campo de líneas de dirección de google.type.PostalAddress. Por ejemplo, "Centro, Atlanta, GA, EE.UU." tiene el tipo LocationType.NEIGHBORHOOD, y "Kansas City, KS, EE.UU." tiene el tipo LocationType.LOCALITY.

postal_address

PostalAddress

Dirección postal de la ubicación que incluye información legible, como direcciones de pago o de envío postal. Si se proporciona una dirección postal, un servicio postal puede enviar artículos a las instalaciones, a la casilla postal o a una ubicación de envío diferente.

lat_lng

LatLng

Un objeto que representa un par latitud-longitud.

radius_miles

double

Radio, expresado en millas desde la ubicación del trabajo. Este valor se deriva del cuadro delimitador de la ubicación, en el que un círculo con el radio especificado centrado en google.type.LatLng cubre el área asociada con la ubicación del trabajo. Por ejemplo, actualmente, "Mountain View, CA, EE.UU." tiene un radio de 10.17 kilómetros.

LocationType

Una enumeración que representa el tipo de una ubicación.

Enums
LOCATION_TYPE_UNSPECIFIED El valor predeterminado si no se especifica el tipo.
COUNTRY Una ubicación a nivel de país.
ADMINISTRATIVE_AREA Ubicación a nivel de estado o uno equivalente
SUB_ADMINISTRATIVE_AREA Ubicación a nivel de condado o uno equivalente
LOCALITY Ubicación a nivel de ciudad o uno equivalente
POSTAL_CODE Ubicación a nivel de código postal
SUB_LOCALITY Una sublocalidad es una subdivisión de una localidad, por ejemplo, un municipio, un distrito o un distrito en una ciudad. Por lo general, las sublocalidades son reconocidas por una autoridad política local. Por ejemplo, Manhattan y Brooklyn son reconocidos como barrios por la Ciudad de Nueva York y, por lo tanto, se clasifican como sublocalidades.
SUB_LOCALITY_1 Un distrito o un nivel de ubicación equivalente
SUB_LOCALITY_2 Un distrito más pequeño o un nivel equivalente
NEIGHBORHOOD Una ubicación a nivel de vecindario
STREET_ADDRESS Una ubicación a nivel de dirección.

LocationFilter

Región geográfica de la búsqueda.

Campos
address

string

El nombre de la dirección, como "Mountain View" o "Bay Area".

region_code

string

Código de región de CLDR para el país o la región de la dirección. Se utiliza para abordar la ambigüedad de la ubicación de entrada del usuario; por ejemplo, "Liverpool" con "Liverpool, NY, EE.UU." o "Liverpool, Reino Unido".

Establece este campo para personalizar la resolución de ubicación hacia un país o territorio específicos. Si no estableces este campo, el comportamiento de la aplicación se restringirá a Estados Unidos de forma predeterminada.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza. Ten en cuenta que este filtro no se aplica a las consultas relacionadas con la Búsqueda de perfiles.

lat_lng

LatLng

La latitud y la longitud del centro geográfico que se utiliza para realizar la búsqueda. Este campo se ignora si se proporciona address.

distance_in_miles

double

La distancia_in_miles se aplica cuando la ubicación que se busca se identifica como ciudad o más pequeña. Este campo se ignora si la ubicación que se busca es de un estado o superior.

telecommute_preference

TelecommutePreference

Permite que el cliente muestre trabajos que no tienen una ubicación establecida, específicamente, trabajos a distancia (el servicio considera este trabajo como una ubicación especial. Job.posting_region indica si un trabajo permite trabajar desde casa. Si estableces este campo como TelecommutePreference.TELECOMMUTE_ALLOWED, se buscarán trabajos a distancia y se ignorarán address y lat_lng. Si no la estableces o la estableces como TelecommutePreference.TELECOMMUTE_EXCLUDED, no se buscarán empleos desde casa.

Se puede usar este filtro por sí solo para buscar solo empleos que permitan trabajar desde casa. También se puede combinar con otro filtro de ubicación para buscar una combinación de ubicaciones de trabajo, como "Mountain View" o empleos que permitan "trabajar desde casa". Sin embargo, cuando se usa en conjunto con otros filtros de ubicación, se puede considerar los trabajos desde casa como menos relevantes que otros trabajos incluidos en la respuesta de la búsqueda.

Este campo solo se usa para solicitudes de búsqueda de trabajo.

negated

bool

Establece si se debe aplicar la negación al filtro para que se excluyan los perfiles que coincidan con el filtro.

Actualmente, solo se admite en la búsqueda de perfiles.

TelecommutePreference

Especifica si quieres incluir trabajos desde casa.

Enums
TELECOMMUTE_PREFERENCE_UNSPECIFIED El valor predeterminado si no se especifica la preferencia de trabajo desde casa.
TELECOMMUTE_EXCLUDED Excluye los trabajos desde casa.
TELECOMMUTE_ALLOWED Permite trabajos desde casa.

PostingRegion

Una enumeración que representa la región de publicación del trabajo. En la mayoría de los casos, no es necesario que las publicaciones de empleo especifiquen una región. Si se proporciona una región, los trabajos son aptos para las búsquedas en la región especificada.

Enums
POSTING_REGION_UNSPECIFIED Si no se especifica la región, se muestra el trabajo solo si coincide con LocationFilter.
ADMINISTRATIVE_AREA

Además de la coincidencia con la ubicación exacta, se muestra la publicación de empleo cuando la LocationFilter de la búsqueda se encuentra en la misma área administrativa que la publicación. Por ejemplo, si se publica un trabajo ADMINISTRATIVE_AREA en "CA, EE.UU.", se mostrará si LocationFilter tiene el valor "Mountain View".

El área administrativa se refiere a la subdivisión administrativa de nivel superior de este país. Por ejemplo, estado de EE.UU., región de TI, nación constitutiva del Reino Unido y prefectura de Japón.

NATION Además de la coincidencia con la ubicación exacta, el trabajo se muestra cuando LocationFilter de la búsqueda está en el mismo país que este trabajo. Por ejemplo, si se publica un trabajo NATION_WIDE en "EE.UU.", se mostrará si LocationFilter tiene el valor "Mountain View".
TELECOMMUTE El trabajo permite que los empleados trabajen de forma remota (desde casa). Si se proporcionan ubicaciones con este valor, se considera que el trabajo tiene una ubicación, pero se permite trabajar desde casa.

RequestMetadata

Información meta relacionada con el usuario que busca empleo o la entidad que realiza la búsqueda de trabajo. Esta información se usa para mejorar el rendimiento del servicio.

Campos
domain

string

Es obligatorio si no estableces allow_missing_ids o false.

El alcance o el origen de la llamada al servicio, definido por el cliente, que suele ser el dominio en el que se implementó el servicio y en el que se ejecuta actualmente.

Por ejemplo, si el cliente Foo, Inc. ejecuta el servicio, en la bolsa de empleo www.foo.com y el sitio de oportunidades laborales www.bar.com, este campo se configura como "foo.com" para la bolsa de trabajo y "bar.com" para el sitio de oportunidades laborales.

Ten en cuenta que cualquier mejora en el modelo para el sitio de un usuario en particular depende de que este campo se configure de forma correcta en un dominio único.

La cantidad máxima de caracteres permitida es 255.

session_id

string

Es obligatorio si no estableces allow_missing_ids o false.

Una string de identificación única de la sesión. Una sesión se define como la duración de la interacción de un usuario final con el servicio durante un período determinado. Ofusca este campo antes de enviarlo al servicio si tienes preocupaciones por la privacidad.

Ten en cuenta que cualquier mejora en el modelo para el sitio de un usuario específico depende de que este campo se configure de forma correcta en un ID de sesión único.

La cantidad máxima de caracteres permitida es 255.

user_id

string

Es obligatorio si no estableces allow_missing_ids o false.

Una string de identificación única del usuario, determinada por el cliente. Para tener el mayor impacto positivo en la calidad de la búsqueda, asegúrate de que el nivel del cliente sea único. Ofusca este campo antes de enviarlo al servicio si tienes preocupaciones por la privacidad.

Ten en cuenta que cualquier mejora en el modelo para el sitio de un usuario en particular depende de que este campo se configure de forma correcta en un ID de usuario único.

La cantidad máxima de caracteres permitida es 255.

allow_missing_ids

bool

Solo se establece cuando domain, session_id y user_id no están disponibles por algún motivo. Se recomienda no configurar este campo y proporcionar domain, session_id y user_id precisos para obtener la mejor experiencia de servicio.

device_info

DeviceInfo

El tipo de servicio que se usa en la búsqueda de trabajo en el momento que se llama al servicio.

ResponseMetadata

Información adicional que se muestra al cliente, como la información de depuración

Campos
request_id

string

Un ID único asociado con esta llamada. Este ID se registra para poder hacer un seguimiento.

SearchJobsRequest

El cuerpo de la solicitud de la llamada a SearchJobs.

Campos
parent

string

Obligatorio. El nombre del recurso del usuario en el que se buscará.

El formato es “projects/{project_id}/tenants/{tenant_id}”. Por ejemplo, “projects/foo/tenant/bar”. Si no se especifica el ID de usuario, se crea un usuario predeterminado. Por ejemplo, “projects/foo”.

search_mode

SearchMode

Modo de una búsqueda.

La configuración predeterminada es SearchMode.JOB_SEARCH.

request_metadata

RequestMetadata

Obligatorio. La metainformación recopilada sobre el usuario que busca empleo, que se usa para mejorar la calidad de las búsquedas del servicio. Los usuarios proporcionan los identificadores (como user_id), que deben ser únicos y coherentes.

job_query

JobQuery

Consulta que se usa para buscar trabajos, como palabras clave, filtros de ubicación, etcétera.

enable_broadening

bool

Controla si se amplía la búsqueda cuando se generan resultados dispersos. Las consultas ampliadas agregan resultados al final de la lista de resultados que coinciden.

La configuración predeterminada es "false".

require_precise_result_size
(deprecated)

bool

Este campo ya no está disponible.

histogram_queries[]

HistogramQuery

Una expresión especifica una solicitud de histograma para los trabajos coincidentes.

La sintaxis de expresiones es una llamada a función de agregación con facetas de histograma y otras opciones.

Las llamadas a funciones de agregación disponibles son las siguientes: * count(string_histogram_facet): Registra la cantidad de entidades coincidentes para cada valor de atributo distinto. * count(numeric_histogram_facet, list of buckets): Calcula la cantidad de entidades coincidentes dentro de cada bucket.

Tipos de datos:

  • Faceta de histograma: nombres de facetas con el formato [a-zA-Z][a-zA-Z0-9_]+.
  • Cadena: string como "cualquier cadena con barra invertida escape para comillas(")."
  • Número: un número entero y un número de punto flotante, como 10, -1 y -0,01.
  • Lista: lista de elementos separados por coma(,) entre corchetes, por ejemplo, [1, 2, 3] y ["uno", "dos", "tres"].

Constantes integradas:

  • MIN (número mínimo similar a Double.MIN_VALUE de Java)
  • MAX (número máximo similar a Double.MAX_VALUE de Java)

Funciones integradas:

  • bucket(inicio, fin[, etiqueta]): La función integrada de bucket crea un bucket con un rango de [inicio, fin). Ten en cuenta que el final es exclusivo, por ejemplo, bucket(1, MAX, “número positivo”) o bucket(1, 10).

Facetas de histogramas de trabajo:

  • company_display_name: histograma según Job.company_display_name
  • employee_type: histograma por Job.employment_types, por ejemplo, "FULL_TIME", "PART_TIME".
  • company_size: histograma por CompanySize, por ejemplo, “SMALL”, “MEDIUM” o “BIG”.
  • publish_time_in_month: Histograma por Job.posting_publish_time en meses. Se debe especificar la lista de buckets numéricos en la especificación.
  • publish_time_in_year: Es un histograma por Job.posting_publish_time en años. Se debe especificar la lista de buckets numéricos en la especificación.
  • Assured_types: Histograma por el valor de Job.degree_types, por ejemplo, “Bachelors” o “Masters”.
  • job_level: es el histograma de Job.job_level, por ejemplo, "Nivel inicial".
  • country: Histograma por el código de país de los trabajos; por ejemplo, "US" o "FR".
  • admin1: histograma según el código admin1 de trabajos, que es un marcador de posición global que hace referencia al estado, la provincia o el término específico que usa un país para definir la estructura geográfica debajo del nivel de país (por ejemplo, "CA" o "IL").
  • city: histograma mediante una combinación del “nombre de la ciudad, código admin1” (City name, admin1 code). Por ejemplo, "Mountain View, CA", "Nueva York, NY".
  • admin1_country: histograma mediante una combinación del "código admin1, país" (por ejemplo, "CA, EE.UU.", "IL, EE.UU.")
  • city_Coordinate: Histograma por las coordenadas GPS (latitud y longitud) del centro de la ciudad; por ejemplo, 37.4038522,-122.0987765. Dado que las coordenadas del centro de una ciudad pueden cambiar, es posible que los clientes deban actualizarlas periódicamente.
  • configuración regional: histograma según Job.language_code, por ejemplo, "en-US" o "fr-FR"
  • language: Histograma por la subetiqueta de idioma de Job.language_code, por ejemplo, "en", "fr".
  • categoría: histograma según JobCategory, por ejemplo, "COMPUTER_AND_IT", "HEALTHCARE".
  • base_amount_unit: Es un histograma por el CompensationInfo.CompensationUnit del salario base, por ejemplo, "WEEKLY" o "MONTHLY".
  • base_Reward: histograma según el salario base Se debe especificar la lista de buckets numéricos para agrupar los resultados.
  • anualized_base_ separador: histograma según el salario base anualizado Se debe especificar la lista de buckets numéricos para agrupar los resultados.
  • anualized_total_refund: histograma según el total del salario anualizado. Se debe especificar la lista de buckets numéricos para agrupar los resultados.
  • atributo_personalizado_cadena: histograma por cadena Job.custom_attributes Se puede acceder a los valores con notaciones de corchetes, como string_custom_attribute["key1"].
  • Atributo numérico_personalizado: histograma por Job.custom_attributes numérico Se puede acceder a los valores con notaciones de corchetes, como number_custom_attribute["key1"]. Se debe especificar la lista de buckets numéricos para agrupar los resultados.

Expresiones de ejemplo:

  • count(admin1)
  • count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])
  • count(string_custom_attribute["some-string-custom-attribute"])
  • count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
job_view

JobView

Los atributos de trabajo deseados que se muestran para los trabajos en la respuesta de la búsqueda. El valor predeterminado es JobView.JOB_VIEW_SMALL si no se especifica ningún valor.

offset

int32

Un número entero que especifica el desplazamiento actual (es decir, la ubicación inicial del resultado entre los trabajos que la API considera relevantes) en los resultados de la búsqueda. Este campo solo se considera si no estableces page_token.

El valor máximo permitido es 5,000. De lo contrario, se genera un error.

Por ejemplo, 0 significa que se mostrarán resultados a partir del primer trabajo coincidente y 10 significa que se devolverá desde el 11.o trabajo. Esto se puede utilizar para la paginación (por ejemplo, pageSize = 10 y offset = 10 significa que se mostrarán desde la segunda página).

page_size

int32

Un límite para la cantidad de trabajos que se muestran en los resultados de la búsqueda. Aumentar este valor por sobre el valor predeterminado de 10, puede aumentar el tiempo de respuesta de la búsqueda. El valor puede ser de 1 a 100.

page_token

string

El token que especifica el desplazamiento actual dentro de los resultados de la búsqueda. Consulta SearchJobsResponse.next_page_token para ver una explicación sobre cómo obtener el siguiente conjunto de resultados de la consulta.

order_by

string

Los criterios que determinan cómo se ordenan los resultados de la búsqueda. El valor predeterminado es "relevance desc".

Las opciones compatibles son las siguientes:

  • "relevance desc": por relevancia descendente, según lo determinan los algoritmos de la API El umbral de relevancia de los resultados de la búsqueda solo está disponible con este orden.
  • "posting_publish_time desc": Por Job.posting_publish_time en orden descendente.
  • "posting_update_time desc": Por Job.posting_update_time en orden descendente.
  • "title": Por Job.title en orden ascendente.
  • "title desc": Por Job.title en orden descendente.
  • "annualized_base_compensation": por el CompensationInfo.annualized_base_compensation_range del trabajo de menor a mayor. Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda.
  • "annualized_base_compensation desc": por el CompensationInfo.annualized_base_compensation_range del trabajo de mayor a menor Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda.
  • "annualized_total_compensation": por el CompensationInfo.annualized_total_compensation_range del trabajo de menor a mayor. Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda.
  • "annualized_total_compensation desc": por el CompensationInfo.annualized_total_compensation_range del trabajo de mayor a menor Los trabajos cuya remuneración base anualizada no se especifica se colocan al final de los resultados de la búsqueda.
  • "custom_ranking desc": Por la puntuación de relevancia ajustada al SearchJobsRequest.CustomRankingInfo.ranking_expression con el factor de peso asignado por SearchJobsRequest.CustomRankingInfo.importance_level en orden descendente.
  • Orden por ubicación: Usa la sintaxis especial para ordenar los trabajos por distancia.
    "distance_from('Hawaii')": Ordena por distancia desde Hawái.
    "distance_from(19.89, 155.5)": Ordena por distancia desde una coordenada.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": Ordena según varias ubicaciones. (consulte los detalles que aparecen a continuación).
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": Ordena según varias ubicaciones. (consulte los detalles que aparecen a continuación).
    La cadena puede tener un máximo de 256 caracteres. Cuando se proporcionan varios centros de distancia, un trabajo que se encuentre cerca de cualquiera de los centros de distancia tendrá una clasificación alta. Cuando un trabajo tenga varias ubicaciones, se usará la más cercana a uno de los centros de distancia. Los empleos que no tengan ubicaciones se clasificarán en la parte inferior. La distancia se calcula con una precisión de 11.3 metros (37.4 pies). Se seguirá aplicando la estrategia de diversificación, a menos que se inhabilite explícitamente en diversification_level.
diversification_level

DiversificationLevel

Controla si se muestran trabajos muy similares uno al lado del otro en los resultados de la búsqueda. Los empleos se identifican como muy similares en función de sus cargos, categorías de trabajo y ubicaciones. Los resultados muy similares se agrupan en clústeres para que solo un trabajo representativo del clúster se muestre al usuario en una posición superior en los resultados. Los otros trabajos se mostrarán más abajo en los resultados.

El valor predeterminado es DiversificationLevel.SIMPLE si no se especifica ningún valor.

custom_ranking_info

CustomRankingInfo

Controla cómo se clasifican los documentos de trabajo sobre la puntuación de relevancia existente (determinada por el algoritmo de la API).

disable_keyword_match

bool

Controla si se inhabilita la concordancia exacta de palabras clave en Job.title, Job.description, Job.company_display_name, Job.addresses y Job.qualifications. Cuando se desactiva la opción Inhabilitar la concordancia de palabras clave, la concordancia de palabras clave muestra trabajos que no coinciden con los filtros de categorías determinados cuando haya palabras clave que coincidan. Por ejemplo, para la consulta "gerente de programas", se muestra un resultado incluso si la publicación de trabajo tiene el título "desarrollador de software", que no corresponde a la ontología de "administrador de programas", pero aparece "administrador de programas" en su descripción.

Para consultas como “nube” que no contienen una ontología específica de título o ubicación, se muestran trabajos con coincidencias de palabras clave “nube”, sin importar el valor de esta marca.

Usa Company.keyword_searchable_job_custom_attributes si se necesitan valores de string de atributos o campos personalizados específicos de la empresa que coincidan a nivel global. Habilitar la concordancia de palabras clave mejora la recuperación de solicitudes de búsqueda posteriores.

La configuración predeterminada es "false".

CustomRankingInfo

Información de clasificación personalizada para SearchJobsRequest.

Campos
importance_level

ImportanceLevel

Obligatorio. Controla la importancia que se aplica la puntuación de CustomRankingInfo.ranking_expression a la posición de clasificación final del trabajo.

Si no se especifica, se genera un error.

ranking_expression

string

Obligatorio. Controla cómo se clasifican los documentos de trabajo sobre la puntuación de relevancia existente (determinada por el algoritmo de la API). Se usa una combinación de la expresión de clasificación y la puntuación de relevancia para determinar la posición de clasificación final del trabajo.

La sintaxis para esta expresión es un subconjunto de la sintaxis de Google SQL.

Los operadores admitidos son +, -, *, /, donde el lado izquierdo y derecho del operador es una clave Job.custom_attributes numérica, un valor entero o doble, o una expresión que se puede evaluar como un número.

Se admiten paréntesis para ajustar la precedencia del cálculo. La expresión debe tener menos de 100 caracteres de longitud.

La expresión se considera no válida para un trabajo si hace referencia a atributos personalizados que no se propagan en el trabajo o si la expresión da como resultado una división por cero. Si una expresión no es válida para un trabajo, ese trabajo desciende al final de los resultados.

Expresión de clasificación de muestra (año + 25) * 0.25 - (actualidad / 0.5)

ImportanceLevel

El nivel de importancia de CustomRankingInfo.ranking_expression.

Enums
IMPORTANCE_LEVEL_UNSPECIFIED El valor predeterminado si no se especifica el nivel de importancia.
NONE La expresión de clasificación determinada no tiene importancia. La puntuación de relevancia existente (determinada por el algoritmo de la API) domina la posición final de la clasificación del trabajo.
LOW La expresión de clasificación determinada es de baja importancia en términos de la posición de clasificación final del trabajo en comparación con la puntuación de relevancia existente (determinada por el algoritmo de la API).
MILD La expresión de clasificación determinada tiene una importancia leve en términos de la posición de clasificación final del trabajo en comparación con la puntuación de relevancia existente (determinada por el algoritmo de la API).
MEDIUM La expresión de clasificación es de importancia media en términos de la posición de clasificación final del trabajo en comparación con la puntuación de relevancia existente (determinada por el algoritmo de la API).
HIGH La expresión de clasificación determinada es de gran importancia en términos de la posición de clasificación final del trabajo en comparación con la puntuación de relevancia existente (determinada por el algoritmo de la API).
EXTREME La expresión de clasificación proporcionada es de importancia extrema y domina la posición de clasificación final del trabajo, ya que se ignora la puntuación de relevancia existente (determinada por el algoritmo de la API).

DiversificationLevel

Controla si se muestran trabajos muy similares uno al lado del otro en los resultados de la búsqueda. Los empleos se identifican como muy similares en función de sus cargos, categorías de trabajo y ubicaciones. Los resultados muy similares se agrupan en clústeres para que solo un trabajo representativo del clúster se muestre al usuario en una posición superior en los resultados. Los otros trabajos se mostrarán más abajo en los resultados.

Enums
DIVERSIFICATION_LEVEL_UNSPECIFIED No se especificó el nivel de diversificación.
DISABLED Inhabilita la diversificación. No se modificarán las posiciones de los trabajos que normalmente se envían a la última página. Esto puede causar que aparezcan trabajos muy similares en secuencia en los resultados de la búsqueda.
SIMPLE Comportamiento diversificador predeterminado. La lista de resultados está ordenada, de modo que los resultados muy similares se envían al final de la última página de resultados de la búsqueda. Si usas pageToken para paginar el conjunto de resultados, la latencia podría ser menor, pero no podemos garantizar que se devuelvan todos los resultados. Si usas el desplazamiento de página, la latencia puede ser mayor, pero se muestran todos los resultados.

SearchMode

Una enumeración del modo de búsqueda de trabajo, representada por una cadena. El servicio funciona de manera diferente para cada modo de servicio.

Enums
SEARCH_MODE_UNSPECIFIED No se especifica el modo del método de búsqueda. El comportamiento de búsqueda predeterminado es idéntico al comportamiento de búsqueda de JOB_SEARCH.

SearchJobsResponse

Respuesta del método SearchJob.

Campos
matching_jobs[]

MatchingJob

Las entidades de trabajo que coinciden con el SearchJobsRequest especificado.

histogram_query_results[]

HistogramQueryResult

Los resultados del histograma que coinciden con el SearchJobsRequest.histogram_queries especificado.

next_page_token

string

El token que especifica el punto de partida de la siguiente página de resultados. Este campo estará vacío si no hay más resultados.

location_filters[]

Location

Los filtros de ubicación que el servicio aplicó a la consulta específica. Si algún filtro se basa en el par latitud-longitud, el valor de Location.location_type es Location.LocationType.LOCATION_TYPE_UNSPECIFIED.

estimated_total_size

int32

Una estimación de la cantidad de trabajos que coinciden con la búsqueda especificada.

No se garantiza que esta cantidad sea precisa. Para obtener resultados precisos, consulta SearchJobsResponse.total_size.

total_size

int32

El recuento de resultados preciso con un límite de 100,000.

metadata

ResponseMetadata

Información adicional para la invocación de la API, como el ID de seguimiento de la solicitud.

broadened_query_jobs_count

int32

Si la ampliación de consultas está habilitada, es posible que agreguemos resultados adicionales de la consulta ampliada. Esta cantidad indica cuántos de los trabajos que se muestran en el campo de trabajos provienen de la consulta ampliada. Estos resultados se encuentran siempre al final de la lista de trabajos. En particular, un valor de 0 o si el campo no está configurado, todos los trabajos de la lista son de la consulta original (sin ampliar). Si este campo no es cero, las solicitudes posteriores con desplazamiento después de este conjunto de resultados deberían contener todos los resultados ampliados.

spell_correction

SpellingCorrection

El resultado de la revisión y la corrección ortográficas.

CommuteInfo

Detalles de viaje cotidiano relacionados con este trabajo.

Campos
job_location

Location

Ubicación que se usa como destino para calcular el tiempo de traslado.

travel_duration

Duration

La cantidad de segundos necesarios para viajar a la ubicación del trabajo desde la ubicación de la consulta. Una duración de 0 segundos indica que no se puede acceder al trabajo dentro de la duración solicitada, pero se mostró como parte de una consulta expandida.

MatchingJob

Entrada de trabajo con metadatos dentro de SearchJobsResponse.

Campos
job

Job

Recurso de trabajo que coincide con el SearchJobsRequest especificado.

job_summary

string

Un resumen del trabajo con la información principal que se muestra en la página de resultados de la búsqueda.

job_title_snippet

string

Contiene fragmentos de texto del campo Job.title que tienen una coincidencia más cercana con las palabras clave de una búsqueda, si están disponibles. Las palabras clave de la búsqueda que coinciden se encierran en etiquetas HTML de negrita.

search_text_snippet

string

Contiene fragmentos de texto de Job.description y campos similares que tienen una coincidencia más cercana con las palabras clave de una búsqueda, si están disponibles. Todas las etiquetas HTML de los campos originales se quitan cuando se muestran en este campo. Las palabras clave de la búsqueda que coinciden se encierran en etiquetas HTML de negrita.

commute_info

CommuteInfo

Información sobre el viaje diario, que se genera según lo especificado en CommuteFilter.

SpellingCorrection

Resultado de la corrección ortográfica.

Campos
corrected

bool

Indica si el corrector ortográfico corrigió la consulta.

corrected_text

string

Resultado de la corrección que corresponde a una string con la palabra clave corregida.

corrected_html

string

Se corrigió el resultado con etiquetas html para destacar las palabras corregidas. Las palabras corregidas se mencionan con las etiquetas HTML "...".

Por ejemplo, la consulta de entrada del usuario es “softwareenginear”, en la que la segunda palabra, “enginear”, es incorrecta. Debería ser “ingeniero”. Cuando está habilitada la corrección ortográfica, este valor es “ingeniero de software”.

Usuario

Un recurso de usuario representa un usuario en el servicio. Un usuario es un grupo o entidad que comparte el acceso común con privilegios específicos para recursos como los perfiles. El cliente puede crear varios usuarios para proporcionar aislamiento de datos para diferentes grupos.

Campos
name

string

Obligatorio durante la actualización del usuario.

El nombre del recurso de un usuario. El servicio lo genera cuando se crea un usuario.

El formato es "projects/{project_id}/tenants/{tenant_id}", por ejemplo, "proyectos/foo/usuarios/bar".

external_id

string

Obligatorio. Es el identificador de usuario del cliente, que se usa para identificar de forma única al usuario.

La cantidad máxima de caracteres permitida es 255.

usage_type

DataUsageType

Indica si los datos que pertenecen a este usuario se pueden usar para proporcionar mejoras del producto para otros usuarios.

El comportamiento predeterminado es DataUsageType.ISOLATED si no lo estableces.

keyword_searchable_profile_custom_attributes[]

string

Es una lista de claves de Profile.custom_attributes filtrables, cuyos string_values correspondientes se usan en las búsquedas de palabras clave. Los perfiles con string_values debajo de estas claves de campo especificadas se muestran si alguno de los valores coincide con la palabra clave de la búsqueda. Los valores de campos personalizados con paréntesis, corchetes y símbolos especiales no se pueden buscar tal como están y deben estar entre comillas.

DataUsageType

Enumeración que representa cómo se usan los datos del usuario que son propiedad del usuario.

Enums
DATA_USAGE_TYPE_UNSPECIFIED Valor predeterminado
AGGREGATED Los datos que posee este usuario se utilizan para mejorar la calidad de búsqueda/recomendación entre usuarios.
ISOLATED Los datos que posee esta instancia se utilizan solo para mejorar la calidad de las recomendaciones o la búsqueda de esta instancia.

TimestampRange

Mensaje que representa un período entre dos marcas de tiempo.

Campos
start_time

Timestamp

Comienzo del período (inclusive)

end_time

Timestamp

Final del período (excluido).

UpdateCompanyRequest

Solicitud de actualización de la empresa especificada.

Campos
company

Company

Obligatorio El recurso de empresa que reemplazará al recurso actual en el sistema.

update_mask

FieldMask

Muy recomendable para obtener la mejor experiencia de servicio.

Si se proporciona update_mask, solo se actualizan los campos especificados en company. De lo contrario, se actualizan todos los campos.

Una máscara de campo que especifica los campos de la empresa que se actualizarán. Solo se admiten los campos de nivel superior de Company.

UpdateJobRequest

Actualiza la solicitud de trabajo.

Campos
job

Job

Obligatorio. El trabajo que se actualizará.

update_mask

FieldMask

Muy recomendable para obtener la mejor experiencia de servicio.

Si se proporciona update_mask, 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.

UpdateTenantRequest

Solicitud de actualización de un usuario especificado.

Campos
tenant

Tenant

Obligatorio. El recurso de usuario para reemplazar el recurso actual en el sistema.

update_mask

FieldMask

Muy recomendable para obtener la mejor experiencia de servicio.

Si se proporciona update_mask, solo se actualizan los campos especificados en tenant. De lo contrario, se actualizan todos los campos.

Una máscara de campo para especificar los campos de usuario que se actualizarán. Solo se admiten los campos de nivel superior de Tenant.

Visibilidad

Obsoleto. Solo el propietario puede ver los recursos.

Una enumeración que representa quién tiene acceso de lectura al recurso.

Enums
VISIBILITY_UNSPECIFIED Valor predeterminado
ACCOUNT_ONLY Solo la cuenta de GCP propietaria de este recurso puede verlo.
SHARED_WITH_GOOGLE El recurso es visible para el propietario y puede ser visible para otras aplicaciones y procesos de Google.
SHARED_WITH_PUBLIC El recurso es visible para el propietario y puede ser visible para todos los otros clientes de la API.