A Company resource in Cloud Talent Solution represents a single company. Any job belonging to that company refers to a job posting that is created for an open position in that company. It contains information such as the company name and address, as well as internal fields that tie the resource in the Cloud Talent Solution service back to your internal databases.
Create a company
To create a company, send a POST request to the companies
endpoint, specifying
at least the two required fields. Refer to the
Quickstart: Create companies and jobs
page for details on how to create a company. Video tutorials and interactive
codelabs are also available.
Go
To learn how to install and use the client library for CTS, see CTS client libraries. For more information, see the CTS Go API reference documentation.
To authenticate to CTS, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.
Java
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Python
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Required fields
The following fields are required in create/update requests:
displayName
: The name of the employer displayed with the job, for example, "Google LLC".externalId
: Your internal ID for this company. This field allows you to map your internal identifiers to the company in Google's system. If the company doesn't have a separate internal identifier, set this field to the same value asdisplayName
.
Commonly used fields
headquartersAddress
: The street address of the company's main headquarters, which may be different from the job location. Cloud Talent Solution only accepts a single HQ location per company. The service attempts to geolocate the address, and populates a more specific location when possible inderivedInfo.headquartersLocation
(which is output only).size
: A bucket value representing the size of the company in terms of number of employees, fromMINI
toGIANT
. See thesize
reference for enums and their definitions.eeoText
: A string containing the Equal Employment Opportunity legal disclaimer text to be associated with all jobs for this company.keywordSearchableJobCustomAttributes
: Specifies whichcustomAttributes
on this company's jobs should be indexed and searchable by general keyword search.
Confidential companies
In cases where you want to post a confidential job, we recommend
creating a separate company that mimics the company's fields,
but obfuscates the displayName
, externalId
, and any other
identifying fields.
In cases where the end employer should be anonymous (for example, the
Staffing Agency use case), we recommend setting the externalId
and
displayName
to random but unique values.
Retrieve a company
Go
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Java
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Python
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
List companies
Java
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Delete a company
Go
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Java
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.
Python
For more on installing and creating a Cloud Talent Solution client, see Cloud Talent Solution Client Libraries.