Migrar a la versión 4 de CTS Job Search desde una versión anterior

Información general

Cloud Talent Solution v4 es la versión más reciente, que está disponible para todos los usuarios. Cloud Talent Solution v4 consolida las funciones de varias versiones anteriores (v3, v3p1beta1 y v4beta1). Con el lanzamiento de la versión 4, todas las versiones anteriores (v3, v3p1beta1 y v4beta1) están obsoletas. Las llamadas a versiones obsoletas (v3p1beta1, v4beta1 y v3) no se podrán realizar a partir del 14 de octubre del 2021.

Cambios de funciones

En la tabla que se muestra a continuación se describen algunos cambios funcionales importantes entre la versión 4 y las versiones anteriores. Para tener una visión completa de los cambios en las funciones, le recomendamos que consulte las notas de la versión.

Cambios funcionales Versiones anteriores v4
Compatibilidad con multitenancy Compatible a partir de la versión 4 beta 1. En la versión v4beta1 se admiten tanto las rutas de inquilino como las que no lo son. Ahora es obligatorio indicar la ruta del arrendatario. Para migrar de una ruta que no es de un arrendatario a una ruta de arrendatario, usa la API listTenants para buscar el arrendatario y añadirlo a la ruta de arrendatario.
Operaciones en lote Las operaciones por lotes de las versiones v3 y v3p1beta1 son síncronas. La versión v4beta1 actualiza BatchCreate y BatchUpdate a operaciones asíncronas. BatchDelete se añade como operación por lotes y todas las operaciones por lotes siguen siendo asíncronas.
Facetas de histograma Disponible en las versiones 3 y 3.1 (beta). A partir de la versión v4beta1, HistogramFacets no se admite y se sustituye por Consulta de histograma, que ofrece más flexibilidad al usar una expresión. Solo se admite Histogram Query (igual que en la versión v4beta1).
CompanyName El campo se llama companyName en v3 y v3p1beta1, y se ha cambiado a company en v4beta1. El nombre del campo es company (igual que en la versión v4beta1).
requirePreciseResultSize Obsoleto en v3, v3p1beta1 y v4beta1. Se ha eliminado de la versión 4 porque todas las llamadas de búsqueda ahora devuelven resultados precisos.
estimatedTotalSize Se ha eliminado de la versión 4 porque todas las llamadas de búsqueda ahora devuelven resultados precisos y este campo tiene el mismo valor que totalSize.
CommuteMethod Las opciones de caminar y montar en bicicleta eran versiones beta en v4beta1. Seguirán siendo funciones beta disponibles solo en la versión v4beta1 hasta aproximadamente el primer trimestre del 2021, momento en el que estarán disponibles de forma general y se incluirán en la versión v4. COMMUTE_METHOD_UNSPECIFIED, DRIVING y TRANSIT son las únicas opciones de CommuteMethod disponibles en la versión 4 hasta el primer trimestre del 2021.
SearchJobsRequest.max_page_size Se llama SearchJobsRequest.page_size en todas las versiones anteriores. Se ha cambiado el nombre a max_page_size en la versión 4.
SearchJobsForAlertRequest.max_page_size Se llama SearchJobsForAlertRequest.page_size en todas las versiones anteriores. Se ha cambiado el nombre a max_page_size en la versión 4.
Tenant.usage_type El campo Tenant.usage_type se añadió en la versión 4 beta 1. Este campo se ha quitado en la versión 4. Los datos de un arrendatario solo se usan para mejorar la calidad de la búsqueda en ese arrendatario.

Novedades por versión

En la tabla de abajo se muestra la nueva funcionalidad que obtendrás al actualizar de una versión anterior a la versión 4. Por ejemplo, si actualmente usas la versión 3, podrás desbloquear todas las funciones que se indican a continuación actualizando a la versión 4.

v3p1beta1 (incluye las funciones de v3) v4p1beta1 (incluye las funciones de v3p1beta1) v4 (incluye las funciones de v4beta1)
Nuevas expresiones de histograma Mejora de la búsqueda por distancia al trabajo Operaciones en lote (BatchDelete)
Posicionamiento personalizado Mejora del mecanismo de envío de comentarios gRPC (obligatorio)
Biblioteca de cliente beta Compatibilidad con multitenancy
Operaciones por lotes (BatchCreate y BatchUpdate)
gRPC (opcional)

Biblioteca de cliente de gRPC

A partir de la versión 4 de Cloud Talent Solution, solo se admitirán las bibliotecas de cliente basadas en gRPC. Las bibliotecas de cliente de gRPC son frameworks de RPC de alto rendimiento que se pueden ejecutar en cualquier entorno e incluyen interfaces REST y RPC. Se le proporcionarán bibliotecas de cliente generadas por Cloud Talent Solution compatibles con varios lenguajes (Java, Python, Node.js, C#, PHP y Ruby) para consumir las APIs.