Class Job
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.
Inheritance
Implements
Inherited Members
Namespace: Google.Apis.CloudTalentSolution.v2.Data
Assembly: Google.Apis.CloudTalentSolution.v2.dll
Syntax
public class Job : IDirectResponseSchema
Properties
ApplicationEmailList
Optional but at least one of application_urls, application_email_list or application_instruction must be specified. Use this field to specify email address(es) to which resumes or applications can be sent. The maximum number of allowed characters is 255.
Declaration
[JsonProperty("applicationEmailList")]
public virtual IList<string> ApplicationEmailList { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
ApplicationInstruction
Optional but at least one of application_urls, application_email_list or application_instruction must be specified. 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.
Declaration
[JsonProperty("applicationInstruction")]
public virtual string ApplicationInstruction { get; set; }
Property Value
Type | Description |
---|---|
System.String |
ApplicationUrls
Optional but at least one of application_urls, application_email_list or application_instruction must be specified. Use this URL field to direct an applicant to a website, for example to link to an online application form. The maximum number of allowed characters is 2,000.
Declaration
[JsonProperty("applicationUrls")]
public virtual IList<string> ApplicationUrls { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
Benefits
Optional. The benefits included with the job.
Declaration
[JsonProperty("benefits")]
public virtual IList<string> Benefits { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
CompanyDisplayName
Output only. The name of the company listing the job.
Declaration
[JsonProperty("companyDisplayName")]
public virtual string CompanyDisplayName { get; set; }
Property Value
Type | Description |
---|---|
System.String |
CompanyName
Optional but one of company_name or distributor_company_id must be provided. The resource name of the company listing the job, such as /companies/foo. This field takes precedence over the distributor- assigned company identifier, distributor_company_id.
Declaration
[JsonProperty("companyName")]
public virtual string CompanyName { get; set; }
Property Value
Type | Description |
---|---|
System.String |
CompanyTitle
Deprecated. Use company_display_name instead. Output only. The name of the company listing the job.
Declaration
[JsonProperty("companyTitle")]
public virtual string CompanyTitle { get; set; }
Property Value
Type | Description |
---|---|
System.String |
CompensationInfo
Optional. Job compensation information.
Declaration
[JsonProperty("compensationInfo")]
public virtual CompensationInfo CompensationInfo { get; set; }
Property Value
Type | Description |
---|---|
CompensationInfo |
CreateTime
Output only. The timestamp when this job was created.
Declaration
[JsonProperty("createTime")]
public virtual object CreateTime { get; set; }
Property Value
Type | Description |
---|---|
System.Object |
CustomAttributes
Optional. A map of fields to hold both filterable and non-filterable custom job attributes that are
not covered by the provided structured fields. This field is a more general combination of the deprecated
id-based filterable_custom_fields and string-based non_filterable_custom_fields. The keys of the map are
strings up to 64 bytes and must match the pattern: a-zA-Z*. 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.
Declaration
[JsonProperty("customAttributes")]
public virtual IDictionary<string, CustomAttribute> CustomAttributes { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IDictionary<System.String, CustomAttribute> |
Department
Optional. The department or functional area within the company with the open position. The maximum number of allowed characters is 255.
Declaration
[JsonProperty("department")]
public virtual string Department { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Description
Required. The description of the job, which typically includes a multi-paragraph description of the company and related information. Separate fields are provided on the job object for responsibilities, qualifications, and other job characteristics. Use of these separate job fields is recommended. 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 100,000.
Declaration
[JsonProperty("description")]
public virtual string Description { get; set; }
Property Value
Type | Description |
---|---|
System.String |
DistributorCompanyId
Optional but one of company_name or distributor_company_id must be provided. A unique company identifier used by job distributors to identify an employer's company entity. company_name takes precedence over this field, and is the recommended field to use to identify companies. The maximum number of allowed characters is 255.
Declaration
[JsonProperty("distributorCompanyId")]
public virtual string DistributorCompanyId { get; set; }
Property Value
Type | Description |
---|---|
System.String |
EducationLevels
Optional. The desired education level for the job, such as "Bachelors", "Masters", "Doctorate".
Declaration
[JsonProperty("educationLevels")]
public virtual IList<string> EducationLevels { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
EmploymentTypes
Optional. The employment type(s) of a job, for example, full time or part time.
Declaration
[JsonProperty("employmentTypes")]
public virtual IList<string> EmploymentTypes { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
EndDate
Optional. The end date of the job in UTC time zone. Typically this field is used for contracting engagements. Dates prior to 1970/1/1 and invalid date formats are ignored.
Declaration
[JsonProperty("endDate")]
public virtual Date EndDate { get; set; }
Property Value
Type | Description |
---|---|
Date |
ETag
The ETag of the item.
Declaration
public virtual string ETag { get; set; }
Property Value
Type | Description |
---|---|
System.String |
ExpireTime
Optional but strongly recommended for the best service experience. The expiration timestamp of the job. After this timestamp, the job is marked as expired, and it no longer appears in search results. The expired job can't be deleted or listed by the DeleteJob and ListJobs APIs, but it can be retrieved with the GetJob API or updated with the UpdateJob API. An expired job can be updated and opened again by using a future expiration timestamp. Updating an expired job fails if there is another existing open job with same requisition_id, company_name and language_code. The expired jobs are retained in our system for 90 days. However, the overall expired job count cannot exceed 3 times the maximum of open jobs count over the past week, otherwise jobs with earlier expire time are cleaned first. Expired jobs are no longer accessible after they are cleaned out. The format of this field is RFC 3339 date strings. Example: 2000-01-01T00:00:00.999999999Z See https://www.ietf.org/rfc/rfc3339.txt. A valid date range is between 1970-01-01T00:00:00.0Z and 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire time not provided. If this value is not provided at the time of job creation or is invalid, the job posting expires after 30 days from the job's creation time. For example, if the job was created on 2017/01/01 13:00AM UTC with an unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC. If this value is not provided but expiry_date is, expiry_date is used. If this value is not provided on job update, it depends on the field masks set by UpdateJobRequest.update_job_fields. If the field masks include expiry_time, or the masks are empty meaning that every field is updated, the job posting expires after 30 days from the job's last update time. Otherwise the expiration date isn't updated.
Declaration
[JsonProperty("expireTime")]
public virtual object ExpireTime { get; set; }
Property Value
Type | Description |
---|---|
System.Object |
ExpiryDate
Deprecated. Use expire_time instead. Optional but strongly recommended to be provided for the best service experience. The expiration date of the job in UTC time. After 12 am on this date, the job is marked as expired, and it no longer appears in search results. The expired job can't be deleted or listed by the DeleteJob and ListJobs APIs, but it can be retrieved with the GetJob API or updated with the UpdateJob API. An expired job can be updated and opened again by using a future expiration date. It can also remain expired. Updating an expired job to be open fails if there is another existing open job with same requisition_id, company_name and language_code. The expired jobs are retained in our system for 90 days. However, the overall expired job count cannot exceed 3 times the maximum of open jobs count over the past week, otherwise jobs with earlier expire time are removed first. Expired jobs are no longer accessible after they are cleaned out. A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are ignored and treated as expiry date not provided. If this value is not provided on job creation or is invalid, the job posting expires after 30 days from the job's creation time. For example, if the job was created on 2017/01/01 13:00AM UTC with an unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC. If this value is not provided on job update, it depends on the field masks set by UpdateJobRequest.update_job_fields. If the field masks include expiry_date, or the masks are empty meaning that every field is updated, the job expires after 30 days from the job's last update time. Otherwise the expiration date isn't updated.
Declaration
[JsonProperty("expiryDate")]
public virtual Date ExpiryDate { get; set; }
Property Value
Type | Description |
---|---|
Date |
ExtendedCompensationInfo
Deprecated. Always use compensation_info. Optional. Job compensation information. This field replaces compensation_info. Only CompensationInfo.entries or extended_compensation_info can be set, otherwise an exception is thrown.
Declaration
[JsonProperty("extendedCompensationInfo")]
public virtual ExtendedCompensationInfo ExtendedCompensationInfo { get; set; }
Property Value
Type | Description |
---|---|
ExtendedCompensationInfo |
FilterableCustomFields
Deprecated. Use custom_attributes instead. Optional. A map of fields to hold filterable custom job attributes not captured by the standard fields such as job_title, company_name, or level. These custom fields store arbitrary string values, and can be used for purposes not covered by the structured fields. For the best search experience, use of the structured rather than custom fields is recommended. Data stored in these custom fields fields are indexed and searched against by keyword searches (see SearchJobsRequest.custom_field_filters][]). The map key must be a number between 1-20. If an invalid key is provided on job create or update, an error is returned.
Declaration
[JsonProperty("filterableCustomFields")]
public virtual IDictionary<string, CustomField> FilterableCustomFields { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IDictionary<System.String, CustomField> |
Incentives
Optional. 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.
Declaration
[JsonProperty("incentives")]
public virtual string Incentives { get; set; }
Property Value
Type | Description |
---|---|
System.String |
JobLocations
Output only. Structured locations of the job, resolved from locations.
Declaration
[JsonProperty("jobLocations")]
public virtual IList<JobLocation> JobLocations { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<JobLocation> |
JobTitle
Required. The title of the job, such as "Software Engineer" The maximum number of allowed characters is 500.
Declaration
[JsonProperty("jobTitle")]
public virtual string JobTitle { get; set; }
Property Value
Type | Description |
---|---|
System.String |
LanguageCode
Optional. The language of the posting. This field is distinct from any requirements for fluency that are associated with the job. Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages{: class="external" target="_blank" }. If this field is unspecified and Job.description is present, detected language code based on Job.description is assigned, otherwise defaults to 'en_US'.
Declaration
[JsonProperty("languageCode")]
public virtual string LanguageCode { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Level
Optional. The experience level associated with the job, such as "Entry Level".
Declaration
[JsonProperty("level")]
public virtual string Level { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Locations
Optional but strongly recommended for the best service experience. Location(s) where the emploeyer 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 requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as multiple jobs with the same requisition_id, company_name and language_code are not allowed. If the original 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.
Declaration
[JsonProperty("locations")]
public virtual IList<string> Locations { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IList<System.String> |
Name
Required during job update. Resource name assigned to a job by the API, for example, "/jobs/foo". Use of this field in job queries and API calls is preferred over the use of requisition_id since this value is unique.
Declaration
[JsonProperty("name")]
public virtual string Name { get; set; }
Property Value
Type | Description |
---|---|
System.String |
PromotionValue
Optional. A promotion value of the job, as determined by the client. The value determines the sort order of the jobs returned when searching for jobs using the featured jobs search call, with higher promotional values being returned first and ties being resolved by relevance sort. Only the jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH. Default value is 0, and negative values are treated as 0.
Declaration
[JsonProperty("promotionValue")]
public virtual int? PromotionValue { get; set; }
Property Value
Type | Description |
---|---|
System.Nullable<System.Int32> |
PublishDate
Optional. The date this job was most recently published in UTC format. The default value is the time the request arrives at the server.
Declaration
[JsonProperty("publishDate")]
public virtual Date PublishDate { get; set; }
Property Value
Type | Description |
---|---|
Date |
Qualifications
Optional. 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.
Declaration
[JsonProperty("qualifications")]
public virtual string Qualifications { get; set; }
Property Value
Type | Description |
---|---|
System.String |
ReferenceUrl
Output only. The URL of a web page that displays job details.
Declaration
[JsonProperty("referenceUrl")]
public virtual string ReferenceUrl { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Region
Optional. The job Region (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 if an exact location match is not specified. If this field is set, setting job locations to the same location level as this field is strongly recommended.
Declaration
[JsonProperty("region")]
public virtual string Region { get; set; }
Property Value
Type | Description |
---|---|
System.String |
RequisitionId
Required. The requisition ID, also referred to as the posting ID, assigned by the client to identify a job. This field is intended to be used by clients for client identification and tracking of listings. A job is not allowed to be created if there is another job with the same requisition_id, company_name and language_code. The maximum number of allowed characters is 255.
Declaration
[JsonProperty("requisitionId")]
public virtual string RequisitionId { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Responsibilities
Optional. A description of job responsibilities. 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.
Declaration
[JsonProperty("responsibilities")]
public virtual string Responsibilities { get; set; }
Property Value
Type | Description |
---|---|
System.String |
StartDate
Optional. The start date of the job in UTC time zone. Typically this field is used for contracting engagements. Dates prior to 1970/1/1 and invalid date formats are ignored.
Declaration
[JsonProperty("startDate")]
public virtual Date StartDate { get; set; }
Property Value
Type | Description |
---|---|
Date |
UnindexedCustomFields
Deprecated. Use custom_attributes instead. Optional. A map of fields to hold non-filterable custom job attributes, similar to filterable_custom_fields. These fields are distinct in that the data in these fields are not indexed. Therefore, the client cannot search against them, nor can the client use them to list jobs. The key of the map can be any valid string.
Declaration
[JsonProperty("unindexedCustomFields")]
public virtual IDictionary<string, CustomField> UnindexedCustomFields { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IDictionary<System.String, CustomField> |
UpdateTime
Output only. The timestamp when this job was last updated.
Declaration
[JsonProperty("updateTime")]
public virtual object UpdateTime { get; set; }
Property Value
Type | Description |
---|---|
System.Object |
Visibility
Optional. The visibility of the job. Defaults to JobVisibility.PRIVATE if not specified. Currently only JobVisibility.PRIVATE is supported.
Declaration
[JsonProperty("visibility")]
public virtual string Visibility { get; set; }
Property Value
Type | Description |
---|---|
System.String |