Package google.cloud.talent.v4beta1

Índice

CompanyService

Um serviço que lida com o gerenciamento de empresas, incluindo CRUD e enumeração.

CreateCompany

rpc CreateCompany(CreateCompanyRequest) returns (Company)

Cria uma nova entidade de empresa.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteCompany

rpc DeleteCompany(DeleteCompanyRequest) returns (Empty)

Exclui a empresa especificada. Pré-requisito: a empresa não tem vagas associadas a ela.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetCompany

rpc GetCompany(GetCompanyRequest) returns (Company)

Recupera a empresa especificada.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListCompanies

rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse)

Lista todas as empresas associadas ao projeto.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

UpdateCompany

rpc UpdateCompany(UpdateCompanyRequest) returns (Company)

Atualiza a empresa especificada.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Conclusão

Um serviço lida com o preenchimento automático.

CompleteQuery

rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse)

Completa o prefixo especificado com sugestões de palavras-chave. Destinado ao uso por uma caixa de pesquisa de preenchimento automático para pesquisa de empregos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

EventService

Um serviço lida com o relatório de eventos do cliente.

CreateClientEvent

rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent)

Relata eventos emitidos na interação do usuário final com um aplicativo do cliente que usa o Cloud Talent Solution. É possível inspecionar os eventos criados em ferramentas de autoatendimento. Saiba mais sobre ferramentas de autoatendimento.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

JobService

Um serviço lida com o gerenciamento de trabalhos, incluindo CRUD de trabalho, enumeração e pesquisa.

BatchCreateJobs

rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation)

Começa a executar uma operação de criação de jobs em lote.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

BatchDeleteJobs

rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty)

Exclui uma lista de Jobs por filtro.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

BatchUpdateJobs

rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation)

Começa a executar uma operação de jobs de atualização em lote.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

CreateJob

rpc CreateJob(CreateJobRequest) returns (Job)

Cria uma nova vaga de trabalho.

Normalmente, a vaga se torna pesquisável em 10 segundos, mas pode demorar até 5 minutos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteJob

rpc DeleteJob(DeleteJobRequest) returns (Empty)

Exclui a vaga especificada.

Normalmente, a vaga deixa de ser pesquisável em 10 segundos, mas pode demorar até 5 minutos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetJob

rpc GetJob(GetJobRequest) returns (Job)

Recupera a vaga especificada com status OPEN ou EXPIRED recente nos últimos 90 dias.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListJobs

rpc ListJobs(ListJobsRequest) returns (ListJobsResponse)

Lista vagas por filtro.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

SearchJobs

rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse)

Procura vagas usando o SearchJobsRequest fornecido.

Essa chamada restringe o visibility das vagas presentes no banco de dados e retorna apenas as que o autor da chamada tem permissão para pesquisar.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

SearchJobsForAlert

rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse)

Procura vagas usando o SearchJobsRequest fornecido.

Esta chamada de API destina-se ao caso de uso de segmentação de candidatos passivos. Por exemplo, candidatos que se inscreveram para receber alertas por e-mail sobre possíveis oportunidades de trabalho. Ela tem diferentes ajustes algorítmicos destinados a candidatos passivos.

Essa chamada restringe o visibility das vagas presentes no banco de dados e retorna apenas as que o autor da chamada tem permissão para pesquisar.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

UpdateJob

rpc UpdateJob(UpdateJobRequest) returns (Job)

Atualiza a vaga especificada.

Normalmente, o conteúdo atualizado torna-se visível nos resultados da pesquisa em 10 segundos, mas pode levar até 5 minutos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

TenantService

Um serviço que lida com o gerenciamento de locatários, incluindo CRUD e enumeração.

CreateTenant

rpc CreateTenant(CreateTenantRequest) returns (Tenant)

Cria uma nova entidade de locatário.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteTenant

rpc DeleteTenant(DeleteTenantRequest) returns (Empty)

Exclui o locatário especificado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetTenant

rpc GetTenant(GetTenantRequest) returns (Tenant)

Recupera o locatário especificado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListTenants

rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse)

Lista todos os locatários associados ao projeto.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

UpdateTenant

rpc UpdateTenant(UpdateTenantRequest) returns (Tenant)

Atualiza o locatário especificado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

BatchCreateJobsRequest

Solicitação para criar um lote de jobs.

Campos
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

jobs[]

Job

Obrigatório. Os jobs a serem criados.

BatchDeleteJobsRequest

Exclusão em lote de solicitação de vaga.

Campos
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

filter

string

Obrigatório. A string de filtro especifica as vagas que serão excluídas.

Operador aceito: =, AND

Os campos qualificados para filtragem são:

  • companyName (obrigatório)
  • requisitionId (obrigatório)

Exemplo de consulta: companyName = "projects/foo/Companies/bar" E requisitionId = "req-1"

BatchOperationMetadata

Metadados usados para operações de longa duração retornadas pelas APIs em lote do CTS. Ele é usado para substituir google.longrunning.Operation.metadata.

Campos
state

State

O estado de uma operação de longa duração.

state_description

string

Informações mais detalhadas sobre o estado da operação.

success_count

int32

Contagem de itens bem-sucedidos dentro de uma operação.

failure_count

int32

Contagem de itens com falha em uma operação.

total_count

int32

Contagem do total de itens dentro de uma operação.

create_time

Timestamp

A hora em que a operação em lote é criada.

update_time

Timestamp

A hora em que o status da operação em lote é atualizado. Os metadados e o update_time são atualizados a cada minuto. Caso contrário, os dados armazenados em cache são retornados.

end_time

Timestamp

A hora em que a operação em lote é concluída e google.longrunning.Operation.done é definido como true.

Estado

Tipos enumerados
STATE_UNSPECIFIED Valor padrão.
INITIALIZING A operação em lote está sendo preparada para processamento.
PROCESSING A operação em lote está sendo processada ativamente.
SUCCEEDED A operação em lote foi processada e pelo menos um item foi processado.
FAILED A operação em lote foi concluída, e nenhum item foi processado.
CANCELLING A operação em lote está em processo de cancelamento depois que google.longrunning.Operations.CancelOperation é chamado.
CANCELLED A operação em lote é feita depois que google.longrunning.Operations.CancelOperation é chamado. Todos os itens processados antes do cancelamento são retornados na resposta.

BatchUpdateJobsRequest

Solicitação para atualizar um lote de jobs.

Campos
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

jobs[]

Job

Obrigatório. Os jobs a serem atualizados.

update_mask

FieldMask

É altamente recomendado para melhorar a experiência de atendimento. Esteja ciente de que isso também aumentará a latência ao verificar o status de uma operação em lote.

Se update_mask for fornecido, somente os campos especificados em Job serão atualizados. Do contrário, todos os campos serão atualizados.

Uma máscara para restringir os campos que serão atualizados. Somente campos de nível superior de Job são aceitos.

Se update_mask for fornecido, o Job dentro de JobResult conterá apenas os campos que são atualizados, além do ID do job. Caso contrário, Job vai incluir todos os campos, o que pode gerar uma resposta muito grande.

ClientEvent

Um evento emitido quando um usuário final interage com o aplicativo que implementa o Cloud Talent Solution. Essas informações melhoram a qualidade dos resultados para os clientes da API, permitindo que o serviço funcione de maneira ideal. O número de eventos enviados precisa ser consistente com outras chamadas, como pesquisas de vagas, emitidas para o serviço pelo cliente.

Campos
request_id

string

É altamente recomendado para melhorar a experiência de atendimento.

Um código exclusivo gerado nas respostas da API. Ele pode ser encontrado em ResponseMetadata.request_id.

event_id

string

Obrigatório. Um identificador exclusivo, gerado pelo aplicativo cliente.

create_time

Timestamp

Obrigatório. O carimbo de data/hora do evento.

event_notes

string

Observações sobre o evento fornecidas por recrutadores ou outros usuários, por exemplo, feedback sobre por que um perfil foi adicionado aos favoritos.

job_event

JobEvent

Um evento emitido quando um candidato a emprego interage com o aplicativo que implementa o Cloud Talent Solution.

CommuteFilter

Parâmetros necessários para a pesquisa de deslocamento diário.

Campos
commute_method

CommuteMethod

Obrigatório. O método de transporte para o cálculo do tempo de deslocamento diário.

start_coordinates

LatLng

Obrigatório. A latitude e a longitude do local de onde o tempo de deslocamento diário será calculado.

travel_duration

Duration

Obrigatório. O tempo máximo de viagem em segundos. O valor máximo permitido é 3600s (uma hora). O formato é 123s.

allow_imprecise_addresses

bool

Se for true, as vagas sem endereços no nível da rua também poderão ser retornadas. No caso de endereços no nível da cidade, o centro da cidade é usado. Para endereços no nível do estado e mais imprecisos, é usada a correspondência de texto. Se este campo for definido como false ou não for especificado, somente trabalhos que incluam endereços no nível da rua serão retornados pela pesquisa de deslocamento diário.

Campo de união traffic_option. Fator de trânsito a ser considerado ao pesquisar por deslocamento diário. traffic_option só pode ser de um dos seguintes tipos:
road_traffic

RoadTraffic

Especifica a intensidade do trânsito a ser usada no cálculo do tempo de deslocamento diário.

departure_time

TimeOfDay

O horário de partida usado para calcular o impacto do trânsito, representado como google.type.TimeOfDay no fuso horário local.

Atualmente, o modelo de trânsito é restrito à resolução no nível de hora.

RoadTraffic

A densidade do tráfego a ser usada no cálculo do tempo de deslocamento diário.

Tipos enumerados
ROAD_TRAFFIC_UNSPECIFIED A situação do trânsito não é especificada.
TRAFFIC_FREE O deslocamento diário ideal sem considerar qualquer impacto no trânsito.
BUSY_HOUR O cálculo do deslocamento diário considera o impacto máximo do trânsito.

CommuteMethod

Método de deslocamento diário.

Enums
COMMUTE_METHOD_UNSPECIFIED O método de deslocamento diário não é especificado.
DRIVING O tempo de deslocamento diário é calculado com base no tempo ao volante.
TRANSIT O tempo de deslocamento diário é calculado com base no transporte público, incluindo ônibus, metrô, entre outros.
WALKING O tempo de deslocamento diário é calculado com base no tempo de caminhada.
CYCLING O tempo de deslocamento diário é calculado com base no tempo em bicicleta.

Company

Um recurso Company representa uma empresa no serviço. Empresa é a entidade proprietária de ofertas de emprego, ou seja, a entidade contratante responsável por empregar candidatos à vaga.

Campos
name

string

Obrigatório durante a atualização da empresa.

O nome de recurso de uma empresa. É gerado pelo serviço quando uma empresa é criada.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", por exemplo, "projects/foo/tenants/bar/Companies/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/empresas/bar".

display_name

string

Obrigatório. O nome de exibição da empresa, por exemplo, "Google LLC".

external_id

string

Obrigatório. Identificador da empresa do lado do cliente, usado para identificar a empresa de maneira exclusiva.

O número máximo de caracteres permitido é 255.

size

CompanySize

O tamanho da empresa do empregador.

headquarters_address

string

O endereço da sede da empresa, que pode ser diferente do local de trabalho. O serviço tenta localizar geograficamente o endereço fornecido e preenche um local mais específico sempre que possível em DerivedInfo.headquarters_location.

hiring_agency

bool

Definido como "true" se for a agência contratante que posta vagas para outros empregadores.

Caso não seja fornecido, o padrão será “false”.

eeo_text

string

Aviso de isenção de responsabilidade da Comissão de Oportunidades Iguais de Emprego a ser associado a todas as vagas de emprego, normalmente exibido em todos os papéis.

O número máximo de caracteres permitidos é 500.

website_uri

string

