REST Resource: projects.companies

Recurso: 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.

Representação JSON 
{
  "name": string,
  "displayName": string,
  "externalId": string,
  "size": enum (CompanySize),
  "headquartersAddress": string,
  "hiringAgency": boolean,
  "eeoText": string,
  "websiteUri": string,
  "careerSiteUri": string,
  "imageUri": string,
  "keywordSearchableJobCustomAttributes": [
    string
  ],
  "derivedInfo": {
    object (DerivedInfo)
  },
  "suspended": boolean
}
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/{projectId}/tenants/{tenantId}/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".
displayName

string

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

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

enum (CompanySize)

O tamanho da empresa do empregador.
headquartersAddress

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.
hiringAgency

boolean

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”.
eeoText

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.
websiteUri

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.
careerSiteUri

string

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

string

Um URI que hospeda o logotipo da empresa do empregador.
keywordSearchableJobCustomAttributes[]

string

Uma lista de chaves de Job.custom_attributes filtrável, com stringValues correspondente usada em pesquisas por palavra-chave. As vagas com stringValues 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.
derivedInfo

object (DerivedInfo)

Apenas saída. Detalhes derivados da empresa.
suspended

boolean

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.

CompanySize

Um enum que representa o tamanho da empresa.

Enums
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.

DerivedInfo

Detalhes derivados da empresa.

Representação JSON 
{
  "headquartersLocation": {
    object (Location)
  }
}
Campos
headquartersLocation

object (Location)

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

Métodos

create

 Cria uma nova entidade de empresa.

delete

 Exclui a empresa especificada.

get

 Recupera a empresa especificada.

list

 Lista todas as empresas associadas ao projeto.

patch

 Atualiza a empresa especificada.