Method: projects.jobs.patch

Memperbarui tugas yang ditentukan.

Biasanya, konten yang diperbarui akan terlihat di hasil penelusuran dalam waktu 10 detik, tetapi mungkin juga memerlukan waktu hingga 5 menit.

Permintaan HTTP

PATCH https://jobs.googleapis.com/v4beta1/{job.name=projects/*/jobs/*}

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
job.name

string

Diperlukan selama info terbaru tugas.

Nama resource untuk tugas. ID ini dihasilkan oleh layanan saat tugas dibuat.

Formatnya adalah "projects/{projectId}/tenants/{tenantId}/jobs/{job_id}". Misalnya, "projects/foo/tenants/bar/jobs/baz".

Jika ID tenant tidak ditentukan, tenant default akan digunakan. Misalnya, "projects/foo/jobs/bar".

Penggunaan kolom ini dalam kueri tugas dan panggilan API lebih diprioritaskan daripada penggunaan requisitionId karena nilai ini unik.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "job": {
    "name": string,
    "company": string,
    "requisitionId": string,
    "title": string,
    "description": string,
    "addresses": [
      string
    ],
    "applicationInfo": {
      "emails": [
        string
      ],
      "instruction": string,
      "uris": [
        string
      ]
    },
    "jobBenefits": [
      enum (JobBenefit)
    ],
    "compensationInfo": {
      "entries": [
        {
          object (CompensationEntry)
        }
      ],
      "annualizedBaseCompensationRange": {
        object (CompensationRange)
      },
      "annualizedTotalCompensationRange": {
        object (CompensationRange)
      }
    },
    "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": {
      "seconds": string,
      "nanos": integer
    },
    "jobEndTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingPublishTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingExpireTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingCreateTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingUpdateTime": {
      "seconds": string,
      "nanos": integer
    },
    "companyDisplayName": string,
    "derivedInfo": {
      "locations": [
        {
          object (Location)
        }
      ],
      "jobCategories": [
        enum (JobCategory)
      ]
    },
    "processingOptions": {
      "disableStreetAddressResolution": boolean,
      "htmlSanitization": enum (HtmlSanitization)
    }
  },
  "updateMask": string
}
Kolom
job.company

string

Wajib. Nama resource perusahaan yang mencantumkan lowongan.

Formatnya adalah "projects/{projectId}/tenants/{tenantId}/manufacturers/{company_id}". Misalnya, "projects/foo/tenants/bar/company/baz".

Jika ID tenant tidak ditentukan, tenant default akan digunakan. Misalnya, "projects/foo/company/bar".
job.requisitionId

string

Wajib. ID permintaan, juga disebut sebagai ID postingan, ditetapkan oleh klien untuk mengidentifikasi pekerjaan. Bidang ini ditujukan untuk digunakan klien untuk identifikasi klien dan pelacakan posting. Tugas tidak diizinkan untuk dibuat jika ada tugas lain dengan company, languageCode, dan requisitionId yang sama.

Jumlah karakter maksimal yang diizinkan adalah 255.
job.title

string

Wajib. Nama pekerjaan, seperti "Software Engineer"

Jumlah karakter maksimal yang diizinkan adalah 500.
job.description

string

Wajib. Deskripsi pekerjaan, yang biasanya menyertakan deskripsi perusahaan dalam beberapa paragraf dan informasi terkait. Kolom terpisah disediakan pada objek tugas untuk responsibilities, qualifications, dan karakteristik tugas lainnya. Sebaiknya gunakan kolom pekerjaan yang terpisah ini.

Bidang ini menerima dan membersihkan input HTML, dan juga menerima tag markup daftar yang dicetak tebal, miring, dan diurutkan, serta yang tidak diurutkan.

Jumlah karakter maksimum yang diizinkan adalah 100.000.
job.addresses[]

string

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Lokasi tempat pemberi kerja ingin merekrut untuk postingan lowongan ini.

Menentukan alamat lengkap lokasi perekrutan memungkinkan hasil API yang lebih baik, terutama penelusuran lowongan menurut waktu perjalanan.

Maksimal 50 lokasi diizinkan untuk performa penelusuran terbaik. Jika lowongan memiliki lebih banyak lokasi, sebaiknya bagi menjadi beberapa tugas dengan requisitionId unik (misalnya 'ReqA' menjadi 'ReqA-1', 'ReqA-2', dan seterusnya.) karena beberapa tugas dengan company, languageCode, dan requisitionId yang sama tidak diizinkan. Jika requisitionId asli harus dipertahankan, kolom kustom harus digunakan untuk penyimpanan. Sebaiknya kelompokkan lokasi yang berdekatan satu sama lain dalam pekerjaan yang sama untuk pengalaman penelusuran yang lebih baik.