O URI que representa a página inicial ou o principal site da empresa, por exemplo, "https://www.google.com".

O número máximo de caracteres permitido é 255.

career_site_uri

string

O URI do site de empregos ou a página de carreiras no site do empregador, por exemplo, "https://careers.google.com".

image_uri

string

Um URI que hospeda o logotipo da empresa do empregador.

keyword_searchable_job_custom_attributes[]

string

Uma lista de chaves de Job.custom_attributes filtrável, com string_values correspondente usada em pesquisas por palavra-chave. As vagas com string_values nessas chaves de campo especificadas serão retornadas se algum dos valores corresponder à palavra-chave de pesquisa. Os valores de campos personalizados com parênteses, colchetes e símbolos especiais não são pesquisáveis no estado em que estão, e essas consultas de palavra-chave precisam estar entre aspas.

derived_info

DerivedInfo

Apenas saída. Detalhes derivados da empresa.

suspended

bool

Apenas saída. Indica se uma empresa está marcada para ser suspensa da disponibilidade pública pelo serviço quando o conteúdo da vaga de emprego parece suspeito, abusivo ou spam.

DerivedInfo

Detalhes derivados da empresa.

Campos
headquarters_location

Location

Um local de sede estruturado da empresa, resolvido em Company.headquarters_address, se informado.

CompanySize

Um enum que representa o tamanho da empresa.

Tipos enumerados
COMPANY_SIZE_UNSPECIFIED Valor padrão caso o tamanho não seja especificado.
MINI A empresa tem menos de 50 funcionários.
SMALL A empresa tem entre 50 e 99 funcionários.
SMEDIUM A empresa tem entre 100 e 499 funcionários.
MEDIUM A empresa tem entre 500 e 999 funcionários.
BIG A empresa tem entre 1.000 e 4.999 funcionários.
BIGGER A empresa tem entre 5.000 e 9.999 funcionários.
GIANT A empresa tem 10.000 funcionários ou mais.

CompensationFilter

Filtra por valor e tipo de remuneração da vaga.

Campos
type

FilterType

Obrigatório. Tipo de filtro.

units[]

CompensationUnit

Obrigatório. Especifique o base compensation entry's CompensationInfo.CompensationUnit desejado.

range

CompensationRange

Intervalo de remuneração.

include_jobs_with_unspecified_compensation_range

bool

Se definido como verdadeiro, as vagas com campos de intervalo de remuneração não especificados serão incluídas.

FilterType

Especifique o tipo de filtragem.

Tipos enumerados
FILTER_TYPE_UNSPECIFIED Tipo de filtro não especificado. Nunca use o titular da posição INVALID.
UNIT_ONLY

Filtrar por unidade de base compensation entry's. Será retornada uma correspondência somente se houver uma vaga que contém CompaniesEntry base e a unidade dela corresponde ao units informado. Preencha um ou mais units.

Consulte CompensationInfo.CompensationEntry para ver a definição de entrada de remuneração base.

UNIT_AND_AMOUNT

Filtre por base compensation entry's unidade e quantidade / intervalo. Haverá correspondência de vaga somente se ela incluir CompaniesEntry base e a unidade da entrada base corresponder ao CompensationUnit fornecido, e o valor ou intervalo se sobrepuser ao CompensationRange fornecido.

Consulte CompensationInfo.CompensationEntry para ver a definição de entrada de remuneração base.

Defina exatamente um units e preencha range.

ANNUALIZED_BASE_AMOUNT

Filtre por valor de remuneração com base anual e unidade de base compensation entry's. Preencha range e zero ou mais units.

ANNUALIZED_TOTAL_AMOUNT

Filtre por valor de remuneração total anual e base compensation entry's unidade . Preencha range e zero ou mais units.

CompensationInfo

Detalhes da remuneração da vaga.

Campos
entries[]

CompensationEntry

Informações sobre remuneração da vaga.

No máximo, uma entrada pode ser do tipo CompensationInfo.CompensationType.BASE, que é conhecido como entrada de remuneração base da vaga.

annualized_base_compensation_range

CompensationRange

Apenas saída. Faixa de remuneração com base anual. Calculada como CompensationEntry.amount da entrada de remuneração base vezes CompensationEntry.expected_units_per_year.

Consulte CompensationEntry para ver uma explicação sobre anualização de remuneração.

annualized_total_compensation_range

CompensationRange

Apenas saída. Faixa de remuneração total anual. Calculada como CompensationEntry.amount vezes CompensationEntry.expected_units_per_year de todas as entradas de remuneração.

Consulte CompensationEntry para ver uma explicação sobre anualização de remuneração.

CompensationEntry

Uma entrada de remuneração que representa um componente de remuneração, como pagamento base, bônus ou outro tipo.

Anualização: uma entrada de remuneração pode ser anual se contiver amount ou range válidos. – e o expected_units_per_year dele está definido ou pode ser derivado. O intervalo anual é determinado como (amount ou range) vezes expected_units_per_year.

Campos
type

CompensationType

Tipo de remuneração.

O padrão é CompensationType.COMPENSATION_TYPE_UNSPECIFIED.

unit

CompensationUnit

Frequência do valor especificado.

O padrão é CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.

description

string

Descrição da remuneração. Por exemplo, ela pode indicar termos patrimoniais ou fornecer contexto adicional para um bônus estimado.

expected_units_per_year

DoubleValue

Número esperado de unidades pagas a cada ano. Se não for especificado, quando Job.employment_types for FULLTIME, um valor padrão será inferido com base em unit. Valores padrão: “HOURLY: 2080”, “DAILY: 260”, “WEEKLY: 52”, “MONTHLY: 12” e “ANNUAL: 1”.

Campo de união compensation_amount. Valor de remuneração. Pode ser um valor fixo ou um intervalo flutuante. compensation_amount só pode ser de um dos seguintes tipos:
amount

Money

Valor de remuneração.

range

CompensationRange

Intervalo de remuneração.

CompensationRange

Intervalo de remuneração.

Campos
max_compensation

Money

O valor máximo de remuneração. Se deixado em branco, o valor será definido como o valor máximo de remuneração e o código da moeda será definido para corresponder ao currency code de min_comparison.

min_compensation

Money

O valor mínimo de remuneração. Se deixado em branco, o valor será definido como zero e o código da moeda será definido para corresponder ao currency code de max_comparison.

CompensationType

O tipo de remuneração.

Para valores de remuneração especificados em valores não monetários, descreva o esquema de remuneração no CompensationEntry.description.

Por exemplo, o formato de gorjeta é descrito em CompensationEntry.description (por exemplo, "espera-se de 15 a 20% de gorjetas com base na conta do cliente") e uma estimativa das gorjetas fornecidas no CompensationEntry.amount ou CompensationEntry.range (US$ 10 por hora).

Por exemplo, a equidade é descrita em CompensationEntry.description (por exemplo, "1% - 2% de participação de capital ao longo de 4 anos, um penhasco de 1 ano") e o valor estimado em CompensationEntry.amount ou CompensationEntry.range. Se nenhuma estimativa de valor for possível, as unidades serão CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED e esclarecidas no campo CompensationEntry.description.

Tipos enumerados
COMPENSATION_TYPE_UNSPECIFIED Valor padrão.
BASE Remuneração base: refere-se ao valor fixo de dinheiro pago a um funcionário por um empregador em troca do trabalho realizado. A remuneração base não inclui benefícios, bônus ou outras remunerações em potencial de um empregador.
BONUS Bônus.
SIGNING_BONUS Bônus pela assinatura do contrato.
EQUITY Patrimônio.
PROFIT_SHARING Divisão de lucros.
COMMISSIONS Comissão.
TIPS Gorjetas.
OTHER_COMPENSATION_TYPE Outro tipo de remuneração.

CompensationUnit

Frequência de pagamento.

Tipos enumerados
COMPENSATION_UNIT_UNSPECIFIED Valor padrão.
HOURLY Por hora.
DAILY Por dia.
WEEKLY Por semana.
MONTHLY Por mês.
YEARLY Por ano.
ONE_TIME Uma vez.
OTHER_COMPENSATION_UNIT Outras unidades de remuneração.

CompleteQueryRequest

Parâmetros de preenchimento automático.

Campos
parent

string

Obrigatório. Nome do recurso do locatário em que a conclusão é realizada.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenant/bar".

Se o ID do locatário não for especificado, o locatário padrão será usado, por exemplo, "projects/foo".

query

string

Obrigatório. A consulta usada para gerar sugestões.

O número máximo de caracteres permitido é 255.

language_codes[]

string

A lista de idiomas da consulta. Este é o código de idioma BCP-47, como "pt-BR" ou "en-US". Para saber mais informações, consulte Tags para identificar idiomas.

O número máximo de caracteres permitido é 255.

page_size

int32

Obrigatório. Contagem do resultado do preenchimento.

O tamanho máximo de página permitido é 10.

company

string

Se fornecido, restringe o preenchimento à empresa especificada.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", por exemplo, "projects/foo/tenants/bar/Companies/baz".

Se o ID do locatário não for especificado, o locatário padrão será usado, por exemplo, "projects/foo".

scope

CompletionScope

O escopo do preenchimento. O padrão é CompletionScope.PUBLIC.

type

CompletionType

O tópico de preenchimento. O padrão é CompletionType.COMBINED.

CompletionScope

Enum para especificar o escopo do preenchimento.

Tipos enumerados
COMPLETION_SCOPE_UNSPECIFIED Valor padrão.
TENANT As sugestões são baseadas apenas nos dados fornecidos pelo cliente.
PUBLIC As sugestões são baseadas em todos os dados de vagas no sistema visíveis para o cliente.

CompletionType

Enum para especificar tópicos de preenchimento automático.

Tipos enumerados
COMPLETION_TYPE_UNSPECIFIED Valor padrão.
JOB_TITLE

Sugerir títulos para o preenchimento automático de vagas.

Para o tipo CompletionType.JOB_TITLE, apenas as vagas abertas com o mesmo language_codes são retornadas.

COMPANY_NAME

Sugerir nomes de empresas para o preenchimento automático de vagas de emprego.

Para o tipo CompletionType.COMPANY_NAME, somente empresas que têm vagas em aberto com o mesmo language_codes são retornadas.

COMBINED

Sugira cargos e nomes de empresas para o preenchimento automático de vagas de emprego.

Para o tipo CompletionType.COMBINED, são retornadas apenas vagas abertas com o mesmo language_codes ou empresas com vagas abertas com o mesmo language_codes.

CompleteQueryResponse

Resposta da consulta de preenchimento automático.

Campos
completion_results[]

CompletionResult

Resultados dos candidatos de emprego/empresa correspondentes.

metadata

ResponseMetadata

Mais informações para a invocação da API, como o código de rastreamento de solicitações.

CompletionResult

Recurso que representa os resultados do preenchimento.

Campos
suggestion

string

A sugestão para a consulta.

type

CompletionType

O tópico de preenchimento.

image_uri

string

O URI da imagem da empresa para COMPANY_NAME.

CreateClientEventRequest

A solicitação de evento de relatório.

Campos
parent

string

Obrigatório. Nome do recurso do locatário em que o evento é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado, por exemplo, "projects/foo".

client_event

ClientEvent

Obrigatório. Eventos emitidos na interação do usuário final com um aplicativo do cliente que usa o Cloud Talent Solution.

CreateCompanyRequest

A solicitação do método CreateCompany.

Campos
parent

string

Obrigatório. Nome do recurso do locatário em que a empresa é criada.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado, por exemplo, "projects/foo".

company

Company

Obrigatório. A empresa a ser criada.

CreateJobRequest

Cria solicitação de projeto.

Campos
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

job

Job

Obrigatório. A vaga de emprego a ser criada.

CreateTenantRequest

A solicitação do método CreateTenant.

Campos
parent

