Method: projects.tenants.companies.patch

Actualiza la empresa especificada.

Solicitud HTTP

PATCH https://jobs.googleapis.com/v4beta1/{company.name=projects/*/tenants/*/companies/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
company.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”.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "company": {
    "name": string,
    "displayName": string,
    "externalId": string,
    "size": enum (CompanySize),
    "headquartersAddress": string,
    "hiringAgency": boolean,
    "eeoText": string,
    "websiteUri": string,
    "careerSiteUri": string,
    "imageUri": string,
    "keywordSearchableJobCustomAttributes": [
      string
    ],
    "derivedInfo": {
      "headquartersLocation": {
        object (Location)
      }
    },
    "suspended": boolean
  },
  "updateMask": string
}
Campos
company.displayName

string

Obligatorio. El nombre visible de la empresa, por ejemplo, “Google LLC”.
company.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.
company.size

enum (CompanySize)

El tamaño de la empresa del empleador.
company.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.
company.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.
company.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.
company.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.
company.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".
company.imageUri

string

Un URI que aloja el logotipo de la empresa del empleador.
company.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.
company.derivedInfo

object (DerivedInfo)

Solo salida. Son los detalles derivados de la empresa.
company.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.
updateMask

string (FieldMask format)

Muy recomendable para obtener la mejor experiencia de servicio.

Si se proporciona updateMask, solo se actualizan los campos especificados en company. De lo contrario, se actualizan todos los campos.

Una máscara de campo que especifica los campos de la empresa que se actualizarán. Solo se admiten los campos de nivel superior de Company.

Una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Company.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.