Jumlah karakter maksimal yang diizinkan adalah 500.
job.applicationInfo

object (ApplicationInfo)

Informasi lamaran pekerjaan.
job.jobBenefits[]

enum (JobBenefit)

Manfaat yang disertakan dengan pekerjaan.
job.compensationInfo

object (CompensationInfo)

Informasi kompensasi pekerjaan (alias "tarif gaji") yaitu, kompensasi yang akan dibayarkan kepada karyawan.
job.customAttributes

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

Peta kolom untuk menyimpan atribut tugas kustom yang dapat difilter dan tidak dapat difilter yang tidak tercakup oleh kolom terstruktur yang disediakan.

Kunci peta berupa string maksimal 64 byte dan harus cocok dengan pola: [a-zA-Z][a-zA-Z0-9_]*. Misalnya, key0LikeThis atau KEY_1_LIKE_THIS.

Mendukung maksimal 100 kunci yang dapat difilter dan 100 kunci yang tidak dapat difilter. Untuk stringValues yang dapat difilter, di semua kunci maksimal 200 nilai diizinkan, dengan setiap string tidak lebih dari 255 karakter. Untuk stringValues yang tidak dapat difilter, ukuran total maksimum stringValues di semua kunci adalah 50 KB.
job.degreeTypes[]

enum (DegreeType)

Gelar pendidikan yang diinginkan untuk pekerjaan ini, seperti Sarjana, Master.
job.department

string

Departemen atau area fungsional dalam perusahaan dengan posisi yang lowong.

Jumlah karakter maksimal yang diizinkan adalah 255.
job.employmentTypes[]

enum (EmploymentType)

Jenis pekerjaan dari suatu pekerjaan, misalnya, full time atau part time.
job.incentives

string

Deskripsi bonus, komisi, dan insentif kompensasi lainnya yang terkait dengan pekerjaan, tidak termasuk gaji atau gaji.

Jumlah karakter maksimum yang diizinkan adalah 10.000.
job.languageCode

string

Bahasa postingan. Bidang ini berbeda dari persyaratan kefasihan apa pun yang terkait dengan pekerjaan.

Kode bahasa harus dalam format BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi lebih lanjut, lihat Tag untuk Mengidentifikasi Bahasa{: class="external" target="_blank" }.

Jika kolom ini tidak ditentukan dan Job.description ada, kode bahasa yang terdeteksi berdasarkan Job.description akan ditetapkan. Jika tidak, setelan defaultnya adalah 'en_US'.
job.jobLevel

enum (JobLevel)

Tingkat pengalaman yang terkait dengan pekerjaan, seperti "Tingkat Pemula".
job.promotionValue

integer

Nilai promosi pekerjaan, seperti yang ditentukan oleh klien. Nilai menentukan urutan sortir pekerjaan yang dikembalikan ketika mencari pekerjaan menggunakan panggilan penelusuran pekerjaan unggulan, dengan nilai promosi yang lebih tinggi dikembalikan terlebih dahulu dan hubungan diselesaikan berdasarkan urutan relevansi. Hanya tugas dengan promotionValue >0 yang ditampilkan dalam FEATURED_Job_SEARCH.

Nilai defaultnya adalah 0, dan nilai negatif diperlakukan sebagai 0.
job.qualifications

string

Deskripsi kualifikasi yang diperlukan untuk melakukan pekerjaan. Penggunaan kolom ini direkomendasikan sebagai alternatif penggunaan kolom description yang lebih umum.

Bidang ini menerima dan membersihkan input HTML, dan juga menerima tag markup daftar yang dicetak tebal, miring, dan diurutkan, serta yang tidak diurutkan.

Jumlah karakter maksimum yang diizinkan adalah 10.000.
job.responsibilities

string

Deskripsi tanggung jawab pekerjaan. Penggunaan kolom ini direkomendasikan sebagai alternatif penggunaan kolom description yang lebih umum.

Bidang ini menerima dan membersihkan input HTML, dan juga menerima tag markup daftar yang dicetak tebal, miring, dan diurutkan, serta yang tidak diurutkan.

Jumlah karakter maksimum yang diizinkan adalah 10.000.
job.postingRegion

enum (PostingRegion)

Lowongan PostingRegion (misalnya, negara bagian, negara) tempat lowongan tersedia. Jika kolom ini ditetapkan, LocationFilter di kueri penelusuran dalam wilayah lowongan menemukan postingan lowongan ini jika lokasi persisnya tidak ditentukan. Jika kolom ini disetel ke PostingRegion.NATION atau PostingRegion.ADMINISTRATIVE_AREA, sebaiknya setel tugas Job.addresses ke tingkat lokasi yang sama dengan kolom ini.
job.visibility
(deprecated)

enum (Visibility)

Tidak digunakan lagi. Pekerjaan hanya dapat dilihat oleh pemilik.

