REST Resource: projects.tenants.jobs

Ressource: Job

Eine Jobressource stellt eine Stellenausschreibung (auch "Jobanzeige" oder "Jobanforderung" genannt) dar. Ein Job gehört zu einer Company, die als einstellende Entität für den Job verantwortlich ist.

JSON-Darstellung
{
  "name": string,
  "company": string,
  "requisitionId": string,
  "title": string,
  "description": string,
  "addresses": [
    string
  ],
  "applicationInfo": {
    object (ApplicationInfo)
  },
  "jobBenefits": [
    enum (JobBenefit)
  ],
  "compensationInfo": {
    object (CompensationInfo)
  },
  "customAttributes": {
    string: {
      object (CustomAttribute)
    },
    ...
  },
  "degreeTypes": [
    enum (DegreeType)
  ],
  "department": string,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "incentives": string,
  "languageCode": string,
  "jobLevel": enum (JobLevel),
  "promotionValue": integer,
  "qualifications": string,
  "responsibilities": string,
  "postingRegion": enum (PostingRegion),
  "visibility": enum (Visibility),
  "jobStartTime": string,
  "jobEndTime": string,
  "postingPublishTime": string,
  "postingExpireTime": string,
  "postingCreateTime": string,
  "postingUpdateTime": string,
  "companyDisplayName": string,
  "derivedInfo": {
    object (DerivedInfo)
  },
  "processingOptions": {
    object (ProcessingOptions)
  }
}
Felder
name

string

Erforderlich während der Jobaktualisierung.

Der Ressourcenname für den Job. Er wird vom Dienst generiert, wenn ein Job erstellt wird.

Das Format ist „projects/{projectId}/Mandanten/{MandantenId}/jobs/{job_id}“. Beispiel: „projects/foo/Mandanten/bar/jobs/baz“.

Wenn keine Mandanten-ID angegeben ist, wird der Standardmandant verwendet. Beispiel: „projects/foo/jobs/bar“.

Bei Jobabfragen und API-Aufrufen sollte dieses Feld bevorzugt verwendet werden, da dieser Wert im Gegensatz zu requisitionId eindeutig ist.

company

string

Erforderlich. Der Ressourcenname des Unternehmens, das den Job anbietet.

Das Format ist „projects/{projectId}/Mandanten/{MandantenId}/company/{company_id}“. Beispiel: „projects/foo/Mandanten/bar/company/baz“.

Wenn keine Mandanten-ID angegeben ist, wird der Standardmandant verwendet. Beispiel: „projects/foo/company/bar“.

requisitionId

string

Erforderlich. Die Anforderungs-ID (auch Posting-ID genannt), die vom Kunden zugewiesen wurde, um einen Job zu identifizieren. Dieses Feld ist für Kunden zur Kundenidentifikation und Nachverfolgung von Einträgen vorgesehen. Ein Job kann nicht erstellt werden, wenn ein anderer Job mit denselben company, languageCode und requisitionId vorhanden ist.

Es sind maximal 255 Zeichen zulässig.

title

string

Erforderlich. Die Bezeichnung des Jobs, z. B. "Software-Entwickler".

Es sind maximal 500 Zeichen zulässig.

description

string

Erforderlich. Die Beschreibung eines Jobs. In der Regel eine mehrere Absätze lange Beschreibung des Unternehmens und weitere Informationen. Im Jobobjekt gibt es separate Felder für responsibilities, qualifications und andere Jobmerkmale. Es empfiehlt sich, diese separaten Jobfelder zu verwenden.

In diesem Feld werden HTML-Eingaben akzeptiert und bereinigt. Markup-Tags wie Fett- und Kursivformatierung sowie sortierte und unsortierte Listen werden unterstützt.

Es sind maximal 100.000 Zeichen zulässig.

addresses[]

string

Dringend empfohlen für eine optimale Servicequalität.

Standort(e), an denen der Arbeitgeber für diese Stellenausschreibung suchen möchte.

Es empfiehlt sich, die Adressen des Einstellungsstandorts vollständig anzugeben. Die API erzielt dann bessere Ergebnisse, vor allem wenn Jobs anhand der Anfahrtszeit gesucht werden.

Für die beste Suchleistung sind maximal 50 Standorte zulässig. Wenn ein Job mehr Standorte hat, wird empfohlen, ihn in mehrere Jobs mit eindeutigen requisitionIds aufzuteilen (z.B. "ReqA" wird zu "ReqA-1", "ReqA-2" usw.), da nicht mehrere Jobs mit denselben company, languageCode und requisitionId zulässig sind. Wenn die ursprüngliche requisitionId beibehalten werden muss, sollte ein benutzerdefiniertes Feld zum Speichern verwendet werden. Zur Optimierung von Suchvorgängen empfiehlt es sich auch, die nah beieinander liegenden Standorte im selben Job zusammenzufassen.

Es sind maximal 500 Zeichen zulässig.

applicationInfo

object (ApplicationInfo)

Informationen zur Bewerbung.

jobBenefits[]

enum (JobBenefit)