string

Obrigatório. Nome do recurso do projeto em que o locatário é criado.

O formato é "projects/{project_id}", por exemplo, "projects/foo".

tenant

Tenant

Obrigatório. O locatário a ser criado.

CustomAttribute

Valores de atributo personalizado que são filtráveis ​​ou não filtráveis.

Campos
string_values[]

string

É necessário especificar exatamente um entre string_values ou long_values.

Este campo é usado para executar uma pesquisa de correspondência de string (CASE_SENSITIVE_MATCH ou CASE_INSENSITIVE_MATCH). Para string_values filtráveis, é permitido um número total máximo de 200 valores, sendo que cada string_value tem um tamanho de byte de no máximo 500 BI. Para string_values não filtráveis, o tamanho total máximo de byte da string_values não filtrável é de 50 KB.

Não é permitido usar strings em branco.

long_values[]

int64

É necessário especificar exatamente um entre string_values ou long_values.

Esse campo é usado para executar a pesquisa por intervalo numérico. (EQ, GT, GE, LE, LT) sobre long_value filtrável.

No momento, é possível ter no máximo 1 long_values.

filterable

bool

Se a sinalização filterable for verdadeira, os valores dos campos personalizados poderão ser usados nos filtros de atributos personalizados JobQuery.custom_attribute_filter. Se for falso, esses valores não poderão ser usados para filtros de atributos personalizados.

O padrão é "false".

keyword_searchable

bool

Se a sinalização keyword_searchable for verdadeira, as palavras-chave nos campos personalizados poderão ser pesquisadas por correspondência de palavra-chave. Se for falso, os valores não serão pesquisáveis por correspondência de palavra-chave.

O padrão é "false".

DegreeType

Nível de escolaridade definido na Classificação Internacional Normalizada da Educação (ISCED, na sigla em inglês).

Tipos enumerados
DEGREE_TYPE_UNSPECIFIED Valor padrão. Não representa nenhuma formação ou educação infantil. Mapeia para o código ISCED 0. Ex.: jardim de infância.
PRIMARY_EDUCATION Educação primária, normalmente a primeira etapa do ensino obrigatório. Código ISCED 1. Ex.: ensino fundamental I.
LOWER_SECONDARY_EDUCATION Educação secundária baixa. Primeiro estágio do ensino secundário após a educação primária. Normalmente, com um currículo baseado em matérias. Código ISCED 2. Ex.: ensino fundamental II.
UPPER_SECONDARY_EDUCATION Educação secundária média. Segunda e última fase da educação secundária, que prepara para o ensino superior e/ou fornece competências profissionais relevantes. Normalmente tem mais opções de matérias e fluxos. Código ISCED 3. Ex.: ensino médio.
ADULT_REMEDIAL_EDUCATION Educação pós-secundária não superior. Cursos que proporcionam experiências de aprendizagem baseadas na educação secundária e preparam para a entrada no mercado de trabalho e/ou ensino superior. O conteúdo é mais amplo que o da educação secundária, mas não tão complexo quanto no ensino superior. Código ISCED 4.
ASSOCIATES_OR_EQUIVALENT Graduação tecnológica ou equivalente. Cursos curtos de ensino superior normalmente baseados na prática, específicos para uma profissão. Preparam para a entrada no mercado de trabalho. Esses cursos também podem abrir caminho para outros cursos de educação superior. Código ISCED 5.
BACHELORS_OR_EQUIVALENT Bacharelado ou equivalente. Cursos destinados a fornecer conhecimentos, habilidades e competências acadêmicos e/ou profissionais médios conducentes a um primeiro diploma de nível superior ou qualificação equivalente. Código ISCED 6.
MASTERS_OR_EQUIVALENT Mestrado, especialização ou equivalente. Cursos concebidos para fornecer conhecimentos, habilidades e competências acadêmicos e/ou profissionais avançados conducentes a um segundo diploma de ensino superior ou qualificação equivalente. Código ISCED 7.
DOCTORAL_OR_EQUIVALENT Doutorado ou equivalente. Cursos destinados principalmente a uma qualificação avançada de pesquisa, normalmente concluindo com a entrega e defesa de uma dissertação substantiva de qualidade publicável baseada em uma pesquisa original. Código ISCED 8.

DeleteCompanyRequest

Solicitação para excluir uma empresa.

Campos
name

string

Obrigatório. O nome de recurso da empresa a ser excluída.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", por exemplo, "projects/foo/tenants/bar/Companies/baz".

Se o ID do locatário não for especificado, o locatário padrão será usado, por exemplo, "projects/foo/Companies/bar".

DeleteJobRequest

Exclui solicitações de vaga.

Campos
name

string

Obrigatório. O nome de recurso da vaga a ser excluída.

O formato é "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Por exemplo, "projects/foo/tenants/bar/jobs/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/jobs/bar".

DeleteTenantRequest

Solicitação para excluir um locatário.

Campos
name

string

Obrigatório. O nome do recurso do locatário a ser excluído.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenants/bar".

DeviceInfo

Informações de dispositivo coletadas do pesquisador de empregos, do candidato ou de outra entidade que realize a pesquisa de vagas. Essa informação melhora a qualidade dos resultados da pesquisa nos dispositivos.

Campos
device_type

DeviceType

Tipo de dispositivo.

id

string

Um ID específico do dispositivo. O ID precisa ser um identificador exclusivo que distingue o dispositivo de outros.

DeviceType

Uma enumeração que descreve um portal de acesso à API e um mecanismo de exposição.

Tipos enumerados
DEVICE_TYPE_UNSPECIFIED O tipo de dispositivo não é especificado.
WEB Um navegador da Web para desktop, como Chrome, Firefox, Safari ou Internet Explorer.
MOBILE_WEB Um navegador da Web para dispositivos móveis, como smartphones ou tablets com navegador Chrome.
ANDROID Um aplicativo nativo para dispositivos Android.
IOS Um aplicativo nativo para dispositivos iOS.
BOT Um bot, ao contrário de um dispositivo operado por seres humanos, como um rastreador da web.
OTHER Outros tipos de dispositivo.

EmploymentType

Um enum que representa o tipo de emprego de uma vaga.

Tipos enumerados
EMPLOYMENT_TYPE_UNSPECIFIED O valor padrão caso o tipo de emprego não esteja especificado.
FULL_TIME Para ser considerado emprego de tempo integral, o cargo exige um determinado número de horas por semana, normalmente 40 horas ou mais.
PART_TIME O cargo exige menos horas por semana do que um emprego de tempo integral, normalmente menos de 40 horas.
CONTRACTOR O cargo é oferecido como uma função contratada, e não de empregado assalariado.
CONTRACT_TO_HIRE O cargo é oferecido como uma função contratada que será convertida em tempo integral no final do contrato. As vagas desse tipo também são retornadas pela pesquisa por EmploymentType.CONTRACTOR.
TEMPORARY O cargo é oferecido como uma oportunidade de emprego temporário, geralmente uma contratação por curto prazo.
INTERN O cargo é uma oportunidade com prazo fixo para estudantes ou candidatos no nível básico terem treinamento no local de trabalho. Muitas vezes é oferecido como um trabalho de férias.
VOLUNTEER O cargo é uma oportunidade de voluntariado, quando não há expectativa de remuneração pelos serviços prestados.
PER_DIEM O cargo exige que o funcionário trabalhe conforme a necessidade, com um horário flexível.
FLY_IN_FLY_OUT A vaga envolve empregar pessoas em áreas remotas e levá-las temporariamente ao local de trabalho, em vez de realocar os funcionários e suas famílias permanentemente.
OTHER_EMPLOYMENT_TYPE A vaga não se enquadra em nenhum dos outros tipos listados.

GetCompanyRequest

Solicitação para adquirir uma empresa pelo nome.

Campos
name

string

Obrigatório. O nome de recurso da empresa a ser recuperada.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}", por exemplo, "projects/api-test-project/tenants/foo/Companies/bar".

Se o ID do locatário não for especificado, o locatário padrão será usado, por exemplo, "projects/api-test-project/companies/bar".

GetJobRequest

Faz uma solicitação de vaga.

Campos
name

string

Obrigatório. O nome do recurso da vaga a ser recuperada.

O formato é "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Por exemplo, "projects/foo/tenants/bar/jobs/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/jobs/bar".

GetTenantRequest

Solicitação para conseguir um locatário por nome.

Campos
name

string

Obrigatório. O nome do recurso do locatário a ser recuperado.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenants/bar".

HistogramQuery

A solicitação de histograma.

Campos
histogram_query

string

Uma expressão especifica uma solicitação de histograma para recursos correspondentes (por exemplo, vagas, perfis) para pesquisas.

Consulte SearchJobsRequest.histogram_queries e SearchProfilesRequest.histogram_queries para mais detalhes sobre a sintaxe.

HistogramQueryResult

Resultado do histograma que corresponde a HistogramQuery especificado nas pesquisas.

Campos
histogram_query

string

Expressão solicitada do histograma.

histogram

map<string, int64>

Um mapa dos valores do atributo associados a valores distintos ao número de entradas correspondentes com o valor correspondente.

O formato principal é:

  • (para histograma de string) valores de string armazenados no campo.
  • (para bucket numérico nomeado) especificado na função bucket(), como para bucket(0, MAX, "non-negative"), a chave será non-negative.
  • (para buckets numéricos anônimos) formatado como <low>-<high>, por exemplo, 0-1000, MIN-0 e 0-MAX.

HtmlSanitization

Opção para sanitização do conteúdo HTML nos campos preenchidos pelo usuário, como a descrição da vaga. Ao definir essa opção, o usuário pode determinar se e como a sanitização é executada nesses campos.

Enums
HTML_SANITIZATION_UNSPECIFIED Valor padrão.
HTML_SANITIZATION_DISABLED Desativa a sanitização na entrada HTML.
SIMPLE_FORMATTING_ONLY Realiza a sanitização da entrada HTML, só aceita negrito, itálico, lista ordenada e tags de marcação de lista não ordenada.

Job

Um recurso Job representa uma postagem de vagas de trabalho (também conhecida como "lista de empregos" ou "requisição de trabalho"). Uma vaga pertence a um Company, que é a entidade contratante responsável por ela.

Campos
name

string

Necessário durante a atualização da vaga.

O nome do recurso para a vaga. É gerado pelo serviço quando uma vaga é criada.

O formato é "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Por exemplo, "projects/foo/tenants/bar/jobs/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/jobs/bar".

O uso deste campo em consultas de job e chamadas de API tem preferência sobre o uso de requisition_id porque esse valor é exclusivo.

company

string

Obrigatório. O nome de recurso da empresa que anuncia a vaga.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}". Por exemplo, "projects/foo/tenants/bar/Companies/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/empresas/bar".

requisition_id

string

Obrigatório. O código da requisição, também conhecido como código de postagem, atribuído pelo cliente para identificar uma vaga. Este campo é destinado à identificação do cliente e ao rastreamento de postagens pelos clientes. Não será possível criar um job se houver outro com os mesmos company, language_code e requisition_id.

O número máximo de caracteres permitido é 255.

title

string

Obrigatório. O título do cargo, como “Engenheiro de software”.

O número máximo de caracteres permitidos é 500.

description

string

Obrigatório. A descrição da vaga, que normalmente inclui uma descrição de vários parágrafos sobre a empresa e informações relacionadas. São fornecidos campos separados no objeto de vaga para responsibilities, qualifications e outras características. É recomendado o uso desses campos separados.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 100.000.

addresses[]

string

É altamente recomendado para melhorar a experiência de atendimento.

Locais em que o empregador está buscando contratar para a vaga.

A especificação do endereço completo do local de contratação permite melhores resultados de API, especialmente pesquisas de vagas por tempo de deslocamento.

