Migrar para a pesquisa de vagas v4 do CTS a partir de uma versão anterior

Informações gerais

O Cloud Talent Solution v4 é a versão mais recente em disponibilidade geral (GA). O Cloud Talent Solution v4 consolida recursos de várias versões anteriores ( v3, v3p1beta1 e v4beta1. Com o lançamento da v4, todas as versões anteriores (v3, v3p1beta1 e v4beta1) tornam-se obsoletas. As chamadas para versões obsoletas (v3p1beta1, v4beta1 e v3) não são processadas desde 14 de outubro de 2021.

Mudanças na funcionalidade

Algumas alterações funcionais importantes entre as versões v4 e as mais antigas estão descritas na tabela abaixo. Para ter uma visão completa das alterações de funcionalidade, recomendamos que você leia as notas da versão.

Alterações funcionais Versões mais antigas v4
Suporte a multilocação Compatível a partir da v4beta1. Caminhos de locatário e não locatário são compatíveis com a v4beta1. Agora o caminho de locatário é obrigatório. Para migrar do caminho não locatário para o de locatário, use a API listTenants para encontrar o locatário e adicioná-lo ao caminho do locatário.
Operações em lote As operações em lote na v3 e na v3p1beta1 são síncronas. A v4beta1 atualiza BatchCreate e BatchUpdate para operações assíncronas. BatchDelete é adicionado como uma operação em lote, e todas as operações em lote continuam sendo assíncronas.
Atributos do histograma Compatível com as versões v3 e v3p1beta1. A partir da v4beta1 HistogramFacets não é compatível e é substituído por Consulta de histograma, que oferece mais flexibilidade ao usar uma expressão. Apenas a Consulta de histograma é compatível (igual à v4beta1).
CompanyName O campo é chamado de companyName na v3 e v3p1beta1 e renomeado como company na v4beta1. O nome do campo é company (igual à v4beta1).
requirePreciseResultSize Obsoleto na v3, v3p1beta1 e v4beta1. Excluído da v4 porque todas as chamadas de pesquisa agora retornam resultados precisos.
estimatedTotalSize Excluído da v4 porque todas as chamadas de pesquisa agora retornam resultados precisos e esse campo tem o mesmo valor de totalSize.
CommuteMethod Caminhar e andar de bicicleta eram opções Beta na v4beta1. Elas continuarão utilizando os recursos Beta disponíveis apenas na v4beta1 até, aproximadamente, o primeiro trimestre de 2021. A partir daí, esses recursos estarão disponíveis de forma geral e incluídos na v4. COMMUTE_METHOD_UNSPECIFIED, DRIVING e TRANSIT são as únicas opções CommuteMethod disponíveis na v4 até o primeiro trimestre de 2021.
SearchJobsRequest.max_page_size Chamado de SearchJobsRequest.page_size em todas as versões anteriores. Renomeado para max_page_size na v4.
SearchJobsForAlertRequest.max_page_size Chamado de SearchJobsForAlertRequest.page_size em todas as versões anteriores. Renomeado para max_page_size na v4.
Tenant.usage_type O campo Tenant.usage_type foi adicionado na v4beta1. Este campo foi removido na v4. Os dados dentro de um locatário são usados apenas para melhorar a qualidade da pesquisa nesse locatário.

Novas adições por versão

Consulte a tabela abaixo para conhecer as novas funcionalidades que você receberá com o upgrade da versão anterior para a v4. Por exemplo, se estiver usando a v3 atualmente, será possível desbloquear todas as funcionalidades abaixo ao fazer o upgrade para a v4.

v3p1beta1 (inclui recursos da v3) v4p1beta1 (inclui recursos v3p1beta1) v4 (inclui recursos da v4beta1)
Novas expressões de histograma Melhoria da pesquisa com base no deslocamento diário Operações em lote (BatchDelete)
Classificação personalizada Melhoria do mecanismo de feedback gRPC (obrigatório)
Biblioteca de cliente Beta Suporte a multilocação
Operações em lote (BatchCreate e BatchUpdate)
gRPC (opcional)

Biblioteca de cliente do gRPC

A partir do Cloud Talent Solution v4, somente as bibliotecas de cliente baseadas em gRPC serão compatíveis. As bibliotecas de cliente do gRPC são frameworks RPC de alto desempenho que podem ser executados em qualquer ambiente e incluem interfaces REST e RPC. Você receberá bibliotecas de cliente geradas pela Cloud Talent Solution compatíveis com várias linguagens (Java, Python, Nodejs, C#, PHP e Ruby) para consumir as APIs.