Die in diesem Job enthaltenen Sozialleistungen.

compensationInfo

object (CompensationInfo)

Informationen zur Vergütung für den Job (auch „Lohnsatz“), d. h. die Vergütung, die an den Arbeitnehmer gezahlt wird.

customAttributes

map (key: string, value: object (CustomAttribute))

Eine Zuordnung von Feldern, die filterbare und nicht filterbare benutzerdefinierte Jobattribute enthalten, die nicht von den bereitgestellten strukturierten Feldern abgedeckt werden.

Die Schlüssel der Zuordnung sind Strings von bis zu 64 Byte und müssen mit dem Muster übereinstimmen: [a-zA-Z] [a-zA-Z0-9_]*. Zum Beispiel key0LikeThis oder KEY_1_LIKE_THIS.

Es werden maximal 100 filterbare und maximal 100 nicht filterbare Schlüssel unterstützt. Für filterbare stringValues sind in allen Schlüsseln maximal 200 Werte zulässig, wobei jeder String nicht mehr als 255 Zeichen lang sein darf. Für nicht filterbare stringValues beträgt die maximale Gesamtgröße von stringValues in allen Schlüsseln 50 KB.

degreeTypes[]

enum (DegreeType)

Die gewünschten Ausbildungsabschlüsse für den Job, wie Bachelor, Master.

department

string

Die Abteilung oder der Funktionsbereich mit der offenen Stelle innerhalb des Unternehmens.

Es sind maximal 255 Zeichen zulässig.

employmentTypes[]

enum (EmploymentType)

Die Beschäftigungsart eines Jobs, z. B. full time oder part time.

incentives

string

Eine Beschreibung besonderer Bonus-, Provisions- und anderer Sondervergütungen, die mit dem Job verbunden sind, abgesehen von Lohn oder Gehalt.

Es sind maximal 10.000 Zeichen zulässig.

languageCode

string

Die Sprache der Anzeige. Diese Option ist nicht zu verwechseln mit den Sprachkenntnissen, die für den Job gefordert werden.

Sprachcodes müssen im BCP-47-Format angegeben werden, z. B. "en-US" oder "sr-Latn". Weitere Informationen finden Sie unter Tags zur Identifizierung von Sprachen{: class="external" target="_blank" } (nur auf Englisch verfügbar).

Wenn dieses Feld nicht angegeben und Job.description vorhanden ist, wird der auf Job.description basierende erkannte Sprachcode zugewiesen. Andernfalls wird standardmäßig „en_US“ verwendet.

jobLevel

enum (JobLevel)

Die für diesen Job erwartete Erfahrungsstufe, z. B. "Berufsanfänger".

promotionValue

integer

Ein Promotionswert des Jobs, der vom Kunden festgelegt wird. Der Wert bestimmt die Sortierreihenfolge der Jobs, die zurückgegeben werden, wenn nach hervorgehobenen Jobs gesucht wird. Dabei werden zuerst die Jobs mit höheren Suchergebniswerten zurückgegeben; bei Gleichheit werden die Ergebnisse in der Reihenfolge ihrer Relevanz sortiert. Nur die Jobs mit einem promotionValue > 0 werden bei einer FEATURED_JOB_SEARCH zurückgegeben.

Der Standardwert ist 0. Negative Werte werden als 0 behandelt.

qualifications

string

Eine Beschreibung der Qualifikationen, die für diesen Job erforderlich sind. Es empfiehlt sich, dieses Feld anstelle des allgemeineren Felds description zu verwenden.

In diesem Feld werden HTML-Eingaben akzeptiert und bereinigt. Markup-Tags wie Fett- und Kursivformatierung sowie sortierte und unsortierte Listen werden unterstützt.

Es sind maximal 10.000 Zeichen zulässig.

responsibilities

string

Eine Beschreibung der Aufgaben in diesem Job. Es empfiehlt sich, dieses Feld anstelle des allgemeineren Felds description zu verwenden.

In diesem Feld werden HTML-Eingaben akzeptiert und bereinigt. Markup-Tags wie Fett- und Kursivformatierung sowie sortierte und unsortierte Listen werden unterstützt.

Es sind maximal 10.000 Zeichen zulässig.

postingRegion

enum (PostingRegion)

Die Job-PostingRegion (z. B. Bundesland, Land), in der der Job verfügbar ist. Wenn dieses Feld festgelegt wurde, kann ein LocationFilter in einer Suchanfrage innerhalb der Jobregion diese Jobanzeige finden, sofern keine genaue Standortübereinstimmung angegeben wurde. Wenn dieses Feld auf PostingRegion.NATION oder PostingRegion.ADMINISTRATIVE_AREA gesetzt ist, wird dringend empfohlen, für den Job Job.addresses dieselbe Standortebene wie für dieses Feld festzulegen.

visibility
(deprecated)

enum (Visibility)

Eingestellt. Der Job ist nur für den Inhaber sichtbar.

Die Sichtbarkeit des Jobs.

Wenn keine Angabe erfolgt, wird standardmäßig Visibility.ACCOUNT_ONLY verwendet.