No máximo, 50 locais são permitidos para melhor desempenho de pesquisa. Se um job tiver mais locais, é recomendável dividi-lo em vários com requisition_ids exclusivos (por exemplo, "ReqA" se torna "ReqA-1", "ReqA-2" e assim por diante), já que não são permitidos vários jobs com os mesmos company, language_code e requisition_id. Se o requisition_id original precisar ser preservado, use um campo personalizado para armazenamento. Também é sugerido agrupar os locais próximos uns dos outros na mesma vaga para uma melhor experiência de pesquisa.

O número máximo de caracteres permitidos é 500.

application_info

ApplicationInfo

Informações de candidatura à vaga.

job_benefits[]

JobBenefit

Os benefícios incluídos na vaga.

compensation_info

CompensationInfo

Informações de remuneração do trabalho (também conhecida como "taxa de pagamento"), ou seja, a remuneração que será paga ao funcionário.

custom_attributes

map<string, CustomAttribute>

Um mapa de campos para manter atributos de vaga personalizados filtráveis e não filtráveis não cobertos pelos campos estruturados fornecidos.

As chaves do mapa são strings de até 64 bytes e precisam corresponder ao padrão: [a-zA-Z][a-zA-Z0-9_]*. Por exemplo, chave0DestaForma ou CHAVE_1_DESTA_FORMA.

No máximo, 100 chaves filtráveis e 100 não filtráveis são compatíveis. Para string_values filtrável, em todas as chaves são permitidos no máximo 200 valores, com cada string com até 255 caracteres. Para string_values não filtrável, o tamanho total máximo de string_values em todas as chaves é de 50 KB.

degree_types[]

DegreeType

Os níveis de escolaridade desejados para o cargo, como Bacharelado e Mestrado.

department

string

O departamento ou a área funcional dentro da empresa com a vaga em aberto.

O número máximo de caracteres permitido é 255.

employment_types[]

EmploymentType

Os tipos de emprego de uma vaga, por exemplo, full time ou part time.

incentives

string

Uma descrição de bônus, comissões e outros incentivos de remuneração associados ao cargo que não sejam o salário ou pagamento.

O número máximo de caracteres permitidos é 10.000.

language_code

string

O idioma da postagem. Este campo é diferente de qualquer requisito de fluência associado ao cargo.

Os códigos de idioma precisam estar no formato BCP-47, como “pt-BR” ou “en-US”. Para mais informações, consulte Tags para identificar idiomas{: class="external" target="_blank" } (em inglês).

Se esse campo não for especificado e Job.description estiver presente, o código do idioma detectado com base em Job.description será atribuído. Caso contrário, o padrão será "en_US".

job_level

JobLevel

O nível de experiência associado à vaga, como “Nível básico”.

promotion_value

int32

Um valor de promoção da vaga de emprego, conforme determinado pelo cliente. O valor determina a ordem de classificação das vagas retornadas na pesquisa usando a chamada de vagas em destaque, com os valores promocionais mais elevados sendo retornados primeiro e os empates sendo resolvidos por ordem de relevância. Somente as vagas com promotionValue > 0 são retornadas na FEATURED_JOB_SEARCH.

O valor padrão é 0, e os valores negativos são tratados como 0.

qualifications

string

Uma descrição das qualificações necessárias para realizar o trabalho. É recomendável usar este campo como alternativa ao campo description, que é mais geral.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 10.000.

responsibilities

string

Uma descrição das responsabilidades do cargo. É recomendável usar este campo como alternativa ao campo description, que é mais geral.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitidos é 10.000.

posting_region

PostingRegion

A PostingRegion da vaga (por exemplo, estado ou país) em que a vaga está disponível. Se este campo estiver definido, um LocationFilter em uma consulta de pesquisa na região da vaga encontrará essa vaga se o local exato não estiver especificado. Se este campo for definido como PostingRegion.NATION ou PostingRegion.ADMINISTRATIVE_AREA, é recomendável configurar a vaga Job.addresses no mesmo nível de local deste campo.

visibility
(deprecated)

Visibility

Obsoleto. A tarefa é visível apenas para o proprietário.

A visibilidade da vaga.

Se nada for especificado, o padrão será Visibility.ACCOUNT_ONLY.

job_start_time

Timestamp

O carimbo de data/hora de início da vaga no fuso horário UTC. Normalmente, este campo é usado para contratações. Carimbos de data/hora inválidos são ignorados.

job_end_time

Timestamp

O carimbo de data/hora da vaga. Normalmente, este campo é usado para contratações. Carimbos de data/hora inválidos são ignorados.

posting_publish_time

Timestamp

O carimbo de data/hora da publicação mais recente da vaga. O valor padrão é o tempo que a solicitação leva para chegar ao servidor. Carimbos de data/hora inválidos são ignorados.

posting_expire_time

Timestamp

É altamente recomendado para melhorar a experiência de atendimento.

O carimbo de data/hora de expiração da vaga. Após esse carimbo de data/hora, a vaga é marcada como expirada e deixa de ser exibida nos resultados da pesquisa. O job expirado não pode ser listado pela API ListJobs, mas pode ser recuperado com a API GetJob, atualizado com a API UpdateJob ou excluído com a API DeleteJob. Uma vaga expirada pode ser atualizada e aberta novamente usando um carimbo de data/hora de expiração futuro. A atualização de um job expirado falhará se houver outro job aberto com os mesmos company, language_code e requisition_id.

As vagas expiradas são mantidas no sistema por 90 dias. No entanto, a contagem geral de vagas expiradas não pode exceder três vezes o número máximo de vagas em aberto nos últimos sete dias. Se esse limite for excedido, os jobs expirados serão limpos na ordem de data de expiração mais próxima. As vagas expiradas deixarão de ser acessíveis depois de serem apagadas.

Carimbos de data/hora inválidos são ignorados e tratados como se o prazo de validade não fosse fornecido.

Se o carimbo de data/hora for anterior à solicitação instantânea, o job será tratado como expirado imediatamente na criação. Não é possível atualizar esse tipo de job. Ao criar um job com carimbo de data/hora no passado, o posting_publish_time precisa ser definido antes de posting_expire_time. O objetivo desse recurso é permitir que outros objetos, como Application, indiquem um job que não existia no sistema antes de expirar. Se você quiser modificar uma tarefa que expirou na criação, exclua-a e crie uma nova.

Se esse valor não for fornecido na criação da vaga ou for inválido, a postagem expirará em 30 dias contados a partir do horário de criação dela. Por exemplo, se a vaga foi criada em 01/01/2017 às 13h UTC com data de validade não especificada, ela expirará após as 13h UTC de 31/01/2017.

Se esse valor não for fornecido na atualização da vaga, ele dependerá das máscaras de campo definidas por UpdateJobRequest.update_mask. Se as máscaras de campo incluírem job_end_time ou estiverem vazias, o que significa que todos os campos serão atualizados, a oferta de emprego vai expirar 30 dias após o horário da última atualização. Do contrário, a data de expiração não será atualizada.

posting_create_time

Timestamp

Apenas saída. O carimbo de data/hora em que a vaga foi criada.

posting_update_time

Timestamp

Apenas saída. O carimbo de data/hora em que a vaga foi atualizada pela última vez.

company_display_name

string

Apenas saída. O nome da empresa que oferece a vaga.

derived_info

DerivedInfo

Apenas saída. Detalhes derivados sobre a vaga.

processing_options

ProcessingOptions

Opções para processamento de vagas.

ApplicationInfo

Detalhes da candidatura à vaga.

Campos
emails[]

string

Use este campo para especificar os endereços de e-mail que receberão currículos ou inscrições.

O número máximo de caracteres permitidos para cada entrada é 255.

instruction

string

Use este campo para fornecer instruções, como "Envie sua inscrição por e-mail para...", que um candidato pode seguir para se candidatar à vaga.

Este campo aceita e limpa a entrada de HTML, além de aceitar tags de marcação de negrito, itálico, lista ordenada e lista não ordenada.

O número máximo de caracteres permitido é 3.000.

uris[]

string

Use este campo de URI para direcionar um candidato para um site. Por exemplo, para acessar um formulário de inscrição on-line.

O número máximo de caracteres permitidos para cada entrada é 2.000.

DerivedInfo

Detalhes derivados sobre a vaga.

Campos
locations[]

Location

Locais estruturados da vaga, resolvidos a partir de Job.addresses.

locations correspondem exatamente a Job.addresses, na mesma ordem.

job_categories[]

JobCategory

Categorias de emprego derivadas de Job.title e Job.description.

ProcessingOptions

Opções para processamento de vagas.

Campos
disable_street_address_resolution

bool

Se definido como true, o serviço não tentará resolver um endereço mais preciso para a vaga.

html_sanitization

HtmlSanitization

Opção para sanitização do conteúdo HTML da vaga. Aplica-se aos campos:

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

As tags HTML desses campos poderão ser removidas se a sanitização não estiver desativada.

O valor padrão é HtmlSanitization.SIMPLE_FORMATTING_ONLY.

JobBenefit

Um enum que representa os benefícios incluídos no cargo para os funcionários.

Tipos enumerados
JOB_BENEFIT_UNSPECIFIED Valor padrão caso o tipo não seja especificado.
CHILD_CARE O cargo inclui acesso a programas de assistência infantil, como creche.
DENTAL O cargo inclui serviços odontológicos cobertos por um plano de assistência odontológica.
DOMESTIC_PARTNER O cargo oferece benefícios específicos para companheiros(as).
FLEXIBLE_HOURS O cargo permite horário de trabalho flexível.
MEDICAL O cargo inclui serviços médicos cobertos por um plano de assistência médica.
LIFE_INSURANCE O cargo inclui um seguro de vida fornecido pelo empregador ou disponível para compra pelo funcionário.
PARENTAL_LEAVE O cargo permite licença para cuidar de filho recém-nascido.
RETIREMENT_PLAN O cargo inclui um plano de aposentadoria fornecido pelo empregador ou disponível para compra pelo funcionário.
SICK_DAYS O cargo permite licença remunerada por motivo de doença.
VACATION O cargo inclui férias remuneradas.
VISION O cargo inclui serviços oftalmológicos cobertos por um plano de assistência oftalmológica.

JobCategory

Um enum representa a categorização ou o foco principal do papel específico. Este valor é diferente do setor associado a um papel, que está relacionado à categorização da empresa que lista a vaga de trabalho.

