Class Job (0.4.0)

A Job resource represents a job posting (also referred to as a "job listing" or "job requisition"). A job belongs to a Company, which is the hiring entity responsible for the job.

Required. The resource name of the company listing the job. The format is "projects/{project_id}/tenants/{tenant_id}/com panies/{company_id}". For example, "projects/foo/tenants/bar/companies/baz". If tenant id is unspecified, the default tenant is used. For example, "projects/foo/companies/bar".

Required. The title of the job, such as "Software Engineer" The maximum number of allowed characters is 500.

Strongly recommended for the best service experience. Location(s) where the employer is looking to hire for this job posting. Specifying the full street address(es) of the hiring location enables better API results, especially job searches by commute time. At most 50 locations are allowed for best search performance. If a job has more locations, it is suggested to split it into multiple jobs with unique [requisit ion_id][google.cloud.talent.v4beta1.Job.requisition_id]s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as multiple jobs with the same company, [language _code][google.cloud.talent.v4beta1.Job.language_code] and [re quisition_id][google.cloud.talent.v4beta1.Job.requisition_id ] are not allowed. If the original [requisition_id][google.cl oud.talent.v4beta1.Job.requisition_id] must be preserved, a custom field should be used for storage. It is also suggested to group the locations that close to each other in the same job for better search experience. The maximum number of allowed characters is 500.

The benefits included with the job.

A map of fields to hold both filterable and non-filterable custom job attributes that are not covered by the provided structured fields. The keys of the map are strings up to 64 bytes and must match the pattern: [a-zA-Z][a-zA-Z0-9_]*. For example, key0LikeThis or KEY_1_LIKE_THIS. At most 100 filterable and at most 100 unfilterable keys are supported. For filterable string_values, across all keys at most 200 values are allowed, with each string no more than 255 characters. For unfilterable string_values, the maximum total size of string_values across all keys is 50KB.

The department or functional area within the company with the open position. The maximum number of allowed characters is 255.

A description of bonus, commission, and other compensation incentives associated with the job not including salary or pay. The maximum number of allowed characters is 10,000.

The experience level associated with the job, such as "Entry Level".

A description of the qualifications required to perform the job. The use of this field is recommended as an alternative to using the more general description field. This field accepts and sanitizes HTML input, and also accepts bold, italic, ordered list, and unordered list markup tags. The maximum number of allowed characters is 10,000.

The job PostingRegion (for example, state, country) throughout which the job is available. If this field is set, a LocationFilter in a search query within the job region finds this job posting if an exact location match isn't specified. If this field is set to [PostingRegion.NATION][google.cloud.talent.v4beta1.Post ingRegion.NATION] or [PostingRegion.ADMINISTRATIVE_AREA][goog le.cloud.talent.v4beta1.PostingRegion.ADMINISTRATIVE_AREA], setting job Job.addresses to the same location level as this field is strongly recommended.

The start timestamp of the job in UTC time zone. Typically this field is used for contracting engagements. Invalid timestamps are ignored.

The timestamp this job posting was most recently published. The default value is the time the request arrives at the server. Invalid timestamps are ignored.

Output only. The timestamp when this job posting was created.

Output only. Display name of the company listing the job.

Options for job processing.

Classes

ApplicationInfo

Application related details of a job posting.

Use this field to provide instructions, such as "Mail your application to ...", that a candidate can follow to apply for the job. This field accepts and sanitizes HTML input, and also accepts bold, italic, ordered list, and unordered list markup tags. The maximum number of allowed characters is 3,000.

CustomAttributesEntry

API documentation for talent_v4beta1.types.Job.CustomAttributesEntry class.

DerivedInfo

Derived details about the job posting.

Job categories derived from Job.title and [Job.de scription][google.cloud.talent.v4beta1.Job.description].

ProcessingOptions

Options for job processing.

Option for job HTML content sanitization. Applied fields are:

  • description - applicationInfo.instruction - incentives - qualifications - responsibilities HTML tags in these fields may be stripped if sanitiazation isn't disabled. Defaults to [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talen t.v4beta1.HtmlSanitization.SIMPLE_FORMATTING_ONLY].