We’ve made the difficult decision to sunset Hire by Google on September 1, 2020. Learn more.

REST Resource: tenants.applications

Resource: Application

A job application in Hire.

JSON representation
{
  "name": string,
  "job": string,
  "candidate": string,
  "createTime": string,
  "creatingUser": string,
  "status": {
    object (Status)
  }
}
Fields
name

string

The resource name of this application. Application name takes the form of "tenants/*/applications/*".

job

string

Resource name of the job that this application is for. It must have the format of "tenants/*/jobs/*".

candidate

string

Resource name of the candidate that is submitting this application. It must have the format of "tenants/*/candidates/*".

createTime

string (Timestamp format)

Date the application was created or the date specified when importing this application.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

creatingUser

string

Resource name of the user that created the application. It must have the format "tenants/*/users/*"

status

object (Status)

Application status

Status

Specifies all information related to an applicant's status in the application process.

JSON representation
{
  "state": enum (State),
  "processStage": {
    object (ProcessStage)
  },
  "rejectionReason": string,
  "updateTime": string
}
Fields
state

enum (State)

The application state specifies the general state of the application.

processStage

object (ProcessStage)

Process stage specifices how far into the interview process a candidate is. Process stage can be set only when a application state is Application.Status.State.ACTIVE.

rejectionReason

string

Reason for rejection, only populated when the application state is Application.Status.State.REJECTED.

updateTime

string (Timestamp format)

Update time for all fields in Application.Status.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

State

Application states

Enums
STATE_UNSPECIFIED No application state specified
PROSPECTIVE The hiring team or applicant is interested, but a formal application has not yet been submitted.
ACTIVE An application has been submitted; the applicant is being assessed, or an offer has been extended and has not been accepted.
REJECTED The application has been rejected by either the company or candidate.
ACCEPTED An offer letter for this application has been sent to and signed by the candidate.

ProcessStage

The current interview process stage that the candidate is in. It is only used when a application state is Application.Status.State.ACTIVE.

JSON representation
{
  "stage": string,
  "reportingCategory": enum (ReportingCategory)
}
Fields
stage

string

Stage is a descriptor that further specifies a reporting category. For example, if reporting category is INTERVIEW, possible stage names could include, "First round interview" or "Final round interview". Stage allows for further customization for the user.

reportingCategory

enum (ReportingCategory)

The reporting category is a stable set of values used for grouping process stages across different hiring processes

ReportingCategory

Describes the reporting category in which an application is in.

Enums
REPORTING_CATEGORY_UNSPECIFIED Reporting category is unspecified. Should always be unspecified when Application.Status.State is not Application.Status.State.ACTIVE.
NEW Application is in the New category.
SCREEN Application is in the Screen category.
INTERVIEW Application is in the Interview category.
OFFER Application is in the Offer category.

Methods

get

Get an application in Hire.

list

List the applications in Hire.