Enums
JOB_CATEGORY_UNSPECIFIED O valor padrão caso a categoria não seja especificada.
ACCOUNTING_AND_FINANCE Uma vaga na área de contabilidade e finanças, como contador.
ADMINISTRATIVE_AND_OFFICE Uma vaga na área administrativa, como assistente administrativo.
ADVERTISING_AND_MARKETING Uma vaga na área de publicidade e marketing, como gerente de marketing.
ANIMAL_CARE Uma vaga na área de cuidados com os animais, como veterinário.
ART_FASHION_AND_DESIGN Uma vaga na área de arte, moda ou design, como designer.
BUSINESS_OPERATIONS Uma vaga na área de operações comerciais, como gerente de operações comerciais.
CLEANING_AND_FACILITIES Uma vaga na área de limpeza e instalações, como faxineiro.
COMPUTER_AND_IT Uma vaga na área de informática e TI, como administrador de sistemas.
CONSTRUCTION Uma vaga na área de construção, como auxiliar geral.
CUSTOMER_SERVICE Uma vaga na área de atendimento ao cliente, como caixa.
EDUCATION Uma vaga na área de educação, como professor.
ENTERTAINMENT_AND_TRAVEL Uma vaga na área de entretenimento e viagens, como comissário de bordo.
FARMING_AND_OUTDOORS Uma vaga na área agrícola ou ao ar livre, como guarda florestal.
HEALTHCARE Uma vaga na área da saúde, como enfermeira.
HUMAN_RESOURCES Uma vaga na área de recursos humanos, como diretor de recursos humanos.
INSTALLATION_MAINTENANCE_AND_REPAIR Uma vaga na área de instalação, manutenção ou reparo, como eletricista.
LEGAL Uma vaga na área jurídica, como assistente jurídico.
MANAGEMENT Uma vaga na área de gerenciamento, usada normalmente em conjunto com outra categoria, como gerente de loja.
MANUFACTURING_AND_WAREHOUSE Uma vaga em fábrica ou depósito, como técnico de montagem.
MEDIA_COMMUNICATIONS_AND_WRITING Uma vaga na área de mídia, comunicação ou escrita, como relações com a mídia.
OIL_GAS_AND_MINING Uma vaga na área de petróleo, gás ou mineração, como sondador.
PERSONAL_CARE_AND_SERVICES Uma vaga na área de serviços e cuidados pessoais, como cabeleireiro.
PROTECTIVE_SERVICES Uma vaga na área de serviços de proteção, como vigilante.
REAL_ESTATE Uma vaga na área imobiliária, como corretor.
RESTAURANT_AND_HOSPITALITY Uma vaga em hotel ou restaurante, como garçom.
SALES_AND_RETAIL Uma vaga na área de vendas e/ou varejo, como representante de vendas.
SCIENCE_AND_ENGINEERING Uma vaga no setor de ciência e engenharia, como técnico de laboratório.
SOCIAL_SERVICES_AND_NON_PROFIT Uma vaga em serviço social ou em uma organização sem fins lucrativos, como assistente social.
SPORTS_FITNESS_AND_RECREATION Uma vaga na área de esportes, fitness ou recreação, como treinador pessoal.
TRANSPORTATION_AND_LOGISTICS Uma vaga na área de transporte ou logística, como motorista de caminhão.

JobEvent

Um evento emitido quando um candidato a emprego interage com o aplicativo que implementa o Cloud Talent Solution.

Campos
type

JobEventType

Obrigatório. O tipo do evento (consulte JobEventType).

jobs[]

string

Obrigatório. O job name(s) associado ao evento. Por exemplo, se for um evento de impression, este campo conterá os identificadores de todas as vagas mostradas ao candidato. Se for um evento view, esse campo conterá o identificador do job visualizado.

O formato é "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", por exemplo, "projects/foo/tenants/bar/jobs/baz".

profile

string

O profile name associado a esse evento do cliente.

O formato é "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", por exemplo, "projects/foo/tenants/bar/profiles/baz".

JobEventType

Uma enumeração de um evento atribuído ao comportamento do usuário final, como um candidato à vaga.

Tipos enumerados
JOB_EVENT_TYPE_UNSPECIFIED O evento não está especificado por outros valores fornecidos.
IMPRESSION O candidato a emprego ou outra entidade que interage com o serviço teve um trabalho representado na visualização, como em uma lista de resultados de pesquisa em um formato compactado ou cortado. Este evento geralmente está associado à visualização de uma lista de vagas em uma única página por um candidato.
VIEW O candidato ou outra entidade que interage com o serviço visualizou todos os detalhes de uma vaga, incluindo a descrição completa. Esse evento não se aplica à visualização de um snippet de uma vaga que aparece como parte dos resultados da procura de emprego. A visualização de um snippet está associada a um impression.
VIEW_REDIRECT O candidato ou outra entidade que interage com o serviço realizou uma ação para visualizar uma vaga e foi redirecionado para um site diferente.
APPLICATION_START O candidato a emprego ou outra entidade que interage com o serviço iniciou o processo ou demonstrou a intenção de se candidatar a um emprego.
APPLICATION_FINISH O candidato a emprego ou outra entidade que interage com o serviço apresentou um pedido de emprego.
APPLICATION_QUICK_SUBMISSION O candidato à vaga ou outra entidade que interage com o serviço enviou uma inscrição à vaga com um único clique sem inserir informações. Se um candidato executar essa ação, envie apenas esse evento para o serviço. Também não envie eventos JobEventType.APPLICATION_START ou JobEventType.APPLICATION_FINISH.
APPLICATION_REDIRECT O candidato ou outra entidade que interage com o serviço realizou uma ação para se inscrever a uma vaga e foi redirecionado para um site diferente para concluir a inscrição.
APPLICATION_COMPANY_SUBMIT Este evento deve ser usado quando uma empresa envia uma inscrição em nome de um candidato. Esse evento é destinado a agências de recrutamento que tentam recolocar candidatos.
BOOKMARK O candidato a emprego ou outra entidade que interage com o serviço demonstrou interesse em uma vaga marcando-a ou salvando-a.
NOTIFICATION O candidato ou outra entidade que interage com o serviço recebeu uma notificação, como um alerta por e-mail ou uma notificação de dispositivo, contendo uma ou mais listagens de vagas geradas pelo serviço.
HIRED O candidato à vaga ou outra entidade que interage com o serviço foi empregado pela entidade contratante (empregador). Envie este evento somente se o candidato foi contratado por meio de uma inscrição iniciada por uma pesquisa realizada pelo serviço Cloud Talent Solution.
SENT_CV Um recrutador ou agência de emprego enviou uma inscrição em nome do candidato depois de interagir com o serviço para identificar uma oferta de emprego adequada.
INTERVIEW_GRANTED A entidade que interage com o serviço (por exemplo, o candidato) participou de uma entrevista inicial concedida pela entidade contratante (empregador). Este evento apenas deverá ser enviado se o candidato tiver participado de uma entrevista como parte de uma inscrição iniciada por uma pesquisa realizada ou recomendação fornecida pelo serviço Cloud Talent Solution.

JobLevel

Um enum que representa o nível de experiência exigido para o cargo.

Tipos enumerados
JOB_LEVEL_UNSPECIFIED O valor padrão caso o nível não seja especificado.
ENTRY_LEVEL Colaboradores individuais no nível básico, normalmente com menos de dois anos de experiência em função semelhante. Inclui estagiários.
EXPERIENCED Colaboradores individuais experientes, normalmente com mais de 2 anos de experiência em função semelhante.
MANAGER Gerentes de nível básico a intermediário que são responsáveis por uma equipe.
DIRECTOR Gerentes de nível sênior que são responsáveis por equipes de gerentes.
EXECUTIVE Gerentes de nível executivo ou superior, incluindo cargos de diretoria.

JobOperationResult

O resultado das APIs JobService.BatchCreateJobs ou JobService.BatchUpdateJobs. Ele será usado para substituir google.longrunning.Operation.response em caso de êxito.

Campos
job_results[]

JobResult

Lista de resultados de mutação do trabalho de uma operação mutate em lote. Ele pode mudar até que o status de operação seja FINISHED, FAILED ou CANCELLED.

JobResult

Resultado da mutação de um job.

Campos
job

Job

Aqui, Job contém apenas informações básicas, incluindo name, company, language_code e requisition_id. Use o método getJob para recuperar informações detalhadas do job criado/atualizado.

status

Status

O status do trabalho processado. Esse campo será preenchido se o processamento da job falhar.

JobQuery

A consulta necessária para executar uma consulta de pesquisa.

Campos
query

string

A string de consulta que corresponde aos campos de cargo, descrição e local da vaga.

O número máximo de caracteres permitido é 255.

query_language_code

string

O código de idioma de query. Por exemplo, "en-US". Esse campo ajuda a interpretar melhor a consulta.

Se um valor não for especificado, o código do idioma da consulta será detectado automaticamente, o que pode não ser preciso.

O código de idioma precisa estar no formato BCP-47, como "pt-BR" ou "en-US". Para saber mais informações, consulte Tags para identificar idiomas.

companies[]

string

Este filtro especifica as entidades de empresa para pesquisar.

Se um valor não for especificado, as vagas serão pesquisadas ​​em todas as empresas.

Se muitos valores forem especificados, as vagas serão pesquisadas nas empresas informadas.

O formato é "projects/{project_id}/tenants/{tenant_id}/Companies/{company_id}". Por exemplo, "projects/foo/tenants/bar/Companies/baz".

Se o ID do locatário não for especificado, será usado o locatário padrão. Por exemplo, "projects/foo/empresas/bar".

No máximo, 20 filtros de empresa são permitidos.

location_filters[]

LocationFilter

O filtro de local especifica as regiões geográficas que contêm as vagas de emprego a pesquisar. Consulte LocationFilter para mais informações.

Se nenhum valor de local for especificado, as vagas que atenderem a outros critérios de pesquisa serão recuperadas, seja qual for o local.

Se vários valores forem especificados, as vagas serão recuperadas de qualquer um dos locais especificados. Se valores diferentes forem especificados para o parâmetro LocationFilter.distance_in_miles, a distância máxima fornecida será usada para todos os locais.

No máximo, cinco filtros de local são permitidos.

job_categories[]

JobCategory

O filtro de categoria especifica as categorias de vagas a pesquisar. Consulte JobCategory para mais informações.

Se um valor não for especificado, serão pesquisadas as vagas de qualquer categoria.

Se muitos valores forem especificados, as vagas de qualquer categoria especificada serão pesquisadas.

commute_filter

CommuteFilter

Permite filtrar vagas por tempo de deslocamento diário em meios de transporte diferentes. Por exemplo, de carro ou transporte público.

Observação: isso só funciona quando você especifica um CommuteMethod. Nesse caso, location_filters é ignorado.

Por enquanto, não há como classificar por tempo de deslocamento diário.

company_display_names[]

string

Este filtro especifica a empresa exata Company.display_name das vagas a serem pesquisadas.

Se um valor não for especificado, as vagas nos resultados da pesquisa serão associadas a qualquer empresa.

Se vários valores forem especificados, as vagas nos resultados da pesquisa poderão ser associadas a qualquer uma das empresas especificadas.

No máximo, 20 filtros de nome de exibição da empresa são permitidos.

compensation_filter

CompensationFilter

Este filtro de pesquisa é aplicado apenas a Job.compensation_info. Por exemplo, se o filtro for especificado como "Vaga com remuneração por hora > US$ 15", somente as vagas que atenderem a esses critérios serão pesquisadas. Se nenhum filtro for definido, todas as vagas abertas serão pesquisadas.

custom_attribute_filter

string

Este filtro especifica uma sintaxe estruturada para corresponder ao Job.custom_attributes marcado como filterable.

A sintaxe dessa expressão é um subconjunto da sintaxe do SQL.

Os operadores aceitos são: =, !=, <, <=, > e >=, em que o lado esquerdo do operador é uma chave de campo personalizado e o à direita é um número ou uma string entre aspas. É preciso escapar caracteres de barra invertida (\) e aspas (").

As funções com suporte são LOWER([field_name]) para executar uma correspondência indiferente a maiúsculas e EMPTY([field_name]) para filtrar a existência de uma chave.

As expressões booleanas (AND/OR/NOT) são compatíveis com até três níveis de aninhamento. Por exemplo, "((A AND B AND C) OR NOT D) AND E"), e pode haver no máximo 100 comparações ou funções na expressão. A expressão precisa ter < 6.000 bytes.

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

disable_spell_check

bool

Esta sinalização controla o recurso de verificação ortográfica. Caso seja falso, o serviço tenta corrigir uma consulta com erro ortográfico, por exemplo, "engenaria" é corrigida para "engenharia".

Assume falso como padrão: uma verificação ortográfica é realizada.

employment_types[]

EmploymentType

O filtro de tipo de emprego especifica o tipo de emprego das vagas a serem pesquisadas, como EmploymentType.FULL_TIME.

Se um valor não for especificado, as vagas nos resultados da pesquisa incluirão qualquer tipo de emprego.

Se vários valores forem especificados, as vagas nos resultados da pesquisa incluirão qualquer um dos tipos de emprego especificados.