jobStartTime

string (Timestamp format)

Der Startzeitstempel des Jobs in der UTC-Zeitzone. In der Regel wird dieses Feld für Jobs auf Vertragsbasis verwendet. Ungültige Zeitstempel werden ignoriert.

jobEndTime

string (Timestamp format)

Der Endzeitstempel des Jobs. In der Regel wird dieses Feld für Jobs auf Vertragsbasis verwendet. Ungültige Zeitstempel werden ignoriert.

postingPublishTime

string (Timestamp format)

Der Zeitstempel, zu dem dieses Stellenangebot zuletzt veröffentlicht wurde. Der Standardwert ist die Uhrzeit, zu der die Anfrage beim Server eingeht. Ungültige Zeitstempel werden ignoriert.

postingExpireTime

string (Timestamp format)

Dringend empfohlen für eine optimale Servicequalität.

Der Ablaufzeitstempel des Jobs. Nach diesem Zeitstempel wird der Job als abgelaufen markiert und in den Suchergebnissen nicht mehr angezeigt. Der abgelaufene Job kann nicht von der jobs.list API aufgelistet werden, er kann aber mit der jobs.get API abgerufen, mit der jobs.patch API aktualisiert oder mit der jobs.delete API gelöscht werden. Ein abgelaufener Job kann mithilfe eines zukünftigen Ablaufzeitstempels aktualisiert und wieder geöffnet werden. Das Aktualisieren eines abgelaufenen Jobs schlägt fehl, wenn bereits ein anderer offener Job mit denselben company, languageCode und requisitionId vorhanden ist.

Die abgelaufenen Jobs werden 90 Tage in unserem System aufbewahrt. Die Gesamtzahl der abgelaufenen Jobs darf jedoch das Dreifache der maximalen Anzahl offener Jobs in den letzten 7 Tagen nicht überschreiten. Wenn dieser Grenzwert überschritten wird, werden abgelaufene Jobs in der Reihenfolge ihrer frühesten Ablaufzeit bereinigt. Abgelaufene Jobs können nicht mehr aufgerufen werden, nachdem sie bereinigt wurden.

Ungültige Zeitstempel werden ignoriert und als nicht angegebene Ablaufzeit behandelt.

Wenn der Zeitstempel vor der sofortigen Anfrage liegt, wird der Job sofort nach der Erstellung als abgelaufen behandelt. Diese Art von Job kann nicht aktualisiert werden. Und wenn Sie einen Job mit einem Zeitstempel in der Vergangenheit erstellen, muss postingPublishTime vor postingExpireTime festgelegt werden. Mit dieser Funktion können andere Objekte wie Application auf einen Job verweisen, der vor dem Ablauf noch nicht im System vorhanden war. Wenn Sie einen Job ändern möchten, der beim Erstellen abgelaufen ist, löschen Sie ihn und erstellen Sie einen neuen.

Wenn dieser Wert zum Zeitpunkt der Joberstellung nicht angegeben wird oder ungültig ist, läuft die Jobanzeige 30 Tage nach dem Zeitpunkt der Erstellung des Jobs ab. Wenn der Job beispielsweise am 1.1.2017 um 13:00 Uhr UTC ohne Ablaufdatum erstellt wurde, läuft der Job am 31.1.2017 um 13:00 Uhr UTC ab.

Wenn dieser Wert bei der Jobaktualisierung nicht angegeben wird, sind die durch UpdateJobRequest.update_mask festgelegten Feldmasken wichtig. Wenn die Feldmasken jobEndTime enthalten oder leer sind (d. h. jedes Feld aktualisiert wird), läuft die Jobanzeige 30 Tage nach der letzten Aktualisierung des Jobs ab. Ansonsten wird das Ablaufdatum nicht aktualisiert.

postingCreateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem dieser Job erstellt wurde.

postingUpdateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem dieser Job zuletzt aktualisiert wurde.

companyDisplayName

string

Nur Ausgabe. Der Anzeigename des Unternehmens, das den Job anbietet.

derivedInfo

object (DerivedInfo)

Nur Ausgabe. Abgeleitete Details zur Stellenausschreibung.

processingOptions

object (ProcessingOptions)

Optionen für die Jobverarbeitung.

Methoden

batchCreate

Beginnt mit der Ausführung eines Batch-Vorgangs zum Erstellen von Jobs.

batchDelete

Löscht eine Liste von Job-Werten nach Filter.

batchUpdate

Beginnt mit der Ausführung eines Batch-Aktualisierungsjobs.

create

Erstellt einen neuen Job.

delete

Löscht den angegebenen Job.

get

Ruft den angegebenen Job ab, dessen Status OFFEN oder innerhalb der letzten 90 Tage ABGELAUFEN ist.

list

Listet Jobs nach Filter auf.

patch

Aktualisiert den angegebenen Job.
Sucht mit dem angegebenen SearchJobsRequest nach Jobs.

searchForAlert

Sucht mit dem angegebenen SearchJobsRequest nach Jobs.