# Cloud Talent Solution API

Cloud Talent Solution provides the capability to create, read, update, and delete job postings, as well as search jobs based on keywords and filters.

- [REST Resource: v4beta1.projects](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects)
- [REST Resource: v4beta1.projects.clientEvents](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.clientEvents)
- [REST Resource: v4beta1.projects.companies](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.companies)
- [REST Resource: v4beta1.projects.jobs](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.jobs)
- [REST Resource: v4beta1.projects.operations](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.operations)
- [REST Resource: v4beta1.projects.tenants](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.tenants)
- [REST Resource: v4beta1.projects.tenants.clientEvents](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.tenants.clientEvents)
- [REST Resource: v4beta1.projects.tenants.companies](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.tenants.companies)
- [REST Resource: v4beta1.projects.tenants.jobs](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest#v4beta1.projects.tenants.jobs)

## Service: jobs.googleapis.com

We recommend that you call this service using Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

### Discovery document

A [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

- <https://jobs.googleapis.com/$discovery/rest?version=v4beta1>

### Service endpoint

A [service endpoint](https://cloud.google.com/apis/design/glossary) is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

- `https://jobs.googleapis.com`

## REST Resource: [v4beta1.projects](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects/complete` | `GET /v4beta1/{parent=projects/*}:complete` Completes the specified prefix with keyword suggestions. |

## REST Resource: [v4beta1.projects.clientEvents](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.clientEvents)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.clientEvents/create` | `POST /v4beta1/{parent=projects/*}/clientEvents` Report events issued when end user interacts with customer's application that uses Cloud Talent Solution. |

## REST Resource: [v4beta1.projects.companies](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies/create` | `POST /v4beta1/{parent=projects/*}/companies` Creates a new company entity. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies/delete` | `DELETE /v4beta1/{name=projects/*/companies/*}` Deletes specified company. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies/get` | `GET /v4beta1/{name=projects/*/companies/*}` Retrieves specified company. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies/list` | `GET /v4beta1/{parent=projects/*}/companies` Lists all companies associated with the project. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.companies/patch` | `PATCH /v4beta1/{company.name=projects/*/companies/*}` Updates specified company. |

## REST Resource: [v4beta1.projects.jobs](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/batchCreate` | `POST /v4beta1/{parent=projects/*}/jobs:batchCreate` Begins executing a batch create jobs operation. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/batchDelete` | `POST /v4beta1/{parent=projects/*}/jobs:batchDelete` Deletes a list of `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs#Job`s by filter. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/batchUpdate` | `POST /v4beta1/{parent=projects/*}/jobs:batchUpdate` Begins executing a batch update jobs operation. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/create` | `POST /v4beta1/{parent=projects/*}/jobs` Creates a new job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/delete` | `DELETE /v4beta1/{name=projects/*/jobs/*}` Deletes the specified job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/get` | `GET /v4beta1/{name=projects/*/jobs/*}` Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/list` | `GET /v4beta1/{parent=projects/*}/jobs` Lists jobs by filter. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/patch` | `PATCH /v4beta1/{job.name=projects/*/jobs/*}` Updates specified job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/search` | `POST /v4beta1/{parent=projects/*}/jobs:search` Searches for jobs using the provided `SearchJobsRequest`. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs/searchForAlert` | `POST /v4beta1/{parent=projects/*}/jobs:searchForAlert` Searches for jobs using the provided `SearchJobsRequest`. |

## REST Resource: [v4beta1.projects.operations](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.operations)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.operations/get` | `GET /v4beta1/{name=projects/*/operations/*}` Gets the latest state of a long-running operation. |

## REST Resource: [v4beta1.projects.tenants](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/complete` | `GET /v4beta1/{parent=projects/*/tenants/*}:complete` Completes the specified prefix with keyword suggestions. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/create` | `POST /v4beta1/{parent=projects/*}/tenants` Creates a new tenant entity. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/delete` | `DELETE /v4beta1/{name=projects/*/tenants/*}` Deletes specified tenant. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/get` | `GET /v4beta1/{name=projects/*/tenants/*}` Retrieves specified tenant. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/list` | `GET /v4beta1/{parent=projects/*}/tenants` Lists all tenants associated with the project. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants/patch` | `PATCH /v4beta1/{tenant.name=projects/*/tenants/*}` Updates specified tenant. |

## REST Resource: [v4beta1.projects.tenants.clientEvents](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.clientEvents)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.clientEvents/create` | `POST /v4beta1/{parent=projects/*/tenants/*}/clientEvents` Report events issued when end user interacts with customer's application that uses Cloud Talent Solution. |

## REST Resource: [v4beta1.projects.tenants.companies](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies/create` | `POST /v4beta1/{parent=projects/*/tenants/*}/companies` Creates a new company entity. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies/delete` | `DELETE /v4beta1/{name=projects/*/tenants/*/companies/*}` Deletes specified company. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies/get` | `GET /v4beta1/{name=projects/*/tenants/*/companies/*}` Retrieves specified company. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies/list` | `GET /v4beta1/{parent=projects/*/tenants/*}/companies` Lists all companies associated with the project. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.companies/patch` | `PATCH /v4beta1/{company.name=projects/*/tenants/*/companies/*}` Updates specified company. |

## REST Resource: [v4beta1.projects.tenants.jobs](https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/batchCreate` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs:batchCreate` Begins executing a batch create jobs operation. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/batchDelete` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs:batchDelete` Deletes a list of `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.jobs#Job`s by filter. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/batchUpdate` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs:batchUpdate` Begins executing a batch update jobs operation. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/create` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs` Creates a new job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/delete` | `DELETE /v4beta1/{name=projects/*/tenants/*/jobs/*}` Deletes the specified job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/get` | `GET /v4beta1/{name=projects/*/tenants/*/jobs/*}` Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/list` | `GET /v4beta1/{parent=projects/*/tenants/*}/jobs` Lists jobs by filter. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/patch` | `PATCH /v4beta1/{job.name=projects/*/tenants/*/jobs/*}` Updates specified job. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/search` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs:search` Searches for jobs using the provided `SearchJobsRequest`. |
| `https://docs.cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v4beta1/projects.tenants.jobs/searchForAlert` | `POST /v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert` Searches for jobs using the provided `SearchJobsRequest`. |