language_codes[]

string

Este filtro especifica a localidade das vagas a serem pesquisadas. Por exemplo, "pt-BR".

Se um valor não for especificado, os resultados da pesquisa poderão incluir vagas em qualquer localidade.

Os códigos de idioma precisam estar no formato BCP-47. Por exemplo, “pt-BR” ou “en-US”. Para mais informações, consulte Tags para identificar idiomas.

No máximo, dez filtros de código de idioma são permitidos.

publish_time_range

TimestampRange

Serão pesquisadas as vagas publicadas dentro de um intervalo especificado por este filtro.

excluded_jobs[]

string

Este filtro especifica uma lista de nomes de vagas a serem excluídos durante a pesquisa.

São permitidos no máximo 400 nomes de vagas excluídos.

JobView

Um enum que especifica os atributos da vaga retornados nos campos MatchingJob.job ou ListJobsResponse.jobs.

Tipos enumerados
JOB_VIEW_UNSPECIFIED Valor padrão.
JOB_VIEW_ID_ONLY Uma visualização da vaga somente para ID com os seguintes atributos: Job.name, Job.requisition_id, Job.language_code.
JOB_VIEW_MINIMAL Uma visualização mínima do job, com estes atributos: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.language_code.
JOB_VIEW_SMALL Uma pequena visualização da vaga, com os seguintes atributos nos resultados da pesquisa: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.visibility, Job.language_code, Job.description.
JOB_VIEW_FULL Todos os atributos disponíveis estão incluídos nos resultados da pesquisa.

ListCompaniesRequest

Lista as empresas para as quais o cliente tem visibilidade ACL.

Campos
parent

string

Obrigatório. Nome do recurso do locatário em que a empresa é criada.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenant/bar".

Se o ID do locatário não for especificado, o locatário padrão será usado, por exemplo, "projects/foo".

page_token

string

O indicador inicial para retornar os resultados.

page_size

int32

O número máximo de empresas a serem retornadas, que é 100. O padrão é 100 caso um número não positivo seja fornecido.

require_open_jobs

bool

Defina como "true" caso as empresas solicitadas precisem ter vagas abertas.

O padrão é "false".

Se verdadeiro, no máximo page_size empresas são buscadas, entre as quais apenas aquelas com vagas em aberto são retornadas.

ListCompaniesResponse

O objeto de resposta da Lista de empresas.

Campos
companies[]

Company

Empresas do cliente atual.

next_page_token

string

Um token para recuperar a próxima página de resultados.

metadata

ResponseMetadata

Mais informações para a invocação da API, como o código de rastreamento de solicitações.

ListJobsRequest

Solicitação Listar vagas.

Campos
parent

string

Obrigatório. O nome do recurso do locatário em que o job é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

filter

string

Obrigatório. A string de filtro especifica as vagas que serão enumeradas.

Operador aceito: =, AND

Os campos qualificados para filtragem são:

  • companyName (obrigatório)
  • requisitionId
  • status Valores disponíveis: OPEN, EXPIRED, ALL. O padrão será OPEN se nenhum valor for especificado.

Consulta de amostra:

  • companyName = "projects/foo/tenants/bar/Companies/baz"
  • empresaName = "projects/foo/tenants/bar/Companies/baz" AND requisitionId = "req-1"
  • empresaName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED"
page_token

string

O ponto de partida do resultado de uma consulta.

page_size

int32

O número máximo de vagas a serem retornadas por página de resultados.

Se job_view for definido como JobView.JOB_VIEW_ID_ONLY, o tamanho máximo permitido da página será 1.000. Caso contrário, o tamanho máximo permitido da página será 100.

O padrão é 100, caso vazio, ou um número < 1 é especificado.

job_view

JobView

Os atributos desejados da vaga retornados para vagas na resposta da pesquisa. O padrão será JobView.JOB_VIEW_FULL se nenhum valor for especificado.

ListJobsResponse

Listar resposta de vagas.

Campos
jobs[]

Job

As vagas de emprego de uma determinada empresa.

O número máximo de itens retornados se baseia no campo de limite fornecido na solicitação.

next_page_token

string

Um token para recuperar a próxima página de resultados.

metadata

ResponseMetadata

Mais informações para a invocação da API, como o código de rastreamento de solicitações.

ListTenantsRequest

Liste os locatários para os quais o cliente tem visibilidade da ACL.

Campos
parent

string

Obrigatório. Nome do recurso do projeto em que o locatário é criado.

O formato é "projects/{project_id}", por exemplo, "projects/foo".

page_token

string

O indicador inicial para retornar os resultados.

page_size

int32

O número máximo de locatários a serem retornados, que é 100. O padrão é 100 caso um número não positivo seja fornecido.

ListTenantsResponse

O objeto de resposta List de locatários.

Campos
tenants[]

Tenant

Locatários do cliente atual.

next_page_token

string

Um token para recuperar a próxima página de resultados.

metadata

ResponseMetadata

Mais informações para a invocação da API, como o código de rastreamento de solicitações.

Local

Esse recurso representa um local com informações geográficas completas.

Campos
location_type

LocationType

O tipo de local, que corresponde ao campo de linhas de endereço de google.type.PostalAddress. Por exemplo, "Centro, Atlanta, GA, EUA" tem o tipo LocationType.NEIGHBORHOOD, e "Kansas City, KS, EUA" tem o tipo LocationType.LOCALITY.

postal_address

PostalAddress

O endereço postal do local que inclui informações legíveis, como endereços para pagamento e distribuição postal. Com um endereço postal, um serviço postal pode entregar itens em um local, uma caixa postal ou outro local de entrega.

lat_lng

LatLng

Um objeto que representa um par de latitude/longitude.

radius_miles

double

Raio do local de trabalho, em milhas. Esse valor é derivado da caixa delimitadora de local em que um círculo com o raio especificado de google.type.LatLng cobre a área associada ao local da vaga. Por exemplo, atualmente, "Mountain View, CA, EUA" tem um raio de 6,17 milhas.

LocationType

Um enum que representa o tipo de um local.

Tipos enumerados
LOCATION_TYPE_UNSPECIFIED Valor padrão caso o tipo não seja especificado.
COUNTRY Um local no nível de país.
ADMINISTRATIVE_AREA Um local no nível de estado ou equivalente.
SUB_ADMINISTRATIVE_AREA Um local no nível de comarca ou equivalente.
LOCALITY Um local no nível de cidade ou equivalente.
POSTAL_CODE Um local no nível de código postal.
SUB_LOCALITY Uma sublocalidade é uma subdivisão de uma localidade; por exemplo, bairro ou distrito de uma cidade. As sublocalidades geralmente são reconhecidas por uma autoridade política local. Por exemplo, Manhattan e Brooklyn são reconhecidos como bairros pela Cidade de Nova York e, portanto, são modelados como sublocalidades.
SUB_LOCALITY_1 Um local no nível de distrito ou equivalente.
SUB_LOCALITY_2 Um local no nível de distrito menor ou equivalente.
NEIGHBORHOOD Um local no nível de bairro.
STREET_ADDRESS Um local no nível de endereço.

LocationFilter

Região geográfica da pesquisa.

Campos
address

string

O nome do endereço, como "Mountain View" ou "Bay Area".

region_code

string

Código regional CLDR do país/região do endereço. Ele é usado para resolver a ambiguidade do local inserido pelo usuário, por exemplo, "Liverpool" em relação a "Liverpool, NY, EUA" ou "Liverpool, Reino Unido".

Defina este campo para influenciar a resolução de local de um país ou território específico. Se este campo não for definido, o comportamento do aplicativo será direcionado para os Estados Unidos por padrão.

Para mais detalhes, acesse https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para Suíça. Esse filtro não se aplica a consultas relacionadas à pesquisa de perfis.

lat_lng

LatLng

A latitude e a longitude do centro geográfico a partir do qual pesquisar. Esse campo será ignorado se address for informado.

distance_in_miles

double

O distance_inM_miles é aplicado quando o local que está sendo pesquisado é identificado como uma cidade ou uma região menor. Este campo é ignorado se o local que está sendo pesquisado for um estado ou maior.

telecommute_preference

TelecommutePreference

Permite que o cliente retorne vagas de emprego sem um local definido, especificamente vagas de trabalho à distância (o trabalho remoto é considerado pelo serviço um local especial). Job.posting_region indica se uma vaga permite trabalho remoto. Se este campo for definido como TelecommutePreference.TELECOMMUTE_ALLOWED, as vagas de trabalho remoto serão pesquisadas, e address e lat_lng serão ignorados. Se ela não for definida ou for definida como TelecommutePreference.TELECOMMUTE_EXCLUDED, as vagas de trabalho remoto não serão pesquisadas.

Este filtro pode ser usado sozinho para pesquisar exclusivamente vagas de trabalho remoto ou pode ser combinado com outro filtro de local para procurar uma combinação de locais de vaga, como “Mountain View” ou “trabalho remoto”. No entanto, quando usado em combinação com outros filtros de local, as vagas de trabalho remoto poderão ser tratadas como menos relevantes do que outras vagas na resposta da pesquisa.

Esse campo é usado apenas para solicitações de pesquisa de vagas.

negated

bool

Aplica negação ao filtro para que os perfis correspondentes a ele sejam excluídos.

Atualmente aceito apenas na pesquisa de perfis.

TelecommutePreference

Especifique se você quer incluir vagas de trabalho remoto.

Tipos enumerados
TELECOMMUTE_PREFERENCE_UNSPECIFIED Valor padrão se a preferência de trabalho remoto não for especificada.
TELECOMMUTE_EXCLUDED Excluir vagas de trabalho remoto.
TELECOMMUTE_ALLOWED Permitir vagas de trabalho remoto.

PostingRegion

Um enum que representa a região da postagem de vagas de trabalho. Na maioria dos casos, não é preciso especificá-la. Se for fornecida uma região, as vagas estarão qualificadas para pesquisas na região especificada.

Tipos enumerados
POSTING_REGION_UNSPECIFIED Se a região não for especificada, a vaga só será retornada se corresponder a LocationFilter.
ADMINISTRATIVE_AREA

Além da correspondência exata com o local, a vaga será retornada quando LocationFilter na consulta de pesquisa estiver na mesma área político-administrativa que a vaga retornada. Por exemplo, se uma vaga ADMINISTRATIVE_AREA for postada em “CA, EUA”, ela será retornada se LocationFilter tiver “Mountain View”.

A área político-administrativa se refere à subdivisão administrativa superior de um país. Por exemplo, estado dos EUA, região da Itália, nação constituinte do Reino Unido e prefeitura do Japão.

NATION Além da correspondência com o local exato, a vaga será retornada quando LocationFilter na consulta de pesquisa for no mesmo país que essa vaga. Por exemplo, se uma vaga NATION_WIDE for postada em “EUA”, ela será retornada se LocationFilter tiver o valor “Mountain View”.
TELECOMMUTE O cargo permite que os funcionários trabalhem remotamente (à distância). Se os locais forem fornecidos com esse valor, a vaga será considerada como tendo um local, mas o trabalho remoto será permitido.

RequestMetadata

Metainformação relacionada à entidade ou ao indivíduo que realiza a pesquisa de empregos. É utilizada para melhorar o desempenho do serviço.

Campos
domain

string

Obrigatório se allow_missing_ids não estiver definido ou false.

O escopo definido pelo cliente ou a origem da chamada de serviço, que normalmente é o domínio em que o serviço foi implementado e que está em execução.

Por exemplo, se o serviço estiver sendo executado pelo cliente Foo, Inc., nos classificados de empregos www.foo.com e no site de carreiras www.bar.com, este campo será definido como “foo.com” para uso nos classificados de empregos e como “bar.com” para uso no site de carreiras.

