openapi-directory/api/googleapis.com/jobs.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"contact":{"name":"Google","url":"https://google.com"},"description":"Cloud Talent Solution provides the capability to create, read, update, and delete job postings, as well as search jobs based on keywords and filters.\n","title":"Cloud Talent Solution","version":"v3","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-logo":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"x-origin":[{"converter":{"url":"https://github.com/lucybot/api-spec-converter","version":"2.7.18"},"format":"google","url":"https://jobs.googleapis.com/$discovery/rest?version=v3","version":"v1"}],"x-preferred":true,"x-providerName":"googleapis.com","x-serviceName":"jobs"},"externalDocs":{"url":"https://cloud.google.com/talent-solution/job-search/docs/"},"tags":[{"name":"projects"}],"paths":{"/v3/{name}":{"delete":{"description":"Deletes the specified job.\n\nTypically, the job becomes unsearchable within 10 seconds, but it may take\nup to 5 minutes.","operationId":"jobs.projects.jobs.delete","parameters":[{"description":"Required.\n\nThe resource name of the job to be deleted.\n\nThe format is \"projects/{project_id}/jobs/{job_id}\",\nfor example, \"projects/api-test-project/jobs/1234\".","in":"path","name":"name","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Empty"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]},"get":{"description":"Retrieves the specified job, whose status is OPEN or recently EXPIRED\nwithin the last 90 days.","operationId":"jobs.projects.jobs.get","parameters":[{"description":"Required.\n\nThe resource name of the job to retrieve.\n\nThe format is \"projects/{project_id}/jobs/{job_id}\",\nfor example, \"projects/api-test-project/jobs/1234\".","in":"path","name":"name","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Job"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"patch":{"description":"Updates specified job.\n\nTypically, updated contents become visible in search results within 10\nseconds, but it may take up to 5 minutes.","operationId":"jobs.projects.jobs.patch","parameters":[{"description":"Required during job update.\n\nThe resource name for the job. This is generated by the service when a\njob is created.\n\nThe format is \"projects/{project_id}/jobs/{job_id}\",\nfor example, \"projects/api-test-project/jobs/1234\".\n\nUse of this field in job queries and API calls is preferred over the use of\nrequisition_id since this value is unique.","in":"path","name":"name","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateJobRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Job"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{name}:complete":{"get":{"description":"Completes the specified prefix with keyword suggestions.\nIntended for use by a job search auto-complete search box.","operationId":"jobs.projects.complete","parameters":[{"description":"Optional.\n\nIf provided, restricts completion to specified company.\n\nThe format is \"projects/{project_id}/companies/{company_id}\", for example,\n\"projects/api-test-project/companies/foo\".","in":"query","name":"companyName","schema":{"type":"string"}},{"description":"Deprecated. Use language_codes instead.\n\nOptional.\n\nThe language of the query. This is\nthe BCP-47 language code, such as \"en-US\" or \"sr-Latn\".\nFor more information, see\n[Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).\n\nFor CompletionType.JOB_TITLE type, only open jobs with the same\nlanguage_code are returned.\n\nFor CompletionType.COMPANY_NAME type,\nonly companies having open jobs with the same language_code are\nreturned.\n\nFor CompletionType.COMBINED type, only open jobs with the same\nlanguage_code or companies having open jobs with the same\nlanguage_code are returned.\n\nThe maximum number of allowed characters is 255.","in":"query","name":"languageCode","schema":{"type":"string"}},{"description":"Optional.\n\nThe list of languages of the query. This is\nthe BCP-47 language code, such as \"en-US\" or \"sr-Latn\".\nFor more information, see\n[Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).\n\nFor CompletionType.JOB_TITLE type, only open jobs with the same\nlanguage_codes are returned.\n\nFor CompletionType.COMPANY_NAME type,\nonly companies having open jobs with the same language_codes are\nreturned.\n\nFor CompletionType.COMBINED type, only open jobs with the same\nlanguage_codes or companies having open jobs with the same\nlanguage_codes are returned.\n\nThe maximum number of allowed characters is 255.","in":"query","name":"languageCodes","explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Required.\n\nResource name of project the completion is performed within.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"name","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}},{"description":"Required.\n\nCompletion result count.\n\nThe maximum allowed page size is 10.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Required.\n\nThe query used to generate suggestions.\n\nThe maximum number of allowed characters is 255.","in":"query","name":"query","schema":{"type":"string"}},{"description":"Optional.\n\nThe scope of the completion. The defaults is CompletionScope.PUBLIC.","in":"query","name":"scope","schema":{"type":"string","enum":["COMPLETION_SCOPE_UNSPECIFIED","TENANT","PUBLIC"]}},{"description":"Optional.\n\nThe completion topic. The default is CompletionType.COMBINED.","in":"query","name":"type","schema":{"type":"string","enum":["COMPLETION_TYPE_UNSPECIFIED","JOB_TITLE","COMPANY_NAME","COMBINED"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompleteQueryResponse"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}]},"/v3/{parent}/clientEvents":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Report events issued when end user interacts with customer's application\nthat uses Cloud Talent Solution. You may inspect the created events in\n[self service\ntools](https://console.cloud.google.com/talent-solution/overview).\n[Learn\nmore](https://cloud.google.com/talent-solution/job-search/docs/management-tools)\nabout self service tools.","operationId":"jobs.projects.clientEvents.create","parameters":[{"description":"Parent project name.","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientEventRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientEvent"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{parent}/companies":{"get":{"description":"Lists all companies associated with the service account.","operationId":"jobs.projects.companies.list","parameters":[{"description":"Optional.\n\nThe maximum number of companies to be returned, at most 100.\nDefault is 100 if a non-positive number is provided.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Optional.\n\nThe starting indicator from which to return results.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Required.\n\nResource name of the project under which the company is created.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}},{"description":"Optional.\n\nSet to true if the companies requested must have open jobs.\n\nDefaults to false.\n\nIf true, at most page_size of companies are fetched, among which\nonly those with open jobs are returned.","in":"query","name":"requireOpenJobs","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ListCompaniesResponse"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Creates a new company entity.","operationId":"jobs.projects.companies.create","parameters":[{"description":"Required.\n\nResource name of the project under which the company is created.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCompanyRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Company"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{parent}/jobs":{"get":{"description":"Lists jobs by filter.","operationId":"jobs.projects.jobs.list","parameters":[{"description":"Required.\n\nThe filter string specifies the jobs to be enumerated.\n\nSupported operator: =, AND\n\nThe fields eligible for filtering are:\n\n* `companyName` (Required)\n* `requisitionId` (Optional)\n\nSample Query:\n\n* companyName = \"projects/api-test-project/companies/123\"\n* companyName = \"projects/api-test-project/companies/123\" AND requisitionId\n= \"req-1\"","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Optional.\n\nThe desired job attributes returned for jobs in the\nsearch response. Defaults to JobView.JOB_VIEW_FULL if no value is\nspecified.","in":"query","name":"jobView","schema":{"type":"string","enum":["JOB_VIEW_UNSPECIFIED","JOB_VIEW_ID_ONLY","JOB_VIEW_MINIMAL","JOB_VIEW_SMALL","JOB_VIEW_FULL"]}},{"description":"Optional.\n\nThe maximum number of jobs to be returned per page of results.\n\nIf job_view is set to JobView.JOB_VIEW_ID_ONLY, the maximum allowed\npage size is 1000. Otherwise, the maximum allowed page size is 100.\n\nDefault is 100 if empty or a number < 1 is specified.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Optional.\n\nThe starting point of a query result.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Required.\n\nThe resource name of the project under which the job is created.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ListJobsResponse"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Creates a new job.\n\nTypically, the job becomes searchable within 10 seconds, but it may take\nup to 5 minutes.","operationId":"jobs.projects.jobs.create","parameters":[{"description":"Required.\n\nThe resource name of the project under which the job is created.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateJobRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Job"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{parent}/jobs:batchDelete":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Deletes a list of Jobs by filter.","operationId":"jobs.projects.jobs.batchDelete","parameters":[{"description":"Required.\n\nThe resource name of the project under which the job is created.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteJobsRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Empty"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{parent}/jobs:search":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Searches for jobs using the provided SearchJobsRequest.\n\nThis call constrains the visibility of jobs\npresent in the database, and only returns jobs that the caller has\npermission to search against.","operationId":"jobs.projects.jobs.search","parameters":[{"description":"Required.\n\nThe resource name of the project to search within.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/SearchJobsRequest"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchJobsResponse"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}},"/v3/{parent}/jobs:searchForAlert":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/uploadType"},{"$ref":"#/components/parameters/upload_protocol"}],"post":{"description":"Searches for jobs using the provided SearchJobsRequest.\n\nThis API call is intended for the use case of targeting passive job\nseekers (for example, job seekers who have signed up to receive email\nalerts about potential job opportunities), and has different algorithmic\nadjustments that are targeted to passive job seekers.\n\nThis call constrains the visibility of jobs\npresent in the database, and only returns jobs the caller has\npermission to search against.","operationId":"jobs.projects.jobs.searchForAlert","parameters":[{"description":"Required.\n\nThe resource name of the project to search within.\n\nThe format is \"projects/{project_id}\", for example,\n\"projects/api-test-project\".","in":"path","name":"parent","required":true,"x-reservedExpansion":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/SearchJobsRequest"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchJobsResponse"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"]},{"Oauth2":["https://www.googleapis.com/auth/jobs"]}],"tags":["projects"]}}},"servers":[{"url":"https://jobs.googleapis.com/"}],"components":{"parameters":{"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"type":"string","enum":["json","media","proto"],"default":"json"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean","default":true}},"quotaUser":{"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}},"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"type":"string","enum":["1","2"]}}},"requestBodies":{"SearchJobsRequest":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchJobsRequest"}}}}},"securitySchemes":{"Oauth2":{"description":"Oauth 2.0 authentication","type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://accounts.google.com/o/oauth2/auth","scopes":{"https://www.googleapis.com/auth/cloud-platform":"View and manage your data across Google Cloud Platform services","https://www.googleapis.com/auth/jobs":"Manage job postings"}}}}},"schemas":{"ApplicationInfo":{"description":"Application related details of a job posting.","properties":{"emails":{"description":"Optional but at least one of uris,\nemails or instruction must be\nspecified.\n\nUse this field to specify email address(es) to which resumes or\napplications can be sent.\n\nThe maximum number of allowed characters for each entry is 255.","items":{"type":"string"},"type":"array"},"instruction":{"description":"Optional but at least one of uris,\nemails or instruction must be\nspecified.\n\nUse this field to provide instructions, such as \"Mail your application\nto ...\", that a candidate can follow to apply for the job.\n\nThis field accepts and sanitizes HTML input, and also accepts\nbold, italic, ordered list, and unordered list markup tags.\n\nThe maximum number of allowed characters is 3,000.","type":"string"},"uris":{"description":"Optional but at least one of uris,\nemails or instruction must be\nspecified.\n\nUse this URI field to direct an applicant to a website, for example to\nlink to an online application form.\n\nThe maximum number of allowed characters for each entry is 2,000.","items":{"type":"string"},"type":"array"}},"type":"object"},"BatchDeleteJobsRequest":{"description":"Input only.\n\nBatch delete jobs request.","properties":{"filter":{"description":"Required.\n\nThe filter string specifies the jobs to be deleted.\n\nSupported operator: =, AND\n\nThe fields eligible for filtering are:\n\n* `companyName` (Required)\n* `requisitionId` (Required)\n\nSample Query: companyName = \"projects/api-test-project/companies/123\" AND\nrequisitionId = \"req-1\"","type":"string"}},"type":"object"},"BucketRange":{"description":"Represents starting and ending value of a range in double.","properties":{"from":{"description":"Starting value of the bucket range.","format":"double","type":"number"},"to":{"description":"Ending value of the bucket range.","format":"double","type":"number"}},"type":"object"},"BucketizedCount":{"description":"Represents count of jobs within one bucket.","properties":{"count":{"description":"Number of jobs whose numeric field value fall into `range`.","format":"int32","type":"integer"},"range":{"$ref":"#/components/schemas/BucketRange"}},"type":"object"},"ClientEvent":{"description":"An event issued when an end user interacts with the application that\nimplements Cloud Talent Solution. Providing this information improves the\nquality of search and recommendation for the API clients, enabling the\nservice to perform optimally. The number of events sent must be consistent\nwith other calls, such as job searches, issued to the service by the client.","properties":{"createTime":{"description":"Required.\n\nThe timestamp of the event.","format":"google-datetime","type":"string"},"eventId":{"description":"Required.\n\nA unique identifier, generated by the client application. This `event_id`\nis used to establish the relationship between different events\n(see parent_event_id).","type":"string"},"extraInfo":{"additionalProperties":{"type":"string"},"description":"Optional.\n\nExtra information about this event. Used for storing information with no\nmatching field in event payload, for example, user application specific\ncontext or details.\n\nAt most 20 keys are supported. The maximum total size of all keys and\nvalues is 2 KB.","type":"object"},"jobEvent":{"$ref":"#/components/schemas/JobEvent"},"parentEventId":{"description":"Required except the first event.\n\nThe event_id of an event that resulted in the current event. For example, a\nJob view event usually follows a parent\nimpression event: A job seeker first does a\nsearch where a list of jobs appears\n(impression). The job seeker then selects a\nresult and views the description of a particular job (Job\nview).","type":"string"},"requestId":{"description":"Required.\n\nA unique ID generated in the API responses. It can be found in\nResponseMetadata.request_id.","type":"string"}},"type":"object"},"CommuteFilter":{"description":"Input only.\n\nParameters needed for commute search.","properties":{"allowImpreciseAddresses":{"description":"Optional.\nIf `true`, jobs without street level addresses may also be returned.\nFor city level addresses, the city center is used. For state and coarser\nlevel addresses, text matching is used.\nIf this field is set to `false` or is not specified, only jobs that include\nstreet level addresses will be returned by commute search.","type":"boolean"},"commuteMethod":{"description":"Required.\n\nThe method of transportation for which to calculate the commute time.","enum":["COMMUTE_METHOD_UNSPECIFIED","DRIVING","TRANSIT"],"type":"string"},"departureTime":{"$ref":"#/components/schemas/TimeOfDay"},"roadTraffic":{"description":"Optional.\n\nSpecifies the traffic density to use when calculating commute time.","enum":["ROAD_TRAFFIC_UNSPECIFIED","TRAFFIC_FREE","BUSY_HOUR"],"type":"string"},"startCoordinates":{"$ref":"#/components/schemas/LatLng"},"travelDuration":{"description":"Required.\n\nThe maximum travel time in seconds. The maximum allowed value is `3600s`\n(one hour). Format is `123s`.","format":"google-duration","type":"string"}},"type":"object"},"CommuteInfo":{"description":"Output only.\n\nCommute details related to this job.","properties":{"jobLocation":{"$ref":"#/components/schemas/Location"},"travelDuration":{"description":"The number of seconds required to travel to the job location from the\nquery location. A duration of 0 seconds indicates that the job is not\nreachable within the requested duration, but was returned as part of an\nexpanded query.","format":"google-duration","type":"string"}},"type":"object"},"Company":{"description":"A Company resource represents a company in the service. A company is the\nentity that owns job postings, that is, the hiring entity responsible for\nemploying applicants for the job position.","properties":{"careerSiteUri":{"description":"Optional.\n\nThe URI to employer's career site or careers page on the employer's web\nsite, for example, \"https://careers.google.com\".","type":"string"},"derivedInfo":{"$ref":"#/components/schemas/CompanyDerivedInfo"},"displayName":{"description":"Required.\n\nThe display name of the company, for example, \"Google, LLC\".","type":"string"},"eeoText":{"description":"Optional.\n\nEqual Employment Opportunity legal disclaimer text to be\nassociated with all jobs, and typically to be displayed in all\nroles.\n\nThe maximum number of allowed characters is 500.","type":"string"},"externalId":{"description":"Required.\n\nClient side company identifier, used to uniquely identify the\ncompany.\n\nThe maximum number of allowed characters is 255.","type":"string"},"headquartersAddress":{"description":"Optional.\n\nThe street address of the company's main headquarters, which may be\ndifferent from the job location. The service attempts\nto geolocate the provided address, and populates a more specific\nlocation wherever possible in DerivedInfo.headquarters_location.","type":"string"},"hiringAgency":{"description":"Optional.\n\nSet to true if it is the hiring agency that post jobs for other\nemployers.\n\nDefaults to false if not provided.","type":"boolean"},"imageUri":{"description":"Optional.\n\nA URI that hosts the employer's company logo.","type":"string"},"keywordSearchableJobCustomAttributes":{"description":"Optional.\n\nA list of keys of filterable Job.custom_attributes, whose\ncorresponding `string_values` are used in keyword search. Jobs with\n`string_values` under these specified field keys are returned if any\nof the values matches the search keyword. Custom field values with\nparenthesis, brackets and special symbols won't be properly searchable,\nand those keyword queries need to be surrounded by quotes.","items":{"type":"string"},"type":"array"},"name":{"description":"Required during company update.\n\nThe resource name for a company. This is generated by the service when a\ncompany is created.\n\nThe format is \"projects/{project_id}/companies/{company_id}\", for example,\n\"projects/api-test-project/companies/foo\".","type":"string"},"size":{"description":"Optional.\n\nThe employer's company size.","enum":["COMPANY_SIZE_UNSPECIFIED","MINI","SMALL","SMEDIUM","MEDIUM","BIG","BIGGER","GIANT"],"type":"string"},"suspended":{"description":"Output only. Indicates whether a company is flagged to be suspended from\npublic availability by the service when job content appears suspicious,\nabusive, or spammy.","type":"boolean"},"websiteUri":{"description":"Optional.\n\nThe URI representing the company's primary web site or home page,\nfor example, \"https://www.google.com\".\n\nThe maximum number of allowed characters is 255.","type":"string"}},"type":"object"},"CompanyDerivedInfo":{"description":"Derived details about the company.","properties":{"headquartersLocation":{"$ref":"#/components/schemas/Location"}},"type":"object"},"CompensationEntry":{"description":"A compensation entry that represents one component of compensation, such\nas base pay, bonus, or other compensation type.\n\nAnnualization: One compensation entry can be annualized if\n- it contains valid amount or range.\n- and its expected_units_per_year is set or can be derived.\nIts annualized range is determined as (amount or range) times\nexpected_units_per_year.","properties":{"amount":{"$ref":"#/components/schemas/Money"},"description":{"description":"Optional.\n\nCompensation description.  For example, could\nindicate equity terms or provide additional context to an estimated\nbonus.","type":"string"},"expectedUnitsPerYear":{"description":"Optional.\n\nExpected number of units paid each year. If not specified, when\nJob.employment_types is FULLTIME, a default value is inferred\nbased on unit. Default values:\n- HOURLY: 2080\n- DAILY: 260\n- WEEKLY: 52\n- MONTHLY: 12\n- ANNUAL: 1","format":"double","type":"number"},"range":{"$ref":"#/components/schemas/CompensationRange"},"type":{"description":"Optional.\n\nCompensation type.\n\nDefault is CompensationUnit.OTHER_COMPENSATION_TYPE.","enum":["COMPENSATION_TYPE_UNSPECIFIED","BASE","BONUS","SIGNING_BONUS","EQUITY","PROFIT_SHARING","COMMISSIONS","TIPS","OTHER_COMPENSATION_TYPE"],"type":"string"},"unit":{"description":"Optional.\n\nFrequency of the specified amount.\n\nDefault is CompensationUnit.OTHER_COMPENSATION_UNIT.","enum":["COMPENSATION_UNIT_UNSPECIFIED","HOURLY","DAILY","WEEKLY","MONTHLY","YEARLY","ONE_TIME","OTHER_COMPENSATION_UNIT"],"type":"string"}},"type":"object"},"CompensationFilter":{"description":"Input only.\n\nFilter on job compensation type and amount.","properties":{"includeJobsWithUnspecifiedCompensationRange":{"description":"Optional.\n\nWhether to include jobs whose compensation range is unspecified.","type":"boolean"},"range":{"$ref":"#/components/schemas/CompensationRange"},"type":{"description":"Required.\n\nType of filter.","enum":["FILTER_TYPE_UNSPECIFIED","UNIT_ONLY","UNIT_AND_AMOUNT","ANNUALIZED_BASE_AMOUNT","ANNUALIZED_TOTAL_AMOUNT"],"type":"string"},"units":{"description":"Required.\n\nSpecify desired `base compensation entry's`\nCompensationInfo.CompensationUnit.","items":{"enum":["COMPENSATION_UNIT_UNSPECIFIED","HOURLY","DAILY","WEEKLY","MONTHLY","YEARLY","ONE_TIME","OTHER_COMPENSATION_UNIT"],"type":"string"},"type":"array"}},"type":"object"},"CompensationHistogramRequest":{"description":"Input only.\n\nCompensation based histogram request.","properties":{"bucketingOption":{"$ref":"#/components/schemas/NumericBucketingOption"},"type":{"description":"Required.\n\nType of the request, representing which field the histogramming should be\nperformed over. A single request can only specify one histogram of each\n`CompensationHistogramRequestType`.","enum":["COMPENSATION_HISTOGRAM_REQUEST_TYPE_UNSPECIFIED","BASE","ANNUALIZED_BASE","ANNUALIZED_TOTAL"],"type":"string"}},"type":"object"},"CompensationHistogramResult":{"description":"Output only.\n\nCompensation based histogram result.","properties":{"result":{"$ref":"#/components/schemas/NumericBucketingResult"},"type":{"description":"Type of the request, corresponding to\nCompensationHistogramRequest.type.","enum":["COMPENSATION_HISTOGRAM_REQUEST_TYPE_UNSPECIFIED","BASE","ANNUALIZED_BASE","ANNUALIZED_TOTAL"],"type":"string"}},"type":"object"},"CompensationInfo":{"description":"Job compensation details.","properties":{"annualizedBaseCompensationRange":{"$ref":"#/components/schemas/CompensationRange"},"annualizedTotalCompensationRange":{"$ref":"#/components/schemas/CompensationRange"},"entries":{"description":"Optional.\n\nJob compensation information.\n\nAt most one entry can be of type\nCompensationInfo.CompensationType.BASE, which is\nreferred as ** base compensation entry ** for the job.","items":{"$ref":"#/components/schemas/CompensationEntry"},"type":"array"}},"type":"object"},"CompensationRange":{"description":"Compensation range.","properties":{"maxCompensation":{"$ref":"#/components/schemas/Money"},"minCompensation":{"$ref":"#/components/schemas/Money"}},"type":"object"},"CompleteQueryResponse":{"description":"Output only.\n\nResponse of auto-complete query.","properties":{"completionResults":{"description":"Results of the matching job/company candidates.","items":{"$ref":"#/components/schemas/CompletionResult"},"type":"array"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object"},"CompletionResult":{"description":"Output only.\n\nResource that represents completion results.","properties":{"imageUri":{"description":"The URI of the company image for CompletionType.COMPANY_NAME.","type":"string"},"suggestion":{"description":"The suggestion for the query.","type":"string"},"type":{"description":"The completion topic.","enum":["COMPLETION_TYPE_UNSPECIFIED","JOB_TITLE","COMPANY_NAME","COMBINED"],"type":"string"}},"type":"object"},"CreateClientEventRequest":{"description":"The report event request.","properties":{"clientEvent":{"$ref":"#/components/schemas/ClientEvent"}},"type":"object"},"CreateCompanyRequest":{"description":"Input only.\n\nThe Request of the CreateCompany method.","properties":{"company":{"$ref":"#/components/schemas/Company"}},"type":"object"},"CreateJobRequest":{"description":"Input only.\n\nCreate job request.","properties":{"job":{"$ref":"#/components/schemas/Job"}},"type":"object"},"CustomAttribute":{"description":"Custom attribute values that are either filterable or non-filterable.","properties":{"filterable":{"description":"Optional.\n\nIf the `filterable` flag is true, custom field values are searchable.\nIf false, values are not searchable.\n\nDefault is false.","type":"boolean"},"longValues":{"description":"Optional but exactly one of string_values or long_values must\nbe specified.\n\nThis field is used to perform number range search.\n(`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`.\n\nCurrently at most 1 long_values is supported.","items":{"format":"int64","type":"string"},"type":"array"},"stringValues":{"description":"Optional but exactly one of string_values or long_values must\nbe specified.\n\nThis field is used to perform a string match (`CASE_SENSITIVE_MATCH` or\n`CASE_INSENSITIVE_MATCH`) search.\nFor filterable `string_value`s, a maximum total number of 200 values\nis allowed, with each `string_value` has a byte size of no more than\n255B. For unfilterable `string_values`, the maximum total byte size of\nunfilterable `string_values` is 50KB.\n\nEmpty string is not allowed.","items":{"type":"string"},"type":"array"}},"type":"object"},"CustomAttributeHistogramRequest":{"description":"Custom attributes histogram request. An error is thrown if neither\nstring_value_histogram or long_value_histogram_bucketing_option has\nbeen defined.","properties":{"key":{"description":"Required.\n\nSpecifies the custom field key to perform a histogram on. If specified\nwithout `long_value_histogram_bucketing_option`, histogram on string values\nof the given `key` is triggered, otherwise histogram is performed on long\nvalues.","type":"string"},"longValueHistogramBucketingOption":{"$ref":"#/components/schemas/NumericBucketingOption"},"stringValueHistogram":{"description":"Optional. If set to true, the response includes the histogram value for\neach key as a string.","type":"boolean"}},"type":"object"},"CustomAttributeHistogramResult":{"description":"Output only.\n\nCustom attribute histogram result.","properties":{"key":{"description":"Stores the key of custom attribute the histogram is performed on.","type":"string"},"longValueHistogramResult":{"$ref":"#/components/schemas/NumericBucketingResult"},"stringValueHistogramResult":{"additionalProperties":{"format":"int32","type":"integer"},"description":"Stores a map from the values of string custom field associated\nwith `key` to the number of jobs with that value in this histogram result.","type":"object"}},"type":"object"},"DeviceInfo":{"description":"Device information collected from the job seeker, candidate, or\nother entity conducting the job search. Providing this information improves\nthe quality of the search results across devices.","properties":{"deviceType":{"description":"Optional.\n\nType of the device.","enum":["DEVICE_TYPE_UNSPECIFIED","WEB","MOBILE_WEB","ANDROID","IOS","BOT","OTHER"],"type":"string"},"id":{"description":"Optional.\n\nA device-specific ID. The ID must be a unique identifier that\ndistinguishes the device from other devices.","type":"string"}},"type":"object"},"Empty":{"description":"A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n    service Foo {\n      rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n    }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.","properties":{},"type":"object"},"HistogramFacets":{"description":"Input only.\n\nHistogram facets to be specified in SearchJobsRequest.","properties":{"compensationHistogramFacets":{"description":"Optional.\n\nSpecifies compensation field-based histogram requests.\nDuplicate values of CompensationHistogramRequest.type are not allowed.","items":{"$ref":"#/components/schemas/CompensationHistogramRequest"},"type":"array"},"customAttributeHistogramFacets":{"description":"Optional.\n\nSpecifies the custom attributes histogram requests.\nDuplicate values of CustomAttributeHistogramRequest.key are not\nallowed.","items":{"$ref":"#/components/schemas/CustomAttributeHistogramRequest"},"type":"array"},"simpleHistogramFacets":{"description":"Optional.\n\nSpecifies the simple type of histogram facets, for example,\n`COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.","items":{"enum":["SEARCH_TYPE_UNSPECIFIED","COMPANY_ID","EMPLOYMENT_TYPE","COMPANY_SIZE","DATE_PUBLISHED","EDUCATION_LEVEL","EXPERIENCE_LEVEL","ADMIN_1","COUNTRY","CITY","LOCALE","LANGUAGE","CATEGORY","CITY_COORDINATE","ADMIN_1_COUNTRY","COMPANY_DISPLAY_NAME","BASE_COMPENSATION_UNIT"],"type":"string"},"type":"array"}},"type":"object"},"HistogramResult":{"description":"Output only.\n\nResult of a histogram call. The response contains the histogram map for the\nsearch type specified by HistogramResult.field.\nThe response is a map of each filter value to the corresponding count of\njobs for that filter.","properties":{"searchType":{"description":"The Histogram search filters.","enum":["SEARCH_TYPE_UNSPECIFIED","COMPANY_ID","EMPLOYMENT_TYPE","COMPANY_SIZE","DATE_PUBLISHED","EDUCATION_LEVEL","EXPERIENCE_LEVEL","ADMIN_1","COUNTRY","CITY","LOCALE","LANGUAGE","CATEGORY","CITY_COORDINATE","ADMIN_1_COUNTRY","COMPANY_DISPLAY_NAME","BASE_COMPENSATION_UNIT"],"type":"string"},"values":{"additionalProperties":{"format":"int32","type":"integer"},"description":"A map from the values of field to the number of jobs with that value\nin this search result.\n\nKey: search type (filter names, such as the companyName).\n\nValues: the count of jobs that match the filter for this search.","type":"object"}},"type":"object"},"HistogramResults":{"description":"Output only.\n\nHistogram results that match HistogramFacets specified in\nSearchJobsRequest.","properties":{"compensationHistogramResults":{"description":"Specifies compensation field-based histogram results that match\nHistogramFacets.compensation_histogram_requests.","items":{"$ref":"#/components/schemas/CompensationHistogramResult"},"type":"array"},"customAttributeHistogramResults":{"description":"Specifies histogram results for custom attributes that match\nHistogramFacets.custom_attribute_histogram_facets.","items":{"$ref":"#/components/schemas/CustomAttributeHistogramResult"},"type":"array"},"simpleHistogramResults":{"description":"Specifies histogram results that matches\nHistogramFacets.simple_histogram_facets.","items":{"$ref":"#/components/schemas/HistogramResult"},"type":"array"}},"type":"object"},"Job":{"description":"A Job resource represents a job posting (also referred to as a \"job listing\"\nor \"job requisition\"). A job belongs to a Company, which is the hiring\nentity responsible for the job.","properties":{"addresses":{"description":"Optional but strongly recommended for the best service experience.\n\nLocation(s) where the employer is looking to hire for this job posting.\n\nSpecifying the full street address(es) of the hiring location enables\nbetter API results, especially job searches by commute time.\n\nAt most 50 locations are allowed for best search performance. If a job has\nmore locations, it is suggested to split it into multiple jobs with unique\nrequisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as\nmultiple jobs with the same company_name, language_code and\nrequisition_id are not allowed. If the original requisition_id must\nbe preserved, a custom field should be used for storage. It is also\nsuggested to group the locations that close to each other in the same job\nfor better search experience.\n\nThe maximum number of allowed characters is 500.","items":{"type":"string"},"type":"array"},"applicationInfo":{"$ref":"#/components/schemas/ApplicationInfo"},"companyDisplayName":{"description":"Output only. Display name of the company listing the job.","type":"string"},"companyName":{"description":"Required.\n\nThe resource name of the company listing the job, such as\n\"projects/api-test-project/companies/foo\".","type":"string"},"compensationInfo":{"$ref":"#/components/schemas/CompensationInfo"},"customAttributes":{"additionalProperties":{"$ref":"#/components/schemas/CustomAttribute"},"description":"Optional.\n\nA map of fields to hold both filterable and non-filterable custom job\nattributes that are not covered by the provided structured fields.\n\nThe keys of the map are strings up to 64 bytes and must match the\npattern: a-zA-Z*. For example, key0LikeThis or\nKEY_1_LIKE_THIS.\n\nAt most 100 filterable and at most 100 unfilterable keys are supported.\nFor filterable `string_values`, across all keys at most 200 values are\nallowed, with each string no more than 255 characters. For unfilterable\n`string_values`, the maximum total size of `string_values` across all keys\nis 50KB.","type":"object"},"degreeTypes":{"description":"Optional.\n\nThe desired education degrees for the job, such as Bachelors, Masters.","items":{"enum":["DEGREE_TYPE_UNSPECIFIED","PRIMARY_EDUCATION","LOWER_SECONDARY_EDUCATION","UPPER_SECONDARY_EDUCATION","ADULT_REMEDIAL_EDUCATION","ASSOCIATES_OR_EQUIVALENT","BACHELORS_OR_EQUIVALENT","MASTERS_OR_EQUIVALENT","DOCTORAL_OR_EQUIVALENT"],"type":"string"},"type":"array"},"department":{"description":"Optional.\n\nThe department or functional area within the company with the open\nposition.\n\nThe maximum number of allowed characters is 255.","type":"string"},"derivedInfo":{"$ref":"#/components/schemas/JobDerivedInfo"},"description":{"description":"Required.\n\nThe description of the job, which typically includes a multi-paragraph\ndescription of the company and related information. Separate fields are\nprovided on the job object for responsibilities,\nqualifications, and other job characteristics. Use of\nthese separate job fields is recommended.\n\nThis field accepts and sanitizes HTML input, and also accepts\nbold, italic, ordered list, and unordered list markup tags.\n\nThe maximum number of allowed characters is 100,000.","type":"string"},"employmentTypes":{"description":"Optional.\n\nThe employment type(s) of a job, for example,\nfull time or\npart time.","items":{"enum":["EMPLOYMENT_TYPE_UNSPECIFIED","FULL_TIME","PART_TIME","CONTRACTOR","CONTRACT_TO_HIRE","TEMPORARY","INTERN","VOLUNTEER","PER_DIEM","FLY_IN_FLY_OUT","OTHER_EMPLOYMENT_TYPE"],"type":"string"},"type":"array"},"incentives":{"description":"Optional.\n\nA description of bonus, commission, and other compensation\nincentives associated with the job not including salary or pay.\n\nThe maximum number of allowed characters is 10,000.","type":"string"},"jobBenefits":{"description":"Optional.\n\nThe benefits included with the job.","items":{"enum":["JOB_BENEFIT_UNSPECIFIED","CHILD_CARE","DENTAL","DOMESTIC_PARTNER","FLEXIBLE_HOURS","MEDICAL","LIFE_INSURANCE","PARENTAL_LEAVE","RETIREMENT_PLAN","SICK_DAYS","VACATION","VISION"],"type":"string"},"type":"array"},"jobEndTime":{"description":"Optional.\n\nThe end timestamp of the job. Typically this field is used for contracting\nengagements. Invalid timestamps are ignored.","format":"google-datetime","type":"string"},"jobLevel":{"description":"Optional.\n\nThe experience level associated with the job, such as \"Entry Level\".","enum":["JOB_LEVEL_UNSPECIFIED","ENTRY_LEVEL","EXPERIENCED","MANAGER","DIRECTOR","EXECUTIVE"],"type":"string"},"jobStartTime":{"description":"Optional.\n\nThe start timestamp of the job in UTC time zone. Typically this field\nis used for contracting engagements. Invalid timestamps are ignored.","format":"google-datetime","type":"string"},"languageCode":{"description":"Optional.\n\nThe language of the posting. This field is distinct from\nany requirements for fluency that are associated with the job.\n\nLanguage codes must be in BCP-47 format, such as \"en-US\" or \"sr-Latn\".\nFor more information, see\n[Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:\nclass=\"external\" target=\"_blank\" }.\n\nIf this field is unspecified and Job.description is present, detected\nlanguage code based on Job.description is assigned, otherwise\ndefaults to 'en_US'.","type":"string"},"name":{"description":"Required during job update.\n\nThe resource name for the job. This is generated by the service when a\njob is created.\n\nThe format is \"projects/{project_id}/jobs/{job_id}\",\nfor example, \"projects/api-test-project/jobs/1234\".\n\nUse of this field in job queries and API calls is preferred over the use of\nrequisition_id since this value is unique.","type":"string"},"postingCreateTime":{"description":"Output only. The timestamp when this job posting was created.","format":"google-datetime","type":"string"},"postingExpireTime":{"description":"Optional but strongly recommended for the best service\nexperience.\n\nThe expiration timestamp of the job. After this timestamp, the\njob is marked as expired, and it no longer appears in search results. The\nexpired job can't be deleted or listed by the DeleteJob and\nListJobs APIs, but it can be retrieved with the GetJob API or\nupdated with the UpdateJob API. An expired job can be updated and\nopened again by using a future expiration timestamp. Updating an expired\njob fails if there is another existing open job with same company_name,\nlanguage_code and requisition_id.\n\nThe expired jobs are retained in our system for 90 days. However, the\noverall expired job count cannot exceed 3 times the maximum of open jobs\ncount over the past week, otherwise jobs with earlier expire time are\ncleaned first. Expired jobs are no longer accessible after they are cleaned\nout.\n\nInvalid timestamps are ignored, and treated as expire time not provided.\n\nTimestamp before the instant re