# REST Resource: projects.tenants.companies

- [Resource: Company](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#Company)
  - [JSON representation](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#Company.SCHEMA_REPRESENTATION)
- [CompanySize](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#CompanySize)
- [DerivedInfo](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#DerivedInfo)
  - [JSON representation](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#DerivedInfo.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#METHODS_SUMMARY)

## Resource: Company

A Company resource represents a company in the service. A company is the entity that owns job postings, that is, the hiring entity responsible for employing applicants for the job position.

| JSON representation |
|---|
| ``` { "name": string, "displayName": string, "externalId": string, "size": enum (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#CompanySize`), "headquartersAddress": string, "hiringAgency": boolean, "eeoText": string, "websiteUri": string, "careerSiteUri": string, "imageUri": string, "keywordSearchableJobCustomAttributes": [ string ], "derivedInfo": { object (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#DerivedInfo`) }, "suspended": boolean } ``` |

| Fields ||
|---|---|
| `name` | `string` Required during company update. The resource name for a company. This is generated by the service when a company is created. The format is "projects/{projectId}/tenants/{tenantId}/companies/{company_id}", for example, "projects/foo/tenants/bar/companies/baz". |
| `displayName` | `string` Required. The display name of the company, for example, "Google LLC". |
| `externalId` | `string` Required. Client side company identifier, used to uniquely identify the company. The maximum number of allowed characters is 255. |
| `size` | ``enum (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#CompanySize`)`` The employer's company size. |
| `headquartersAddress` | `string` The street address of the company's main headquarters, which may be different from the job location. The service attempts to geolocate the provided address, and populates a more specific location wherever possible in `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#DerivedInfo.FIELDS.headquarters_location`. |
| `hiringAgency` | `boolean` Set to true if it is the hiring agency that post jobs for other employers. Defaults to false if not provided. |
| `eeoText` | `string` Equal Employment Opportunity legal disclaimer text to be associated with all jobs, and typically to be displayed in all roles. The maximum number of allowed characters is 500. |
| `websiteUri` | `string` The URI representing the company's primary web site or home page, for example, "https://www.google.com". The maximum number of allowed characters is 255. |
| `careerSiteUri` | `string` The URI to employer's career site or careers page on the employer's web site, for example, "https://careers.google.com". |
| `imageUri` | `string` A URI that hosts the employer's company logo. |
| `keywordSearchableJobCustomAttributes[] (deprecated)` | `string` > [!WARNING] > This item is deprecated! This field is deprecated. Please set the searchability of the custom attribute in the `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#Job.FIELDS.custom_attributes` going forward. A list of keys of filterable `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.jobs#Job.FIELDS.custom_attributes`, whose corresponding `stringValues` are used in keyword searches. Jobs with `stringValues` under these specified field keys are returned if any of the values match the search keyword. Custom field values with parenthesis, brackets and special symbols are not searchable as-is, and those keyword queries must be surrounded by quotes. |
| `derivedInfo` | ``object (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#DerivedInfo`)`` Output only. Derived details about the company. |
| `suspended` | `boolean` Output only. Indicates whether a company is flagged to be suspended from public availability by the service when job content appears suspicious, abusive, or spammy. |

## CompanySize

An enum that represents the size of the company.

| Enums ||
|---|---|
| `COMPANY_SIZE_UNSPECIFIED` | Default value if the size isn't specified. |
| `MINI` | The company has less than 50 employees. |
| `SMALL` | The company has between 50 and 99 employees. |
| `SMEDIUM` | The company has between 100 and 499 employees. |
| `MEDIUM` | The company has between 500 and 999 employees. |
| `BIG` | The company has between 1,000 and 4,999 employees. |
| `BIGGER` | The company has between 5,000 and 9,999 employees. |
| `GIANT` | The company has 10,000 or more employees. |

## DerivedInfo

Derived details about the company.

| JSON representation |
|---|
| ``` { "headquartersLocation": { object (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/Location`) } } ``` |

| Fields ||
|---|---|
| `headquartersLocation` | ``object (`https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/Location`)`` A structured headquarters location of the company, resolved from `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies#Company.FIELDS.headquarters_address` if provided. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies/create` | Creates a new company entity. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies/delete` | Deletes specified company. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies/get` | Retrieves specified company. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies/list` | Lists all companies associated with the project. |
| ### `https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rest/v4/projects.tenants.companies/patch` | Updates specified company. |