Observe que, para que haja melhorias no modelo para um site de locatário específico, este campo precisa estar definido corretamente com um domínio único.

O número máximo de caracteres permitido é 255.

session_id

string

Obrigatório se allow_missing_ids não estiver definido ou false.

Uma string de identificação de sessão exclusiva. Uma sessão é definida como a duração da interação de um usuário final com o serviço ao longo de um determinado período. Para fins de privacidade, ofusque este campo antes de fornecê-lo ao serviço.

Observe que, para que haja melhorias no modelo para um site de locatário específico, este campo precisa estar definido corretamente com um código de sessão exclusivo.

O número máximo de caracteres permitido é 255.

user_id

string

Obrigatório se allow_missing_ids não estiver definido ou false.

Uma string de identificação de usuário exclusiva, conforme determinado pelo cliente. Para ter o maior impacto na qualidade da pesquisa, verifique se o nível do cliente é único. Para fins de privacidade, ofusque este campo antes de fornecê-lo ao serviço.

Observe que, para que haja melhorias no modelo para um site de locatário específico, este campo precisa estar definido corretamente com um código de usuário exclusivo.

O número máximo de caracteres permitido é 255.

allow_missing_ids

bool

Definido apenas quando domain, session_id e user_id não estiverem disponíveis por algum motivo. É altamente recomendável não definir esse campo e fornecer domain, session_id e user_id precisos para uma melhor experiência de serviço.

device_info

DeviceInfo

O tipo de dispositivo usado pelo pesquisador de empregos no momento da chamada para o serviço.

ResponseMetadata

Informações adicionais retornadas ao cliente, como de depuração.

Campos
request_id

string

Um código exclusivo associado a esta chamada. É registrado para fins de rastreamento.

SearchJobsRequest

O corpo da solicitação da chamada de SearchJobs.

Campos
parent

string

Obrigatório. O nome do recurso do locatário a ser pesquisado.

O formato é "projects/{project_id}/tenants/{tenant_id}". Por exemplo, "projects/foo/tenant/bar". Se o ID do locatário não for especificado, um locatário padrão será criado. Por exemplo, "projects/foo".

search_mode

SearchMode

Modo de uma pesquisa.

O valor padrão é SearchMode.JOB_SEARCH.

request_metadata

RequestMetadata

Obrigatório. Metainformação coletada sobre o pesquisador de vagas e usada para melhorar a qualidade de pesquisa do serviço. Os identificadores (como user_id) são fornecidos pelos usuários e precisam ser exclusivos e consistentes.

job_query

JobQuery

Consulta usada para pesquisar vagas, como palavra-chave, filtros de local etc.

enable_broadening

bool

Controla se a pesquisa precisa ser ampliada quando produzir resultados escassos. Consultas ampliadas acrescentam resultados no final da lista de resultados correspondentes.

O padrão é "false".

require_precise_result_size
(deprecated)

bool

O uso desse campo foi descontinuado.

histogram_queries[]

HistogramQuery

Uma expressão especifica uma solicitação de histograma para as vagas correspondentes.

A sintaxe de expressão é uma chamada de função de agregação com atributos de histograma e outras opções.

As chamadas de função de agregação disponíveis são: * count(string_histogram_facet): conta o número de entidades correspondentes para cada valor de atributo distinto. * count(numeric_histogram_facet, list of buckets): conta o número de entidades correspondentes em cada bucket.

