Cloud Talent Solution memungkinkan pengguna menelusuri lowongan yang telah Anda simpan di indeks Cloud Talent Solution. Dokumen ini memandu Anda memahami berbagai penawaran terkait dan penelusuran Cloud Talent Solution.
Telusuri permintaan
Untuk membuat permintaan penelusuran lowongan, kirim permintaan POST ke endpoint jobs:search
,
dengan meneruskan data penelusuran di isi.
Kolom wajib diisi
Kolom berikut wajib diisi:
searchMode
: Menentukan jenis penelusuran lowongan kerja yang akan diterapkan. Opsinya adalah:JOB_SEARCH
: Ini adalah mode penelusuran default dan yang direkomendasikan. Semua tugas akan ditelusuri. Lowongan yang paling relevan ditampilkan dalam urutan relevansi dengan kueri penelusuran.FEATURED_JOB_SEARCH
: Hanya menelusuri pekerjaan denganpromotionValue
lebih besar dari 0. Hasil diurutkan berdasarkanpromotionValue
tertinggi terlebih dahulu; jika ada hasil yang sama, relevansi digunakan untuk menentukan posisi. Lihat Lowongan Unggulan untuk info selengkapnya.
Kolom yang biasa digunakan
JobQuery
: Menentukan kriteria tugas yang akan dicocokkan. Hal ini mencakup lokasi, kategori pekerjaan, jenis pekerjaan, kueri teks, perusahaan, dll. Lihat Filter Penelusuran untuk informasi selengkapnya.requestMetadata
: Berisi informasi pengguna dan sesi untuk permintaan penelusuran ini. Lihat RequestMetadata untuk mengetahui detailnya.jobView
: Menentukan jumlah kolom yang ditampilkan untuk setiap tugas yang cocok. Dapat berupaJOB_VIEW_SMALL
(default),JOB_VIEW_MINIMAL
, atauJOB_VIEW_FULL
. Deskripsi untuk setiap opsi ada di referensiJobView
.orderBy
: Urutan pengurutan untuk tugas yang ditampilkan. Lihat referensi untuk nilai yang diizinkan. Defaultnya adalah mengurutkan berdasarkan relevansi, menurun (RELEVANCE_DESC
).
Penentuan nilai minimum relevansi dan perluasan lokasi/kategori
Untuk menampilkan lebih banyak lowongan dalam penelusuran Anda, dua kolom berikut melonggarkan batasan relevansi:
enableBroadening
: Menetapkan ini ketrue
akan melonggarkan batasan pada lokasi dan kategori pekerjaan dari permintaan penelusuran, untuk menampilkan lebih banyak hasil. Misalnya, jika permintaan penelusuran menentukan pekerjaan dalam radius 2 mil dari Anytown, WA, menyetel tanda ini ketrue
juga dapat menampilkan pekerjaan dari NextTownOver, WA.disableKeywordMatch
: Flag ini salah secara default. Jika tanda ini disetel ke salah (false), Cloud Talent Solution dapat menambahkan lowongan yang relevan dengan kueri penelusuran ini dengan lowongan yang juga cocok dengan string kueri persisnya di judul atau deskripsi.
RequestMetadata
Setiap permintaan penelusuran dan histogram harus menyertakan objek
RequestMetadata
. Objek ini berisi informasi tentang pengguna yang memulai penelusuran.
Ada beberapa alasan mengapa objek ini penting:
Konsistensi pengguna. Cloud Talent Solution menjalankan beberapa versi model pokok secara bersamaan dalam upaya meningkatkan relevansi penelusuran. Isi kolom ini untuk memastikan pencari kerja memiliki pengalaman yang konsisten. Cloud Talent Solution memastikan bahwa pencari kerja (yang diidentifikasi oleh userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Catatan: Kolom ini harus di-obfuscate.
Peningkatan penelusuran.Algoritma penyesuaian didasarkan pada informasi yang diberikan di kolom
RequestMetadata
beserta data pencari kerja yang Anda berikan. Hal ini meningkatkan relevansi hasil penelusuran.
Operator penelusuran
Operator | Deskripsi |
---|---|
( ) | Mengelompokkan satu atau beberapa kata kunci. |
DAN | Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator. |
ATAU | Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator. |
NOT | Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci, dalam tanda kurung, segera setelah operator. |
- | Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci yang ditambahkan ke operator. |
Contoh:
"software OR java"
menampilkan tugas dengan salah satu "software" atau "java" dalam metadatanya."software" -java
menampilkan pekerjaan yang relevan dengan "software", tetapi mengecualikan pekerjaan yang relevan dengan "java"."(software OR java) AND (marketing)"
menampilkan lowongan yang relevan dengan "software" dan "pemasaran", serta lowongan yang relevan dengan "java" dan "pemasaran".
Kueri pencari kerja
Istilah penelusuran juga dapat dideteksi sebagai entitas terkait pekerjaan yang sebenarnya. Misalnya, jika kuerinya adalah 'intern', Cloud Talent Solution akan memperlakukan ini sebagai jenis pekerjaan "INTERN" dan memfilter pekerjaan yang hanya memiliki EMPLOYMENT_TYPE - INTERN. Oleh karena itu, meskipun kata intern harus ada dalam deskripsi pekerjaan, kata tersebut tidak akan ditampilkan jika jenis pekerjaan untuk pekerjaan tersebut ditetapkan ke jenis lain.
Pemecahan masalah
Setiap permintaan penelusuran menghasilkan penelusuran requestID
unik dalam sistem kami yang digunakan untuk melacak parameter penelusuran tersebut serta responsnya. Hal ini sangat penting dalam memecahkan masalah terkait penelusuran tertentu, permintaan CRUD, dan harus dicatat dengan tepat. requestId
ditampilkan di dalam kolom
ResponseMetadata
di isi respons penelusuran.
atau objek respons panggilan CRUD terkait.
Untuk masalah dukungan yang terkait dengan relevansi, kueri penelusuran, kueri pengindeksan, dll., ajukan tiket kepada tim dukungan kami, dan sertakan ID permintaan atau permintaan itu sendiri yang relevan.
Jumlah hasil
Jumlah hasil digunakan untuk menginformasikan jumlah hasil penelusuran kepada pencari kerja. Hal ini tidak selalu sesuai dengan hasil histogram atau jumlah tugas yang sebenarnya ditampilkan. Penelusuran Lowongan menampilkan maksimum 5.000 lowongan.
Penomoran halaman
Secara default, Penelusuran Lowongan menampilkan 100 hasil per halaman (atau lebih sedikit, jika jumlah total hasil kurang dari 100). Anda dapat menerapkan penomoran halaman menggunakan kolom yang terkait dengan fitur ini.
pageSize
: Jumlah hasil yang ditampilkan per halaman.nextPageToken
: Token unik, yang ditampilkan dengan hasil setiap halaman hasil penelusuran, yang menentukan posisi awal untuk halaman hasil berikutnya. Kolom ini dibiarkan kosong jika tidak ada lagi hasil.offset
: Menentukan offset antara peringkat relevansi lowongan yang ditampilkan di bagian atas halaman tertentu dan 1 (Lowongan yang paling relevan yang ditampilkan). Sebagai contoh, pengguna melakukan penelusuran danpageSize
disetel ke 10. Halaman pertama menampilkan lowongan #1 di bagian atas, sehingga nilaioffset
untuk halaman ini adalah 0. Halaman berikutnya menampilkan tugas #11 di bagian atas;offset
untuk halaman ini adalah 10.
Tetapkan ukuran halaman ke 20 hasil atau kurang untuk menghindari masalah latensi. Sebagai praktik terbaik, lakukan panggilan penelusuran terpisah per halaman yang dirender kepada pencari kerja. Alternatifnya, satu panggilan penelusuran untuk menampilkan sejumlah besar tugas dan melakukan penomoran halaman di sisi klien, menghambat kemampuan model machine learning untuk mempelajari secara akurat melalui Framework Analisis Tugas.
Pemeriksaan ejaan
Pemeriksaan ejaan adalah fitur permintaan penelusuran Cloud Talent Solution yang memperhitungkan istilah penelusuran yang berpotensi salah eja, mengoreksinya, dan menampilkan hasil berdasarkan kueri yang telah dikoreksi. Misalnya, saat pemeriksaan ejaan diaktifkan, jika pencari kerja
menelusuri "manaer" dan bukan "manager", Cloud Talent Solution akan menampilkan pekerjaan untuk
"manager". Pemeriksaan ejaan dapat diaktifkan/dinonaktifkan dengan menetapkan kolom
disableSpellCheck
JobQuery. Jika pemeriksaan ejaan diaktifkan, kueri yang dikoreksi dapat ditemukan dalam respons penelusuran, di kolom spellResult
.