Resource Lowongan mewakili satu postingan lowongan (juga disebut sebagai "listingan pekerjaan" atau "permintaan pekerjaan"). Pekerjaan merupakan milik sumber daya Perusahaan yang mewakili entitas perekrutan yang bertanggung jawab atas pekerjaan tersebut.
Anda dapat mengakses tugas menggunakan metode LIST dan GET, serta memanipulasinya menggunakan metode CREATE, UPDATE, dan DELETE. Diperlukan waktu beberapa menit agar indeks Cloud Talent Solution mencerminkan perubahan.
Tugas dimuat dalam cakupan akun layanan. Hanya permintaan penelusuran yang diautentikasi menggunakan kredensial akun layanan tertentu yang dapat digunakan untuk mengakses konten tugas tersebut.
Untuk memudahkan pemecahan masalah dan triase, sinkronkan indeks tugas Cloud Talent Solution dengan indeks tugas Anda sendiri, serta jaga hubungan antara name
yang dihasilkan oleh Cloud Talent Solution dengan ID tugas unik di sistem Anda. Saat
pekerjaan berubah atau diperkenalkan ke dalam sistem Anda, panggilan CRUD yang sesuai harus
dikirim ke CTS secara real time untuk memastikan bahwa perubahan ini
segera ditampilkan. Indeks CTS harus ditambahkan ke
pipeline penyerapan tugas yang ada.
Membuat tugas
Anda dapat membuat Tugas menggunakan contoh kode di bawah ini. 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 library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Go.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Java.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Node.js.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Python.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Kolom wajib diisi
Kolom berikut diperlukan selama pembuatan dan pembaruan Lowongan:
companyName
: Nama resource perusahaan yang memiliki tugas, seperticompanyName=\"projects/{ProjectId}/companies/{CompanyId}\"
.requisitionId
: ID permintaan, juga disebut sebagai ID postingan, adalah nilai yang Anda tetapkan untuk mengidentifikasi lowongan. Anda dapat menggunakan kolom ini untuk identifikasi klien dan pelacakan permintaan. Jumlah karakter maksimum yang diizinkan adalah 225.Keunikan postingan lowongan ditentukan menggunakan kombinasi
requisitionID
,companyName
, dan lokasi. Jika tugas dibuat dengan kunci tertentu dari atribut ini, kunci tersebut akan disimpan dalam indeks Cloud Talent Solution dan tugas lain dengan kolom yang sama ini tidak dapat dibuat hingga tugas tersebut dihapus.title
: Jabatan, misalnya "Software Engineer". Jumlah karakter maksimum yang diizinkan adalah 500.Untuk mengatasi masalah hasil penelusuran yang terlewat karena jabatan yang tidak standar, Cloud Talent Solution memanfaatkan semua kolom lowongan untuk memahami konteks pekerjaan dan menyimpan jabatan yang "bersih" secara internal. Saat permintaan penelusuran dikirim ke layanan, kueri penelusuran juga akan dibersihkan, dan ontologi akan digunakan untuk memetakan kueri yang sudah dibersihkan ke tugas bersih yang relevan.
description
: Deskripsi pekerjaan, yang biasanya mencakup deskripsi perusahaan dalam beberapa paragraf dan informasi terkait. Kolom terpisah disediakan pada objek Lowongan untuk tanggung jawab, kualifikasi, dan karakteristik pekerjaan lainnya. Sebaiknya gunakan kolom terpisah ini.Kolom ini menerima dan membersihkan input HTML, serta menerima tag markup daftar yang dicetak tebal, miring, dan tidak diurutkan. Jumlah karakter maksimum yang diizinkan adalah 100.000.
Salah satu dari berikut ini:
applicationInfo.uris
: URL halaman aplikasi.applicationInfo.emails
: Alamat email tujuan pengiriman resume atau lamaran.applicationInfo.instruction
: Petunjuk aplikasi, seperti "Kirimkan aplikasi Anda ke ...". Kolom ini menerima dan membersihkan input HTML, serta menerima tag markup daftar yang dicetak tebal, miring, diurutkan, dan tidak diurutkan. Jumlah karakter maksimum yang diizinkan adalah 3.000.
Kolom yang biasa digunakan
postingExpireTime
: Waktu, berdasarkan stempel waktu, saat masa berlaku postingan lowongan berakhir. Setelah itu terjadi, tugas akan ditandai sebagai sudah tidak berlaku dan tidak akan muncul di hasil penelusuran. Tanggal ini harus sebelum 2100/12/31 dalam zona waktu UTC. Tanggal yang tidak valid (misalnya tanggal yang sudah lewat) akan diabaikan. Tanggal default saat tugas berakhir adalah 30 hari setelah waktu pembuatan tugas dalam zona waktu UTC.Konten lowongan yang sudah ditutup masih dapat diambil hingga 90 hari setelah tugas berakhir menggunakan operator GET. Setelah batas waktu 90 hari ini, tugas tidak akan dikembalikan melalui operasi GET.
addresses
: Lokasi pekerjaan. Sebaiknya berikan alamat lengkap lokasi perekrutan untuk memungkinkan hasil Penelusuran Lowongan yang lebih baik, termasuk penelusuran berdasarkan waktu perjalanan. Jumlah maksimum karakter yang diizinkan adalah 500. Informasi selengkapnya tentangaddresses
tersedia di bagian Praktik terbaik di bawah.promotionValue
: Nilai yang lebih besar dari 0 menentukan pekerjaan ini sebagai "tugas unggulan", yang hanya ditampilkan dalam penelusuran jenisFEATURED_JOBS
. Nilai yang lebih tinggi ditampilkan lebih tinggi dalam hasil penelusuran unggulan. Lihat Tugas Unggulan untuk informasi selengkapnya.
Menggunakan kolom pekerjaan kustom
Cloud Talent Solution mencakup beberapa kolom tugas yang terintegrasi dalam
skema API-nya. Namun, Anda mungkin memerlukan kolom tambahan yang tidak ada di opsi siap pakai. Meskipun kami merekomendasikan agar Anda menggunakan kolom siap pakai jika memungkinkan, Cloud Talent Solution juga menyediakan beberapa kolom customAttributes
untuk sebuah tugas. Filter dapat berupa filter atau tidak dapat difilter. Lihat
dokumentasi customAttributes
untuk informasi selengkapnya.
customAttributes
: Kolom ini menyimpan hingga 100 atribut khusus 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 dalam atributkeywordSearchableJobCustomAttributes
daricompany
, sehingga istilah penelusuran yang memiliki kecocokan persis di salah satu kolom padakeywordSearchableJobCustomAttributes
akan menampilkan Pekerjaan apa pun 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 library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Go.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Java.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Node.js.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Python.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mengambil tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Go.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Java.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Node.js.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Python.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat daftar tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Go.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Java.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Node.js.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Python.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menghapus tugas
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Go.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Java.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Node.js.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat library klien CTS. Untuk informasi selengkapnya, lihat dokumentasi referensi API CTS Python.
Untuk mengautentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Praktik terbaik
Kolom lokasi
Jika memungkinkan, sebaiknya berikan alamat lowongan di
kolom addresses
. Hal ini membantu mendeteksi lokasi dan relevansi. 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
(hanya output). Jika alamat lengkap tidak diberikan, layanan akan menggunakan sinyal lain, seperti nama perusahaan, untuk menentukan apakah alamat yang lebih lengkap dapat disimpulkan untuk postingan lowongan.
Misalnya, jika lokasi posisi software ditentukan sebagai Mountain View
,
dan perusahaan yang dikaitkan dengan lowongan adalah Google
, layanan
akan mencari objek company
untuk melihat apakah alamat yang lebih baik
diberikan di kolom headquartersAddress
, dan apakah alamat tersebut berada di kota yang sama
dengan postingan lowongan. Jika demikian, layanan memahami bahwa pekerjaan "kemungkinan"
berada di alamat jalan tersebut dan mengisi kolom derivedInfo.locations
dengan tepat.
Jika data alamat perusahaan tidak tersedia, layanan akan menggunakan kombinasi
pengetahuan kepemilikan dan informasi pekerjaan/perusahaan untuk menentukan kolom
derivedInfo.locations
.
Karena nilai derivedInfo.locations
adalah upaya perkiraan terbaik, Anda mungkin ingin menggunakan
data derivedInfo.locations
, atau kolom addresses
,
saat menampilkan alamat lowongan.
Postingan lowongan tidak boleh memiliki lebih dari 50 lokasi yang terkait dengannya. Jika tugas memiliki lebih banyak lokasi, Anda dapat membagi tugas menjadi beberapa tugas, masing-masing dengan requisitionId unik (misalnya, 'ReqA', 'ReqA-1', 'ReqA-2', dan seterusnya). Memiliki beberapa
tugas dengan requisitionId
, , companyName
, dan languageCode
yang sama tidak
diizinkan. Jika requisitionId
asli harus dipertahankan, CustomAttribute
harus digunakan untuk penyimpanan. Sebaiknya kelompokkan lokasi yang paling dekat
satu sama lain dalam pekerjaan yang sama untuk pengalaman penelusuran yang lebih baik.
Alamat yang didukung
Semua alamat yang dikenali oleh Google Maps Geocoding API (di kolom formattedAddress
) diterima oleh Cloud Talent Solution. Layanan ini
menampilkan error 400 jika Anda mencoba membuat Tugas atau menjalankan penelusuran
menggunakan alamat yang tidak dikenal.
Jika alamat bisnis tidak tercantum dengan benar di Google Maps Geocoding API, laporkan bug untuk memperbaikinya. 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 di seluruh negara bagian, nasional, dan dari jarak jauh
Tugas dapat ditetapkan sebagai seluruh negara bagian, nasional, atau dari jarak jauh menggunakan kolom
postingRegion
.
Tugas
ADMINISTRATIVE_AREA
danNATION
ditampilkan untuk penelusuran apa pun dengan lokasi yang ditentukan di dalam negara bagian/negara tempat postingan lowongan. Misalnya, jika pekerjaanADMINISTRATIVE_AREA
memiliki lokasi "WA, USA", pekerjaan tersebut akan ditampilkan untuk penelusuran denganLocationFilter
yang menentukan "Seattle".TELECOMMUTE
Tugas ditampilkan dalam penelusuran terkait lokasi, tetapi diperlakukan sebagai kurang relevan. Peristiwa ini dapat ditargetkan dalam penelusuran dengan menetapkan tandatelecommutePreference
keTELECOMMUTE_ALLOWED
dalamLocationFilter
penelusuran.