Tipos de dados:

  • Atributo do histograma: nomes de atributo com formato [a-zA-Z][a-zA-Z0-9_]+.
  • String: por exemplo, qualquer string com escape de barra invertida para aspas (").
  • Número: número inteiro e número de ponto flutuante como 10, -1 e -0,01.
  • Lista: lista de elementos com separador de vírgula (,) entre colchetes, por exemplo, [1, 2, 3] e ["um", "dois", "três"].

Constantes integradas:

  • MIN (número mínimo semelhante a java Double.MIN_VALUE)
  • MAX (número máximo semelhante a java Double.MAX_VALUE)

Funções integradas:

  • bucket(start, end[, label]): essa função integrada cria um bucket com a faixa [start, end). Observe que o final é exclusivo, por exemplo, bucket(1, MAX, "positive number") ou bucket(1, 10).

Atributos do histograma de vaga:

  • company_display_name: histograma por Job.company_display_name.
  • Employ_type: histograma por Job.employment_types, por exemplo, "FULL_TIME", "PART_TIME".
  • empresa_size: histograma por CompanySize, por exemplo, "MENOR", "MEDIUM", "GRANDE".
  • publish_time_in_month: histograma por Job.posting_publish_time em meses. Precisa especificar a lista de buckets numéricos na especificação.
  • publish_time_in_year: histograma por Job.posting_publish_time em anos. Precisa especificar a lista de buckets numéricos na especificação.
  • degree_types: histograma por Job.degree_types, por exemplo, "Bacharelado", "Masters".
  • job_level: histograma por Job.job_level, por exemplo, "Nível básico".
  • country: histograma por código de país das vagas, por exemplo, "US", "FR".
  • admin1: histograma pelo código de vagas do admin1, que é um marcador global que se refere ao estado, à província ou ao termo que um país usa para definir a estrutura geográfica abaixo do nível do país, por exemplo, "CA", "IL".
  • city: histograma por uma combinação de "nome da cidade, código admin1". Por exemplo, "Mountain View, CA", "New York, NY".
  • admin1_country: histograma por uma combinação de "código admin1, país", por exemplo, "CA, US", "IL, US".
  • city_coordinate: histograma por coordenadas de GPS do centro da cidade (latitude e longitude), por exemplo, 37.4038522,-122.0987765. Como as coordenadas do centro da cidade podem mudar, talvez os clientes precisem atualizá-las periodicamente.
  • locale: histograma por Job.language_code, por exemplo, "en-US", "fr-FR".
  • language: histograma por subtag de idioma do Job.language_code, por exemplo, "en", "fr".
  • categoria: histograma por JobCategory, por exemplo, "COMPUTER_AND_IT", "HEALTHCARE".
  • base_offset_unit: histograma por CompensationInfo.CompensationUnit do salário-base, por exemplo, "WEEKLY", "MONTH".
  • base_compensation: histograma por salário base. É necessário especificar a lista de buckets numéricos para agrupar os resultados.
  • anualized_base_compensation: histograma por salário base anual. Precisa especificar a lista de buckets numéricos para agrupar os resultados.
  • anualized_total_compensation: histograma por total do salário anual. Precisa especificar a lista de buckets numéricos para agrupar os resultados.
  • string_custom_attribute: histograma por string Job.custom_attributes. Os valores podem ser acessados por meio de notação de colchetes, como string_custom_attribute["key1"].
  • numeric_custom_attribute: histograma por Job.custom_attributes numérico. Os valores podem ser acessados por meio da notação de colchetes, como numeric_custom_attribute["key1"]. É necessário especificar a lista de buckets numéricos para agrupar os resultados.

Exemplos de expressões:

  • 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

Os atributos desejados da vaga retornados para vagas na resposta da pesquisa. O padrão será JobView.JOB_VIEW_SMALL se nenhum valor for especificado.

offset

int32

Um número inteiro que especifica o deslocamento atual (ou seja, o local do resultado inicial, dentre as vagas consideradas relevantes pela API) nos resultados da pesquisa. Este campo só é considerado se page_token não estiver definido.

O valor máximo permitido é 5000. Valores maiores geram erro.

Por exemplo, 0 significa retornar resultados a partir da primeira vaga de emprego e 10 significa pesquisar a partir da 11ª vaga. Isso pode ser usado para paginação. Por exemplo, pageSize = 10 e offset = 10 significa pesquisar a partir da segunda página.

page_size

int32

Um limite no número de vagas de emprego retornadas nos resultados da pesquisa. Um valor acima do padrão de 10 pode aumentar o tempo de resposta da pesquisa. O valor pode estar entre 1 e 100.

page_token

string

O token que especifica o deslocamento atual nos resultados da pesquisa. Consulte SearchJobsResponse.next_page_token para saber como conseguir o próximo conjunto de resultados da consulta.

order_by

string

Os critérios que determinam como os resultados da pesquisa são classificados. O padrão é "relevance desc".

As opções compatíveis são:

  • "relevance desc": por relevância em ordem decrescente, conforme determinado pelos algoritmos da API. O limite de relevância dos resultados da consulta só está disponível com essa ordem.
  • "posting_publish_time desc": por Job.posting_publish_time em ordem decrescente.
  • "posting_update_time desc": por Job.posting_update_time em ordem decrescente.
  • "title": por Job.title em ordem crescente.
  • "title desc": por Job.title em ordem decrescente.
  • "annualized_base_compensation": por CompensationInfo.annualized_base_compensation_range do job em ordem crescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa.
  • "annualized_base_compensation desc": por CompensationInfo.annualized_base_compensation_range do job em ordem decrescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa.
  • "annualized_total_compensation": por CompensationInfo.annualized_total_compensation_range do job em ordem crescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa.
  • "annualized_total_compensation desc": por CompensationInfo.annualized_total_compensation_range do job em ordem decrescente. As vagas com remuneração de base anual não especificada são colocadas no final dos resultados da pesquisa.
  • "custom_ranking desc": pela pontuação de relevância ajustada para SearchJobsRequest.CustomRankingInfo.ranking_expression com o fator de ponderação atribuído por SearchJobsRequest.CustomRankingInfo.importance_level em ordem decrescente.
  • Classificação de local: use a sintaxe especial para ordenar tarefas por distância:
    "distance_from('Hawaii')": ordenar por distância do Havaí.
    "distance_from(19.89, 155.5)": ordenar pela distância de uma coordenada.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": ordenar por vários locais. Confira os detalhes a seguir.
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": ordenar por vários locais. Confira os detalhes a seguir.
    A string pode ter no máximo 256 caracteres. Quando vários centros de distância são fornecidos, uma vaga próxima a qualquer um dos centros de distância tem uma classificação alta. Quando uma vaga tiver vários locais, será usado o local mais próximo de um dos centros de distância. As vagas sem locais serão classificadas na parte inferior. A distância é calculada com uma precisão de 11,3 metros. A estratégia de diversificação ainda será aplicada, a menos que seja explicitamente desativada em diversification_level.
diversification_level

DiversificationLevel

Controla se as vagas altamente semelhantes são retornadas próximas umas das outras nos resultados da pesquisa. Elas são identificadas como altamente semelhantes com base nos cargos, categorias de trabalho e locais. Resultados altamente semelhantes são agrupados de modo que apenas uma vaga representativa do cluster é exibida para o candidato a emprego mais acima nos resultados, e as outras vagas são exibidas mais abaixo.

O padrão será DiversificationLevel.SIMPLE se nenhum valor for especificado.

custom_ranking_info

CustomRankingInfo

Controla como os documentos da vaga são classificados acima da pontuação de relevância atual (determinada pelo algoritmo da API).

disable_keyword_match

bool

Controla se a correspondência exata de palavra-chave será desativada em Job.title, Job.description, Job.company_display_name, Job.addresses, Job.qualifications. Quando a correspondência de palavras-chave está desativada, uma correspondência de palavra-chave retorna vagas diferentes de determinados filtros de categoria quando há palavras-chave correspondentes. Por exemplo, para a consulta "gerente de programa", um resultado é retornado mesmo que a publicação da vaga tenha o título "desenvolvedor de software", que não se encaixa na ontologia "gerente de programa", mas tem "gerente de programa" na descrição.

Para consultas como "cloud", que não contêm ontologia específica de título ou local, as vagas com correspondência da palavra-chave "cloud" são retornadas, independentemente do valor dessa sinalização.

Use Company.keyword_searchable_job_custom_attributes se forem necessários valores de string de campo/atributo personalizados de correspondência global específicos da empresa. Ativar a correspondência de palavras-chave melhora os resultados das solicitações de pesquisa subsequentes.

O padrão é "false".

CustomRankingInfo

Informações de classificação personalizadas para SearchJobsRequest.

Campos
importance_level

ImportanceLevel

Obrigatório. Controla a importância da pontuação de CustomRankingInfo.ranking_expression para ser aplicada à posição final da vaga.

É gerado um erro se não for especificado.

ranking_expression

string

Obrigatório. Controla como os documentos da vaga são classificados acima da pontuação de relevância atual (determinada pelo algoritmo da API). Uma combinação da expressão de classificação e da pontuação de relevância é usada para determinar a posição final da vaga.

A sintaxe dessa expressão é um subconjunto da sintaxe do Google SQL.

Os operadores compatíveis são: +, -, *, /, em que o lado esquerdo e direito do operador é uma chave numérica Job.custom_attributes, um valor inteiro/duplo ou uma expressão que pode ser avaliada como um número.

Parênteses são aceitos para ajustar a precedência de cálculo. A expressão precisa ter < 100 caracteres.

A expressão será considerada inválida para um trabalho se ela fizer referência a atributos personalizados que não estão preenchidos no trabalho ou se a expressão resultar em uma divisão por zero. Se uma expressão for inválida para um job, esse job será rebaixado para o fim dos resultados.

Exemplo de expressão de classificação: (year + 25) * 0.25 - (freshness / 0.5)

ImportanceLevel

O nível de importância para CustomRankingInfo.ranking_expression.

Tipos enumerados
IMPORTANCE_LEVEL_UNSPECIFIED Valor padrão se o nível de importância não for especificado.
NONE A expressão de classificação fornecida é de "nenhuma importância". A pontuação de relevância atual (determinada pelo algoritmo da API) domina a posição da classificação final da vaga.
LOW A expressão de classificação dada é de "baixa importância" na posição de classificação final da vaga em comparação com a pontuação de relevância atual (determinada pelo algoritmo da API).
MILD A expressão de classificação dada é de "importância leve" na posição de classificação final da vaga em comparação com a pontuação de relevância atual (determinada pelo algoritmo da API).
MEDIUM A expressão de classificação dada é de "importância média" na posição de classificação final da vaga em comparação com a pontuação de relevância atual (determinada pelo algoritmo da API).
HIGH A expressão de classificação dada é de "importância alta" na posição de classificação final da vaga em comparação com a pontuação de relevância atual (determinada pelo algoritmo da API).
EXTREME A expressão de classificação dada é de "extrema importância" e domina a posição de classificação final da vaga com a pontuação de relevância atual ignorada (determinada pelo algoritmo da API).

DiversificationLevel

Controla se as vagas altamente semelhantes são retornadas próximas umas das outras nos resultados da pesquisa. Elas são identificadas como altamente semelhantes com base nos cargos, categorias de trabalho e locais. Resultados altamente semelhantes são agrupados de modo que apenas uma vaga representativa do cluster é exibida para o candidato a emprego mais acima nos resultados, e as outras vagas são exibidas mais abaixo.

Tipos enumerados
DIVERSIFICATION_LEVEL_UNSPECIFIED O nível de diversificação não é especificado.
DISABLED Desativa a diversificação. As vagas que normalmente seriam enviadas para a última página não teriam suas posições alteradas. Isso pode resultar em trabalhos altamente semelhantes que aparecem em sequência nos resultados da pesquisa.
SIMPLE Comportamento de diversificação padrão. A lista de resultados é ordenada para que resultados altamente semelhantes sejam enviados para o final da última página dos resultados da pesquisa. Se você estiver usando o pageToken para percorrer o conjunto de resultados, a latência poderá ser menor, mas não podemos garantir que todos os resultados sejam retornados. Se você estiver usando o deslocamento de página, a latência poderá ser maior, mas todos os resultados serão retornados.

SearchMode

Uma enumeração representada por string do modo de pesquisa de vagas. O serviço opera de maneira diferente para os diversos modos dele.

Enums
SEARCH_MODE_UNSPECIFIED O modo do método de pesquisa não foi especificado. O comportamento de pesquisa padrão é idêntico ao comportamento de pesquisa de JOB_SEARCH.

SearchJobsResponse

Resposta para o método SearchJob.

Campos
matching_jobs[]

MatchingJob

As entidades Job que correspondem ao SearchJobsRequest especificado.

histogram_query_results[]

HistogramQueryResult

Os resultados do histograma que correspondem ao SearchJobsRequest.histogram_queries especificado.

next_page_token

string

O token que especifica a posição inicial da próxima página de resultados. Este campo ficará vazio se não houver mais resultados.

location_filters[]

Location

O local filtra o serviço aplicado à consulta especificada. Se algum filtro for baseado em lat-lng, Location.location_type será Location.LocationType.LOCATION_TYPE_UNSPECIFIED.

estimated_total_size

int32

Uma estimativa do número de vagas de emprego que correspondem à consulta especificada.

Não há garantia de que esse número esteja correto. Para resultados precisos, consulte SearchJobsResponse.total_size.

total_size

int32

A contagem precisa de resultados com limite de 100.000.

metadata

ResponseMetadata

Mais informações para a invocação da API, como o código de rastreamento de solicitações.

broadened_query_jobs_count

int32

Se a ampliação de consultas estiver ativada, será possível anexar resultados adicionais com base na consulta ampliada. Esse número indica quantas das vagas retornadas no campo de vagas são provenientes da consulta ampliada. Estes resultados estão sempre no final da lista de vagas. Especificamente, um valor 0 ou não definido significa que todas as vagas nessa lista são provenientes da consulta original (sem ampliação). Quando este campo é diferente de zero, as solicitações seguintes com diferença após esse conjunto de resultados precisam incluir todos os resultados ampliados.

spell_correction

SpellingCorrection

O resultado da verificação ortográfica e a correção.

CommuteInfo

Detalhes do deslocamento diário relacionados a essa vaga de emprego.

Campos
job_location

Location

Local utilizado como destino no cálculo do deslocamento diário.

travel_duration

Duration

O número de segundos necessários para viajar até o local de trabalho a partir do local da consulta. Uma duração de 0 segundos indica que a vaga não está acessível na duração solicitada, mas foi retornada como parte de uma consulta expandida.

MatchingJob

Entrada de vaga com metadados em SearchJobsResponse.

Campos
job

Job

O recurso do job que corresponde ao SearchJobsRequest especificado.

job_summary

string

Um resumo da vaga com informações básicas exibidas na página de listagem de resultados da pesquisa.

job_title_snippet

string

Contém snippets do texto do campo Job.title que mais correspondem às palavras-chave de uma consulta de pesquisa, se disponíveis. As palavras-chave de consulta correspondentes são incluídas em tags HTML em negrito.

search_text_snippet

string

Contém snippets de texto do campo Job.description e semelhantes que mais têm semelhança com as palavras-chave de uma consulta de pesquisa, se disponíveis. Todas as tags HTML nos campos originais são removidas quando retornadas neste campo, e as palavras-chave de consulta correspondentes são incluídas em tags HTML em negrito.

commute_info

CommuteInfo

Informações de deslocamento diário geradas com base no CommuteFilter especificado.

SpellingCorrection

Resultado da verificação ortográfica.

Campos
corrected

bool

Indica se a consulta foi corrigida pelo verificador ortográfico.

corrected_text

string

Mostra a string de palavras-chave corrigida.

corrected_html

string

Saída corrigida com tags html para destacar as palavras corrigidas. As palavras corrigidas são destacadas com as tags html "...".

Por exemplo, a consulta inserida pelo usuário é "enginero de software", e a segunda palavra, "enginero", está incorreta. A grafia correta é "engenheiro". Quando a correção ortográfica está ativada, esse valor é "engenheiro de software".

Locatário

Um recurso de locatário representa um locatário no serviço. Um locatário é um grupo ou uma entidade que compartilha o acesso comum com privilégios específicos para recursos como perfis. O cliente pode criar vários locatários para fornecer isolamento de dados para grupos diferentes.

Campos
name

string

Obrigatório durante a atualização do locatário.

O nome do recurso para um locatário. Ele é gerado pelo serviço quando um locatário é criado.

O formato é "projects/{project_id}/tenants/{tenant_id}", por exemplo, "projects/foo/tenants/bar".

external_id

string

Obrigatório. Identificador de locatário do lado do cliente, usado para identificar exclusivamente o locatário.

O número máximo de caracteres permitido é 255.

usage_type

DataUsageType

Indica se os dados de propriedade deste locatário podem ser usados para fornecer melhorias de produtos em outros locatários.

Se não for definido, o comportamento padrão será DataUsageType.ISOLATED.

keyword_searchable_profile_custom_attributes[]

string

Uma lista de chaves de Profile.custom_attributes filtrável, com string_values correspondente usada em pesquisas por palavra-chave. Os perfis com string_values nessas chaves de campo especificadas serão retornados se algum dos valores corresponder à palavra-chave de pesquisa. Os valores de campo personalizados com parênteses, colchetes e símbolos especiais não são pesquisáveis no estado em que se encontram e precisam estar entre aspas.

DataUsageType

Enumeração que representa como os dados do usuário pertencentes ao locatário são usados.

Tipos enumerados
DATA_USAGE_TYPE_UNSPECIFIED Valor padrão.
AGGREGATED Os dados de propriedade deste locatário são usados para melhorar a qualidade da pesquisa/recomendação entre locatários.
ISOLATED Os dados de propriedade deste locatário são usados para melhorar a qualidade da pesquisa/recomendação apenas para este locatário.

TimestampRange

Mensagem que representa um período entre dois carimbos de data/hora.

Campos
start_time

Timestamp

Início do período (inclusivo).

end_time

Timestamp

Fim do período (exclusivo).

UpdateCompanyRequest

Solicitação de atualização de uma empresa especificada.

Campos
company

Company

Obrigatório. O recurso da empresa para substituir o recurso atual no sistema.

update_mask

FieldMask

É altamente recomendado para melhorar a experiência de atendimento.

Se update_mask for fornecido, somente os campos especificados em company serão atualizados. Do contrário, todos os campos serão atualizados.

Uma máscara de campo para especificar os campos da empresa a serem atualizados. Somente campos de nível superior de Company são aceitos.

UpdateJobRequest

Solicitação de atualização de vaga.

Campos
job

Job

Obrigatório. A vaga de emprego a ser atualizada.

update_mask

FieldMask

É altamente recomendado para melhorar a experiência de atendimento.

Se update_mask for fornecido, somente os campos especificados em job serão atualizados. Do contrário, todos os campos serão atualizados.

Uma máscara para restringir os campos que serão atualizados. Somente campos de nível superior de Job são aceitos.

UpdateTenantRequest

Solicitação de atualização de um locatário especificado.

Campos
tenant

Tenant

Obrigatório. O recurso de locatário para substituir o recurso atual no sistema.

update_mask

FieldMask

É altamente recomendado para melhorar a experiência de atendimento.

Se update_mask for fornecido, somente os campos especificados em tenant serão atualizados. Do contrário, todos os campos serão atualizados.

Uma máscara de campo para especificar os campos de locatário a serem atualizados. Somente campos de nível superior de Tenant são aceitos.

Questões de visibilidade

Obsoleto. Todos os recursos são visíveis apenas para o proprietário.

Um enum que representa quem tem acesso de visualização ao recurso.

Tipos enumerados
VISIBILITY_UNSPECIFIED Valor padrão.
ACCOUNT_ONLY O recurso é visível apenas para a conta do GCP proprietária.
SHARED_WITH_GOOGLE O recurso é visível para o proprietário e pode ficar visível para outros aplicativos e processos no Google.
SHARED_WITH_PUBLIC O recurso é visível para o proprietário e pode ficar visível para todos os outros clientes da API.