JobQuery

Kueri yang diperlukan untuk melakukan kueri penelusuran.

Representasi JSON 
{
  "query": string,
  "queryLanguageCode": string,
  "companies": [
    string
  ],
  "locationFilters": [
    {
      object (LocationFilter)
    }
  ],
  "jobCategories": [
    enum (JobCategory)
  ],
  "commuteFilter": {
    object (CommuteFilter)
  },
  "companyDisplayNames": [
    string
  ],
  "compensationFilter": {
    object (CompensationFilter)
  },
  "customAttributeFilter": string,
  "disableSpellCheck": boolean,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "languageCodes": [
    string
  ],
  "publishTimeRange": {
    object (TimestampRange)
  },
  "excludedJobs": [
    string
  ]
}
Kolom
query

string

String kueri yang cocok dengan kolom judul pekerjaan, deskripsi, dan lokasi.

Jumlah karakter maksimal yang diizinkan adalah 255.
queryLanguageCode

string

Kode bahasa query. Misalnya, "en-US". Kolom ini membantu menafsirkan kueri dengan lebih baik.

Jika nilai tidak ditentukan, kode bahasa kueri akan otomatis terdeteksi, yang mungkin tidak akurat.

Kode bahasa harus dalam format BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi lebih lanjut, lihat Tag untuk Mengidentifikasi Bahasa.
companies[]

string

Filter ini menentukan entitas perusahaan yang akan ditelusuri.

Jika nilai tidak ditentukan, pekerjaan akan ditelusuri dari semua perusahaan.

Jika beberapa nilai ditentukan, pekerjaan akan ditelusuri berdasarkan perusahaan yang ditentukan.

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".

Maksimal 20 filter perusahaan yang diizinkan.
locationFilters[]

object (LocationFilter)

Filter lokasi menentukan wilayah geografis yang berisi lowongan yang akan ditelusuri. Lihat LocationFilter untuk mengetahui informasi selengkapnya.

Jika nilai lokasi tidak ditentukan, pekerjaan yang sesuai dengan kriteria penelusuran lainnya akan diambil terlepas dari lokasi pekerjaan tersebut.

Jika beberapa nilai ditentukan, tugas akan diambil dari lokasi yang ditentukan. Jika nilai yang berbeda ditentukan untuk parameter LocationFilter.distance_in_miles, jarak maksimum yang disediakan akan digunakan untuk semua lokasi.

Maksimal 5 filter lokasi yang diizinkan.
jobCategories[]

enum (JobCategory)

Filter kategori menentukan kategori pekerjaan yang akan ditelusuri. Lihat JobCategory untuk mengetahui informasi selengkapnya.

Jika nilai tidak ditentukan, lowongan dari kategori apa pun akan ditelusuri.

Jika beberapa nilai ditentukan, tugas dari salah satu kategori yang telah ditentukan akan ditelusuri.
commuteFilter

object (CommuteFilter)

Memungkinkan pemfilteran pekerjaan menurut waktu perjalanan dengan metode perjalanan yang berbeda (misalnya, mengemudi atau transportasi umum).

Catatan: Ini hanya berfungsi saat Anda menentukan CommuteMethod. Dalam hal ini, locationFilters akan diabaikan.

Saat ini kami tidak mendukung pengurutan berdasarkan waktu perjalanan.
companyDisplayNames[]

string

Filter ini menentukan Company.display_name perusahaan yang tepat dari lowongan yang akan ditelusuri.

Jika nilai tidak ditentukan, pekerjaan di hasil penelusuran akan dikaitkan dengan perusahaan mana pun.

Jika beberapa nilai ditentukan, pekerjaan di hasil penelusuran dapat dikaitkan dengan perusahaan tertentu.

Maksimal 20 filter nama tampilan perusahaan yang diizinkan.
compensationFilter

object (CompensationFilter)

