REST Resource: projects.companies

Recurso: Company

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

Representación 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

Obligatorio durante la actualización de la empresa.

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

El formato es "projects/{projectId}/tenants/{tenantId}/empresas/{company_id}", por ejemplo, "proyectos/foo/usuarios/bar/empresas/baz".

Si no se especifica el ID de usuario, se usa el predeterminado. Por ejemplo, “proyectos/foo/empresas/bar”.
displayName

string

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

string

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

La cantidad máxima de caracteres permitida es 255.
size

enum (CompanySize)

El tamaño de la empresa del empleador.
headquartersAddress

string

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

boolean

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

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

string

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

La cantidad máxima de caracteres permitida es 500.
websiteUri

string

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

La cantidad máxima de caracteres permitida es 255.
careerSiteUri

string

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

string

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

string

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

object (DerivedInfo)

Solo salida. Son los detalles derivados de la empresa.
suspended

boolean

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

CompanySize

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

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

DerivedInfo

Son los detalles derivados de la empresa.

Representación JSON 
{
  "headquartersLocation": {
    object (Location)
  }
}
Campos
headquartersLocation

object (Location)

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

Métodos

create

 Crea una entidad de empresa nueva.

delete

 Borra la empresa especificada.

get

 Recupera la empresa especificada.

list

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

patch

 Actualiza la empresa especificada.