Visibilitas pekerjaan.

Jika tidak ditentukan, defaultnya adalah Visibility.ACCOUNT_ONLY.
job.jobStartTime

string (Timestamp format)

Stempel waktu mulai tugas dalam zona waktu UTC. Biasanya kolom ini digunakan untuk engagement kontrak. Stempel waktu yang tidak valid akan diabaikan.
job.jobEndTime

string (Timestamp format)

Stempel waktu akhir tugas. Biasanya kolom ini digunakan untuk engagement kontrak. Stempel waktu yang tidak valid akan diabaikan.
job.postingPublishTime

string (Timestamp format)

Stempel waktu postingan lowongan ini terakhir kali dipublikasikan. Nilai defaultnya adalah waktu permintaan tiba di server. Stempel waktu yang tidak valid akan diabaikan.
job.postingExpireTime

string (Timestamp format)

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Stempel waktu masa berlaku tugas. Setelah stempel waktu ini, tugas ditandai sebagai habis masa berlakunya, dan tidak lagi muncul di hasil penelusuran. Tugas yang sudah berakhir tidak dapat dicantumkan oleh jobs.list API, tetapi dapat diambil dengan jobs.get API atau diperbarui dengan jobs.patch API atau dihapus dengan jobs.delete API. Tugas yang sudah tidak berlaku dapat diperbarui dan dibuka kembali menggunakan stempel waktu habis masa berlaku di masa mendatang. Memperbarui tugas yang sudah habis masa berlakunya akan gagal jika ada tugas lain yang terbuka dengan company, languageCode, dan requisitionId yang sama.

Lowongan yang kedaluwarsa dipertahankan dalam sistem kami selama 90 hari. Namun, jumlah tugas yang habis masa berlakunya secara keseluruhan tidak boleh melebihi 3 kali lipat jumlah maksimum lowongan yang terbuka selama 7 hari sebelumnya. Jika batas ini terlampaui, tugas yang habis masa berlakunya akan dibersihkan sesuai dengan waktu habis masa berlakunya. Lowongan yang sudah kedaluwarsa tidak dapat diakses lagi setelah dihapus.

Stempel waktu yang tidak valid akan diabaikan, dan dianggap sebagai waktu habis masa berlaku tidak diberikan.

Jika stempel waktu sebelum permintaan instan dibuat, tugas akan langsung dianggap berakhir masa berlakunya pada saat pembuatan. Pekerjaan semacam ini tidak dapat diperbarui. Dan saat membuat tugas dengan stempel waktu yang lalu, postingPublishTime harus ditetapkan sebelum postingExpireTime. Tujuan dari fitur ini adalah memungkinkan objek lain, seperti Application, untuk merujuk tugas yang tidak ada dalam sistem sebelum berakhir. Jika Anda ingin mengubah tugas yang telah habis masa berlakunya saat dibuat, hapus dan buat tugas baru.

Jika nilai ini tidak diberikan pada saat pembuatan lowongan atau tidak valid, postingan lowongan akan berakhir setelah 30 hari sejak waktu pembuatan pekerjaan. Misalnya, jika lowongan dibuat pada 01/01/2017 13.00 UTC dengan tanggal habis masa berlaku yang tidak ditentukan, lowongan tersebut akan berakhir setelah 31/01/2017 pukul 13.00 UTC.

Jika tidak diberikan saat pembaruan tugas, nilai ini bergantung pada mask kolom yang ditetapkan oleh UpdateJobRequest.update_mask. Jika mask kolom menyertakan jobEndTime, atau mask kosong yang berarti bahwa setiap kolom diperbarui, postingan lowongan akan berakhir setelah 30 hari sejak waktu pembaruan terakhir lowongan. Jika tidak, tanggal habis masa berlaku tidak akan diperbarui.
job.postingCreateTime

string (Timestamp format)

Hanya output. Stempel waktu saat postingan lowongan ini dibuat.
job.postingUpdateTime

string (Timestamp format)

Hanya output. Stempel waktu saat postingan lowongan ini terakhir diperbarui.
job.companyDisplayName

string

Hanya output. Nama tampilan perusahaan yang mencantumkan lowongan.
job.derivedInfo

object (DerivedInfo)

Hanya output. Memperoleh detail tentang postingan lowongan.
job.processingOptions

object (ProcessingOptions)

Opsi untuk pemrosesan tugas.
updateMask

string (FieldMask format)

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Jika updateMask diberikan, hanya kolom yang ditentukan di job yang akan diperbarui. Jika tidak, semua kolom akan diperbarui.

Mask kolom untuk membatasi kolom yang diperbarui. Hanya kolom tingkat atas Job yang didukung.

Daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya valid. Contoh: "user.displayName,photo".

Isi respons

Jika berhasil, isi respons akan berisi instance Job.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.