Filter penelusuran ini hanya diterapkan ke Job.compensation_info. Misalnya, jika filter ditentukan sebagai "Pekerjaan per jam dengan kompensasi per jam > $15", hanya pekerjaan yang memenuhi kriteria ini yang ditelusuri. Jika filter tidak ditentukan, semua lowongan yang terbuka akan ditelusuri.
customAttributeFilter

string

Filter ini menentukan sintaksis terstruktur untuk dicocokkan dengan Job.custom_attributes yang ditandai sebagai filterable.

Sintaksis untuk ekspresi ini adalah bagian dari sintaksis SQL.

Operator yang didukung adalah: =, !=, <, <=, >, dan >= dengan bagian kiri operator adalah kunci kolom kustom dan bagian kanan operator adalah angka atau string yang dikutip. Anda harus meng-escape karakter garis miring terbalik (\) dan tanda petik (").

Fungsi yang didukung adalah LOWER([field_name]) untuk melakukan pencocokan yang tidak peka huruf besar/kecil dan EMPTY([field_name]) untuk memfilter keberadaan kunci.

Ekspresi Boolean (AND/OR/NOT) didukung hingga 3 tingkat tingkatan (misalnya, "(A AND B AND C) OR NOT D) AND E"), maksimum 100 perbandingan atau fungsi yang diizinkan dalam ekspresi. Panjang ekspresi harus < 6000 byte.

Contoh Kueri: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10
disableSpellCheck

boolean

Tanda ini mengontrol fitur periksa ejaan. Jika salah, layanan akan mencoba memperbaiki kueri yang salah eja, misalnya, "enginee" diperbaiki menjadi "engineer".

Nilai defaultnya adalah false (salah): pemeriksaan ejaan dilakukan.
employmentTypes[]

enum (EmploymentType)

Filter jenis pekerjaan menentukan jenis pekerjaan yang akan ditelusuri, seperti EmploymentType.FULL_TIME.

Jika nilai tidak ditentukan, pekerjaan di hasil penelusuran akan mencakup jenis pekerjaan apa pun.

Jika beberapa nilai ditentukan, pekerjaan di hasil penelusuran akan menyertakan salah satu jenis pekerjaan yang ditentukan.
languageCodes[]

string

Filter ini menentukan lokalitas pekerjaan yang akan ditelusuri, misalnya, "en-US".

Jika nilai tidak ditentukan, hasil penelusuran dapat berisi tugas di semua lokalitas.

Kode bahasa harus dalam format BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi lebih lanjut, lihat Tag untuk Mengidentifikasi Bahasa.

Maksimal 10 filter kode bahasa yang diizinkan.
publishTimeRange

object (TimestampRange)

Lowongan yang dipublikasikan dalam rentang yang ditentukan oleh filter ini akan ditelusuri.
excludedJobs[]

string

Filter ini menentukan daftar nama pekerjaan yang akan dikecualikan selama penelusuran.

Jumlah maksimal nama pekerjaan yang dikecualikan adalah 400.

LocationFilter

Wilayah geografis penelusuran.

Representasi JSON 
{
  "address": string,
  "regionCode": string,
  "latLng": {
    object (LatLng)
  },
  "distanceInMiles": number,
  "telecommutePreference": enum (TelecommutePreference),
  "negated": boolean
}
Kolom
address

string

Nama alamat, seperti "Jakarta" atau "Area Bay".
regionCode

string

Kode wilayah CLDR negara/wilayah alamat. Hal ini digunakan untuk mengatasi ambiguitas lokasi input pengguna, misalnya, "Liverpool" melawan "Liverpool, NY, US" atau "Liverpool, UK".

Tetapkan kolom ini untuk membiaskan resolusi lokasi ke negara atau wilayah tertentu. Jika kolom ini tidak disetel, perilaku aplikasi akan condong ke Amerika Serikat secara default.

Lihat https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss. Perhatikan bahwa filter ini tidak berlaku untuk kueri terkait Penelusuran Profil.
latLng

object (LatLng)

Lintang dan bujur pusat geografis yang akan ditelusuri. Kolom ini diabaikan jika address diberikan.
distanceInMiles

number

Jarak InMiles diterapkan jika lokasi yang ditelusuri diidentifikasi sebagai kota atau yang lebih kecil. Kolom ini diabaikan jika lokasi yang ditelusuri adalah negara bagian atau wilayah yang lebih luas.
telecommutePreference

enum (TelecommutePreference)

Memungkinkan klien mengembalikan pekerjaan tanpa lokasi yang ditetapkan, khususnya, pekerjaan dari jarak jauh (dari jarak jauh dianggap oleh layanan sebagai lokasi khusus. Job.posting_region menunjukkan apakah pekerjaan mengizinkan kerja jarak jauh. Jika kolom ini disetel ke TelecommutePreference.TELECOMMUTE_ALLOWED, lowongan kerja jarak jauh akan ditelusuri, serta address dan latLng akan diabaikan. Jika tidak ditetapkan atau ditetapkan ke TelecommutePreference.TELECOMMUTE_EXCLUDED, lowongan kerja dari jarak jauh tidak ditelusuri.

Filter ini dapat digunakan sendiri untuk menelusuri lowongan kerja dari jarak jauh secara khusus, atau dapat digabungkan dengan filter lokasi lain untuk menelusuri kombinasi lokasi lowongan, seperti lowongan kerja "Jakarta" atau "kerja jarak jauh". Namun, bila digunakan bersama filter lokasi lainnya, pekerjaan dari jarak jauh dapat dianggap kurang relevan dibandingkan pekerjaan lain dalam respons penelusuran.

Kolom ini hanya digunakan untuk permintaan penelusuran lowongan.
negated

boolean

Apakah akan menerapkan negasi ke filter sehingga profil yang cocok dengan filter akan dikecualikan.

Saat ini hanya didukung di penelusuran profil.

TelecommutePreference

Tentukan apakah akan menyertakan tugas jarak jauh.

Enum
TELECOMMUTE_PREFERENCE_UNSPECIFIED Nilai default jika preferensi jarak jauh tidak ditentukan.
TELECOMMUTE_EXCLUDED Kecualikan pekerjaan dari jarak jauh.
TELECOMMUTE_ALLOWED Izinkan tugas jarak jauh.

CommuteFilter

Parameter yang diperlukan untuk penelusuran perjalanan.

Representasi JSON 
{
  "commuteMethod": enum (CommuteMethod),
  "startCoordinates": {
    object (LatLng)
  },
  "travelDuration": string,
  "allowImpreciseAddresses": boolean,

  // Union field traffic_option can be only one of the following:
  "roadTraffic": enum (RoadTraffic),
  "departureTime": {
    object (TimeOfDay)
  }
  // End of list of possible types for union field traffic_option.
}
Kolom
commuteMethod

enum (CommuteMethod)

Wajib. Metode transportasi untuk menghitung waktu perjalanan.
startCoordinates

object (LatLng)

Wajib. Lintang dan bujur lokasi untuk menghitung waktu perjalanan.
travelDuration

string (Duration format)

Wajib. Waktu tempuh maksimum dalam detik. Nilai maksimum yang diizinkan adalah 3600s (satu jam). Formatnya adalah 123s.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
allowImpreciseAddresses

boolean

Jika true, lowongan tanpa alamat tingkat jalan juga dapat ditampilkan. Untuk alamat tingkat kota, pusat kota digunakan. Untuk alamat tingkat negara bagian dan tingkat umum, pencocokan teks digunakan. Jika kolom ini ditetapkan ke false atau tidak ditentukan, hanya lowongan yang menyertakan alamat jalan yang akan ditampilkan oleh penelusuran perjalanan.
Kolom union traffic_option. Faktor lalu lintas yang harus diperhitungkan saat menelusuri berdasarkan perjalanan. traffic_option hanya ada berupa salah satu diantara berikut:
roadTraffic

enum (RoadTraffic)

Menentukan kepadatan lalu lintas yang akan digunakan saat menghitung waktu perjalanan.
departureTime

object (TimeOfDay)

Waktu keberangkatan yang digunakan untuk menghitung dampak lalu lintas, yang direpresentasikan sebagai google.type.TimeOfDay dalam zona waktu lokal.

Saat ini, model traffic dibatasi untuk resolusi tingkat jam.

CommuteMethod

Metode untuk perjalanan.

Enum
COMMUTE_METHOD_UNSPECIFIED Metode perjalanan tidak ditentukan.
DRIVING Waktu perjalanan dihitung berdasarkan waktu mengemudi.
TRANSIT Waktu perjalanan dihitung berdasarkan transportasi umum yang meliputi bus, metro, kereta bawah tanah, dan sebagainya.
WALKING Waktu perjalanan dihitung berdasarkan waktu berjalan kaki.
CYCLING Waktu perjalanan dihitung berdasarkan waktu bersepeda.

RoadTraffic

Kepadatan lalu lintas yang akan digunakan saat menghitung waktu perjalanan.

Enum
ROAD_TRAFFIC_UNSPECIFIED Situasi lalu lintas jalan tidak ditentukan.
TRAFFIC_FREE Waktu perjalanan yang optimal tanpa mempertimbangkan dampak lalu lintas.
BUSY_HOUR Penghitungan waktu perjalanan memperhitungkan dampak puncak lalu lintas.

TimeOfDay

Merepresentasikan waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date dan google.protobuf.Timestamp.

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus antara 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis.
minutes

integer

Menit dalam jam. Harus antara 0 hingga 59.
seconds

integer

Detik dari menit. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

CompensationFilter

Memfilter jenis dan jumlah kompensasi pekerjaan.

Representasi JSON 
{
  "type": enum (FilterType),
  "units": [
    enum (CompensationUnit)
  ],
  "range": {
    object (CompensationRange)
  },
  "includeJobsWithUnspecifiedCompensationRange": boolean
}
Kolom
type

enum (FilterType)

Wajib. Jenis filter.
units[]

enum (CompensationUnit)

Wajib. Tentukan base compensation entry's CompensationInfo.CompensationUnit yang diinginkan.
range

object (CompensationRange)

Rentang kompensasi.
includeJobsWithUnspecifiedCompensationRange

boolean

Jika disetel ke benar (true), tugas dengan kolom rentang kompensasi yang tidak ditentukan akan disertakan.

FilterType

Tentukan jenis pemfilteran.

Enum
FILTER_TYPE_UNSPECIFIED Jenis filter belum ditetapkan. Penahan posisi, INVALID, tidak boleh digunakan.
UNIT_ONLY

Filter menurut unit base compensation entry's. Tugas cocok jika dan hanya jika tugas berisi CompensationEntry dasar dan unit CompensationEntry dasar cocok dengan units yang diberikan. Mengisi satu atau beberapa units.

Lihat CompensationInfo.CompensationEntry untuk mengetahui definisi entri kompensasi dasar.
UNIT_AND_AMOUNT

Filter menurut unit base compensation entry's dan jumlah / rentang. Tugas dianggap cocok jika dan hanya jika tugas berisi CompensationEntry dasar, dan unit entri dasar cocok dengan CompensationUnit yang diberikan serta jumlah atau rentang tumpang-tindih dengan CompensationRange yang disediakan.

Lihat CompensationInfo.CompensationEntry untuk mengetahui definisi entri kompensasi dasar.

Tetapkan persis satu units dan isi range.
ANNUALIZED_BASE_AMOUNT

Filter menurut jumlah kompensasi dasar tahunan dan unit base compensation entry's. Mengisi range dan nol atau lebih banyak units.
ANNUALIZED_TOTAL_AMOUNT

Filter menurut jumlah total kompensasi tahunan dan base compensation entry's unit . Mengisi range dan nol atau lebih banyak units.

TimestampRange

Pesan yang merepresentasikan periode waktu antara dua stempel waktu.

Representasi JSON 
{
  "startTime": string,
  "endTime": string
}
Kolom
startTime

string (Timestamp format)

Awal periode (inklusif).
endTime

string (Timestamp format)

Akhir periode (eksklusif).