Resource Job mewakili satu postingan lowongan (juga disebut sebagai "listingan lowongan" atau "permintaan lowongan"). Tugas termasuk dalam resource Perusahaan yang merepresentasikan entitas perekrutan yang bertanggung jawab atas tugas tersebut.
Anda dapat mengakses tugas menggunakan metode LIST dan GET serta memanipulasinya menggunakan metode CREATE, UPDATE, dan DELETE. Mungkin diperlukan waktu beberapa menit agar indeks Cloud Talent Solution mencerminkan perubahan.
Pekerjaan berada dalam cakupan akun layanan. Hanya permintaan penelusuran yang diautentikasi menggunakan kredensial akun layanan tertentu yang dapat digunakan untuk mengakses konten tugas ini.
Untuk memudahkan pemecahan masalah dan penyeleksian, sinkronkan indeks pekerjaan Cloud Talent Solution dengan indeks pekerjaan Anda sendiri, dan pertahankan hubungan antara name
yang dihasilkan oleh Cloud Talent Solution dan ID pekerjaan unik dalam sistem Anda. Saat tugas berubah atau diperkenalkan ke dalam sistem Anda, panggilan CRUD yang sesuai harus dikirim ke CTS secara real time untuk memastikan perubahan ini langsung tercermin. Indeks CTS harus ditambahkan ke pipeline penyerapan tugas yang ada.
Buat tugas
Anda dapat membuat Job menggunakan contoh kode di bawah. Lihat Panduan memulai: Membuat perusahaan dan lowongan untuk mengetahui detail selengkapnya. Tutorial video dan codelab interaktif juga tersedia.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Kolom wajib diisi
Kolom berikut wajib diisi selama pembuatan dan pembaruan Job:
companyName
: Nama resource perusahaan yang memiliki tugas, seperticompanyName=\"projects/{ProjectId}/companies/{CompanyId}\"
.requisitionId
: ID permintaan, yang juga disebut sebagai ID postingan, adalah nilai yang Anda tetapkan untuk mengidentifikasi tugas. Anda dapat menggunakan kolom ini untuk identifikasi klien dan pelacakan permintaan. Jumlah karakter maksimum yang diizinkan adalah 225.Keunikan lowongan pekerjaan ditentukan menggunakan kombinasi
requisitionID
,companyName
, dan lokasi. Jika tugas dibuat dengan kunci tertentu dari atribut ini, kunci ini disimpan dalam indeks Cloud Talent Solution dan tidak ada tugas lain dengan kolom yang sama ini yang dapat dibuat hingga tugas tersebut dihapus.title
: Judul pekerjaan, misalnya "Software Engineer". Jumlah maksimum karakter yang diizinkan adalah 500.Untuk memperbaiki masalah hasil penelusuran yang terlewat karena judul lowongan yang tidak standar, Cloud Talent Solution memanfaatkan semua kolom lowongan untuk memahami konteks lowongan dan menyimpan judul lowongan yang "bersih" secara internal. Saat permintaan penelusuran dikirim ke layanan, kueri penelusuran juga dibersihkan, dan ontologi digunakan untuk memetakan kueri yang dibersihkan ke tugas pembersihan yang relevan.
description
: Deskripsi lowongan, yang biasanya mencakup deskripsi multi-paragraf tentang perusahaan dan informasi terkait. Kolom terpisah disediakan di objek Job untuk tanggung jawab, kualifikasi, dan karakteristik pekerjaan lainnya. Sebaiknya gunakan kolom terpisah ini.Kolom ini menerima dan membersihkan input HTML, serta menerima tag markup tebal, miring, daftar berurutan, dan daftar tidak berurutan. Jumlah karakter maksimum yang diizinkan adalah 100.000.
Salah satu dari berikut ini:
applicationInfo.uris
: URL halaman aplikasi.applicationInfo.emails
: Alamat email yang akan menerima resume atau lamaran.applicationInfo.instruction
: Petunjuk pengajuan, seperti "Kirimkan permohonan Anda ke ...". Kolom ini menerima dan membersihkan input HTML, serta menerima tag markup tebal, miring, daftar berurutan, dan daftar tidak berurutan. Jumlah maksimum karakter yang diizinkan adalah 3.000.
Kolom yang biasa digunakan
postingExpireTime
: Waktu, berdasarkan stempel waktu, saat postingan lowongan berakhir. Setelah waktu ini tiba, tugas akan ditandai sebagai berakhir dan tidak akan muncul di hasil penelusuran. Tanggal ini harus sebelum 31/12/2100 dalam zona waktu UTC. Tanggal yang tidak valid (seperti tanggal lampau) akan diabaikan. Tanggal default saat tugas berakhir adalah 30 hari setelah waktu pembuatan tugas dalam zona waktu UTC.Konten tugas yang sudah berakhir masih dapat diambil hingga 90 hari setelah tugas berakhir menggunakan operator GET. Setelah batas waktu 90 hari ini, tugas tidak akan ditampilkan melalui operasi GET.
addresses
: Lokasi tugas. Sebaiknya berikan alamat lengkap lokasi perekrutan untuk mengaktifkan hasil Penelusuran Lowongan yang lebih baik, termasuk penelusuran menurut waktu perjalanan. Jumlah karakter maksimum yang diizinkan adalah 500. Informasi selengkapnya tentangaddresses
tersedia di bagian Praktik terbaik di bawah.promotionValue
: Nilai yang lebih besar dari 0 menentukan tugas ini sebagai "tugas unggulan", yang hanya ditampilkan dalam penelusuran jenisFEATURED_JOBS
. Nilai yang lebih tinggi ditampilkan lebih tinggi di hasil penelusuran unggulan. Lihat Lowongan Unggulan untuk mengetahui informasi selengkapnya.
Menggunakan kolom tugas kustom
Cloud Talent Solution mencakup beberapa kolom pekerjaan yang sudah ada di skema API-nya. Namun, Anda mungkin memerlukan kolom tambahan yang tidak ada dalam opsi siap pakai. Meskipun sebaiknya Anda menggunakan kolom bawaan jika memungkinkan, Cloud Talent Solution juga menyediakan beberapa kolom customAttributes
untuk pekerjaan. Kolom ini dapat difilter atau tidak dapat difilter. Lihat dokumentasi customAttributes
untuk mengetahui informasi selengkapnya.
customAttributes
: Kolom ini menyimpan hingga 100 atribut kustom yang digunakan untuk menyimpan data kustom tentang tugas. Kolom ini dapat difilter menggunakan permintaan penelusuran yang menentukan kolomjobQuery
. Selain itu, salah satu kolom ini dapat ditetapkan di atributkeywordSearchableJobCustomAttributes
daricompany
, sehingga istilah penelusuran yang memiliki kecocokan persis di salah satu kolom dikeywordSearchableJobCustomAttributes
akan menampilkan semua Lowongan yang menyertakan kecocokan tersebut.
Contoh kode berikut menunjukkan cara membuat tugas dengan customAttribute
:
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mengambil tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat daftar tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menghapus tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat CTS client libraries. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python CTS.
Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Praktik terbaik
Kolom lokasi
Jika memungkinkan, sebaiknya berikan alamat jalan pekerjaan di kolom
addresses
. Hal ini membantu deteksi dan relevansi lokasi. Jika alamat tingkat jalan tidak tersedia, masukkan informasi sebanyak mungkin.
Alamat didukung hingga tingkat negara. Penetapan wilayah (seperti
"Pacific Northwest") tidak didukung.
Cloud Talent Solution menggunakan data di kolom addresses
untuk mengisi
kolom derivedInfo.locations
(khusus output). Jika alamat lengkap tidak diberikan, layanan menggunakan sinyal lain, seperti nama perusahaan, untuk menentukan apakah alamat yang lebih lengkap dapat disimpulkan untuk postingan lowongan kerja.
Misalnya, jika lokasi posisi software ditentukan sebagai Mountain View
,
dan perusahaan yang terkait dengan pekerjaan tersebut adalah Google
, layanan
akan mencari objek company
untuk melihat apakah ada alamat jalan yang lebih baik
yang diberikan di kolom headquartersAddress
dan apakah alamat jalan tersebut berada di kota yang sama
dengan postingan pekerjaan. Jika demikian, layanan memahami bahwa tugas "kemungkinan"
berada di alamat jalan tersebut dan mengisi kolom derivedInfo.locations
dengan tepat.
Jika data alamat perusahaan tidak tersedia, layanan ini menggunakan kombinasi pengetahuan eksklusif dan informasi pekerjaan/perusahaan untuk mengisi kolom derivedInfo.locations
.
Karena nilai derivedInfo.locations
adalah upaya perkiraan terbaik, Anda dapat menggunakan data derivedInfo.locations
atau kolom addresses
saat menampilkan alamat tugas.
Postingan lowongan dapat memiliki maksimal 50 lokasi yang terkait dengannya. Jika lowongan memiliki lebih banyak lokasi, Anda dapat membagi lowongan menjadi beberapa lowongan, masing-masing dengan requisitionId unik (misalnya, 'ReqA', 'ReqA-1', 'ReqA-2', dan sebagainya). Tidak boleh ada beberapa
tugas dengan requisitionId
, , companyName
, dan languageCode
yang sama. Jika requisitionId
asli harus dipertahankan, CustomAttribute
harus digunakan untuk penyimpanan. Sebaiknya kelompokkan lokasi yang paling berdekatan dalam tugas yang sama untuk pengalaman penelusuran yang lebih baik.
Alamat yang didukung
Alamat apa pun yang dikenali oleh Google Maps Geocoding API (di kolom
formattedAddress
) diterima oleh Cloud Talent Solution. Layanan
akan menampilkan error 400 jika Anda mencoba membuat Tugas atau menjalankan penelusuran
menggunakan alamat yang tidak dikenali.
Jika alamat bisnis tercantum dengan salah di Google Maps Geocoding API, ajukan bug agar alamat tersebut diperbaiki. Koreksi mungkin memerlukan waktu hingga 5 hari untuk diterapkan.
Pelengkapan otomatis alamat
Cloud Talent Solution tidak memberikan saran pelengkapan otomatis untuk lokasi. Gunakan Google Maps Places API, atau layanan lokasi serupa lainnya, untuk mengisi saran pelengkapan otomatis.
Lowongan kerja di seluruh negara bagian, di seluruh negara, dan telecommuting
Pekerjaan dapat ditentukan sebagai pekerjaan di seluruh negara bagian, di seluruh negara, atau telekomunikasi dengan menggunakan kolom
postingRegion
.
Lowongan
ADMINISTRATIVE_AREA
danNATION
ditampilkan untuk penelusuran apa pun dengan lokasi yang ditentukan di dalam negara bagian/negara postingan lowongan. Misalnya, jika tugasADMINISTRATIVE_AREA
memiliki lokasi "WA, USA", tugas tersebut akan ditampilkan untuk penelusuran denganLocationFilter
yang menentukan "Seattle".TELECOMMUTE
Lowongan ditampilkan dalam penelusuran terkait lokasi apa pun, tetapi dianggap kurang relevan. Objek ini dapat ditargetkan dalam penelusuran dengan menyetel flagtelecommutePreference
keTELECOMMUTE_ALLOWED
dalamLocationFilter
penelusuran.