Package google.cloud.talent.v4beta1

Indeks

CompanyService

Layanan yang menangani pengelolaan perusahaan, termasuk CRUD dan enumerasi.

CreateCompany

rpc CreateCompany(CreateCompanyRequest) returns (Company)

Membuat entitas perusahaan baru.

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.

DeleteCompany

rpc DeleteCompany(DeleteCompanyRequest) returns (Empty)

Menghapus perusahaan tertentu. Prasyarat: Perusahaan tidak memiliki pekerjaan yang terkait dengannya.

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.

GetCompany

rpc GetCompany(GetCompanyRequest) returns (Company)

Mengambil perusahaan yang ditentukan.

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.

ListCompanies

rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse)

Mencantumkan semua perusahaan yang terkait dengan project.

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.

UpdateCompany

rpc UpdateCompany(UpdateCompanyRequest) returns (Company)

Memperbarui perusahaan yang ditentukan.

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.

Selesai

Layanan menangani pelengkapan otomatis.

CompleteQuery

rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse)

Melengkapi awalan yang ditentukan dengan saran kata kunci. Dimaksudkan untuk digunakan oleh kotak telusur pelengkapan otomatis penelusuran lowongan.

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.

EventService

Layanan menangani laporan peristiwa klien.

CreateClientEvent

rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent)

Melaporkan peristiwa yang dikeluarkan saat pengguna akhir berinteraksi dengan aplikasi pelanggan yang menggunakan Cloud Talent Solution. Anda dapat memeriksa peristiwa yang dibuat di alat layanan mandiri. Pelajari lebih lanjut alat layanan mandiri.

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.

JobService

Sebuah layanan menangani manajemen pekerjaan, termasuk CRUD pekerjaan, enumerasi, dan pencarian.

BatchCreateJobs

rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation)

Mulai menjalankan operasi pembuatan tugas batch.

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.

BatchDeleteJobs

rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty)

Menghapus daftar Job berdasarkan filter.

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.

BatchUpdateJobs

rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation)

Mulai menjalankan operasi tugas update batch.

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.

CreateJob

rpc CreateJob(CreateJobRequest) returns (Job)

Membuat tugas baru.

Biasanya, tugas dapat ditelusuri dalam waktu 10 detik, tetapi mungkin memerlukan waktu hingga 5 menit.

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.

DeleteJob

rpc DeleteJob(DeleteJobRequest) returns (Empty)

Menghapus tugas yang ditentukan.

Biasanya, tugas menjadi tidak dapat ditelusuri dalam waktu 10 detik, tetapi mungkin juga memerlukan waktu hingga 5 menit.

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.

GetJob

rpc GetJob(GetJobRequest) returns (Job)

Mengambil pekerjaan yang ditentukan, yang statusnya OPEN atau baru saja EXPIRED dalam 90 hari terakhir.

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.

ListJobs

rpc ListJobs(ListJobsRequest) returns (ListJobsResponse)

Mencantumkan tugas berdasarkan filter.

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.

SearchJobs

rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse)

Menelusuri lowongan menggunakan SearchJobsRequest yang disediakan.

Panggilan ini membatasi visibility tugas yang ada dalam database, dan hanya menampilkan tugas yang izin penelusurannya dimiliki pemanggil.

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.

SearchJobsForAlert

rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse)

Menelusuri lowongan menggunakan SearchJobsRequest yang disediakan.

Panggilan API ini ditujukan untuk kasus penggunaan yang menargetkan pencari kerja pasif (misalnya, pencari kerja yang telah mendaftar untuk menerima pemberitahuan email tentang peluang kerja yang potensial), dan memiliki berbagai penyesuaian algoritma yang ditargetkan untuk pencari kerja pasif.

Panggilan ini membatasi visibility tugas yang ada dalam database, dan hanya menampilkan tugas yang izin penelusurannya dimiliki pemanggil.

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.

UpdateJob

rpc UpdateJob(UpdateJobRequest) returns (Job)

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.

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.

TenantService

Layanan yang menangani pengelolaan penyewa, termasuk CRUD dan enumerasi.

CreateTenant

rpc CreateTenant(CreateTenantRequest) returns (Tenant)

Membuat entity tenant baru.

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.

DeleteTenant

rpc DeleteTenant(DeleteTenantRequest) returns (Empty)

Menghapus tenant yang ditentukan.

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.

GetTenant

rpc GetTenant(GetTenantRequest) returns (Tenant)

Mengambil tenant yang ditentukan.

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.

ListTenants

rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse)

Mencantumkan semua tenant yang terkait dengan project.

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.

UpdateTenant

rpc UpdateTenant(UpdateTenantRequest) returns (Tenant)

Memperbarui tenant yang ditentukan.

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.

BatchCreateJobsRequest

Permintaan untuk membuat batch tugas.

Kolom
parent

string

Wajib. Nama resource tenant tempat tugas dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

jobs[]

Job

Wajib. Tugas yang akan dibuat.

BatchDeleteJobsRequest

Permintaan tugas penghapusan batch.

Kolom
parent

string

Wajib. Nama resource tenant tempat tugas dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

filter

string

Wajib. String filter menentukan tugas yang akan dihapus.

Operator yang didukung: =, AND

Kolom yang memenuhi syarat untuk pemfilteran adalah:

  • companyName (Wajib diisi)
  • requisitionId (Wajib diisi)

Contoh Kueri: companyName = "projects/foo/company/bar" AND requisitionId = "req-1"

BatchOperationMetadata

Metadata yang digunakan untuk operasi yang berjalan lama yang ditampilkan oleh API batch CTS. Nama ini digunakan untuk mengganti google.longrunning.Operation.metadata.

Kolom
state

State

Status operasi yang berjalan lama.

state_description

string

Informasi lebih mendetail tentang status operasi.

success_count

int32

Jumlah item yang berhasil dalam operasi.

failure_count

int32

Jumlah item yang gagal dalam operasi.

total_count

int32

Jumlah total item dalam operasi.

create_time

Timestamp

Waktu ketika operasi batch dibuat.

update_time

Timestamp

Waktu ketika status operasi batch diperbarui. Metadata dan update_time akan diperbarui setiap menit, jika tidak, data yang di-cache akan ditampilkan.

end_time

Timestamp

Waktu ketika operasi batch selesai dan google.longrunning.Operation.done ditetapkan ke true.

Negara bagian/Provinsi

Enum
STATE_UNSPECIFIED Nilai default.
INITIALIZING Operasi batch sedang disiapkan untuk diproses.
PROCESSING Operasi batch sedang aktif diproses.
SUCCEEDED Operasi batch diproses, dan setidaknya satu item telah berhasil diproses.
FAILED Operasi batch selesai dan tidak ada item yang berhasil diproses.
CANCELLING Operasi batch sedang dalam proses pembatalan setelah google.longrunning.Operations.CancelOperation dipanggil.
CANCELLED Operasi batch dilakukan setelah google.longrunning.Operations.CancelOperation dipanggil. Item yang diproses sebelum pembatalan akan dikembalikan dalam respons.

BatchUpdateJobsRequest

Permintaan untuk memperbarui batch tugas.

Kolom
parent

string

Wajib. Nama resource tenant tempat tugas dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

jobs[]

Job

Wajib. Tugas yang akan diperbarui.

update_mask

FieldMask

Sangat direkomendasikan untuk pengalaman layanan terbaik. Perlu diketahui bahwa hal ini juga akan meningkatkan latensi saat memeriksa status operasi batch.

Jika update_mask 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.

Jika update_mask diberikan, Job di dalam JobResult hanya akan berisi kolom yang diperbarui, ditambah ID Pekerjaan. Jika tidak, Job akan menyertakan semua kolom, yang dapat menghasilkan respons yang sangat besar.

ClientEvent

Peristiwa yang dikeluarkan saat pengguna akhir berinteraksi dengan aplikasi yang menerapkan Cloud Talent Solution. Memberikan informasi ini akan meningkatkan kualitas hasil untuk klien API, sehingga layanan dapat berfungsi secara optimal. Jumlah peristiwa yang dikirim harus konsisten dengan panggilan lainnya, seperti penelusuran tugas, yang dikeluarkan untuk layanan oleh klien.

Kolom
request_id

string

Sangat direkomendasikan untuk pengalaman layanan terbaik.

ID unik yang dibuat dalam respons API. Kolom ini dapat ditemukan di ResponseMetadata.request_id.

event_id

string

Wajib. ID unik yang dihasilkan oleh aplikasi klien.

create_time

Timestamp

Wajib. Stempel waktu peristiwa.

event_notes

string

Catatan tentang acara yang diberikan oleh perekrut atau pengguna lain, misalnya, masukan tentang alasan bookmark profil.

job_event

JobEvent

Peristiwa yang dikeluarkan saat pencari kerja berinteraksi dengan aplikasi yang menerapkan Cloud Talent Solution.

CommuteFilter

Parameter yang diperlukan untuk penelusuran perjalanan.

Kolom
commute_method

CommuteMethod

Wajib. Metode transportasi untuk menghitung waktu perjalanan.

start_coordinates

LatLng

Wajib. Lintang dan bujur lokasi untuk menghitung waktu perjalanan.

travel_duration

Duration

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

allow_imprecise_addresses

bool

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:
road_traffic

RoadTraffic

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

departure_time

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.

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.

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.

Perusahaan

Resource Perusahaan mewakili perusahaan dalam layanan. Perusahaan adalah entitas yang memiliki lowongan pekerjaan, yaitu, entitas perekrutan yang bertanggung jawab untuk mempekerjakan pelamar untuk posisi pekerjaan tersebut.

Kolom
name

string

Diwajibkan selama pembaruan perusahaan.

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

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/Company/{company_id}", misalnya, "projects/foo/tenants/bar/Companies/baz".

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

display_name

string

Wajib. Nama tampilan perusahaan, misalnya, "Google LLC".

external_id

string

Wajib. ID perusahaan sisi klien, digunakan untuk mengidentifikasi perusahaan secara unik.

Jumlah karakter maksimal yang diizinkan adalah 255.

size

CompanySize

Ukuran perusahaan tempat kerja.

headquarters_address

string

Alamat kantor pusat utama perusahaan, yang mungkin berbeda dari lokasi pekerjaan. Layanan ini berupaya melakukan geolokasi alamat yang diberikan, dan mengisi lokasi yang lebih spesifik jika memungkinkan di DerivedInfo.headquarters_location.

hiring_agency

bool

Tetapkan ke benar (true) jika agen perekrutanlah yang memposting lowongan untuk perusahaan lain.

Nilai defaultnya adalah false (salah) jika tidak disediakan.

eeo_text

string

Teks pernyataan penyangkalan hukum Kesempatan Kerja yang Sama untuk dikaitkan dengan semua pekerjaan, dan biasanya ditampilkan di semua peran.

Jumlah karakter maksimal yang diizinkan adalah 500.

website_uri

string

URI yang mewakili situs atau halaman beranda utama perusahaan, misalnya, "https://www.google.com".

Jumlah karakter maksimal yang diizinkan adalah 255.

career_site_uri

string

URI ke situs karier atau halaman karier di situs perusahaan, misalnya, "https://careers.google.com".

image_uri

string

URI yang menghosting logo perusahaan tempat kerja.

keyword_searchable_job_custom_attributes[]

string

Daftar kunci Job.custom_attributes yang dapat difilter, yang string_values yang sesuai digunakan dalam penelusuran kata kunci. Tugas dengan string_values dalam kunci kolom yang ditentukan ini akan ditampilkan jika ada nilai yang cocok dengan kata kunci penelusuran. Nilai kolom kustom dengan tanda kurung, tanda kurung siku, serta simbol khusus tidak dapat ditelusuri sebagaimana adanya, dan kueri kata kunci tersebut harus diapit tanda kutip.

derived_info

DerivedInfo

Hanya output. Mendapatkan detail tentang perusahaan.

suspended

bool

Hanya output. Menunjukkan apakah perusahaan ditandai agar ditangguhkan dari ketersediaan publik oleh layanan ketika konten lowongan tampak mencurigakan, melanggar, atau berisi spam.

DerivedInfo

Mendapatkan detail tentang perusahaan.

Kolom
headquarters_location

Location

Lokasi kantor pusat perusahaan yang terstruktur, diselesaikan dari Company.headquarters_address jika disediakan.

CompanySize

Sebuah enum yang mewakili ukuran perusahaan.

Enum
COMPANY_SIZE_UNSPECIFIED Nilai default jika ukuran tidak ditentukan.
MINI Perusahaan ini memiliki kurang dari 50 karyawan.
SMALL Perusahaan ini memiliki antara 50 dan 99 karyawan.
SMEDIUM Perusahaan ini memiliki 100 hingga 499 karyawan.
MEDIUM Perusahaan ini memiliki antara 500 dan 999 karyawan.
BIG Perusahaan ini memiliki antara 1.000 dan 4.999 karyawan.
BIGGER Perusahaan ini memiliki antara 5.000 dan 9.999 karyawan.
GIANT Perusahaan memiliki 10.000 karyawan atau lebih.

CompensationFilter

Memfilter jenis dan jumlah kompensasi pekerjaan.

Kolom
type

FilterType

Wajib. Jenis filter.

units[]

CompensationUnit

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

range

CompensationRange

Rentang kompensasi.

include_jobs_with_unspecified_compensation_range

bool

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.

CompensationInfo

Detail kompensasi pekerjaan.

Kolom
entries[]

CompensationEntry

Informasi kompensasi pekerjaan.

Maksimal satu entri dapat berjenis CompensationInfo.CompensationType.BASE, yang disebut sebagai entri kompensasi dasar untuk tugas.

annualized_base_compensation_range

CompensationRange

Hanya output. Rentang kompensasi dasar tahunan. Dihitung sebagai entri kompensasi dasar CompensationEntry.amount kali CompensationEntry.expected_units_per_year.

Lihat CompensationEntry untuk penjelasan tentang tahunan kompensasi.

annualized_total_compensation_range

CompensationRange

Hanya output. Rentang kompensasi total tahunan. Dihitung sebagai semua entri kompensasi CompensationEntry.amount kali CompensationEntry.expected_units_per_year.

Lihat CompensationEntry untuk penjelasan tentang tahunan kompensasi.

CompensationEntry

Entri kompensasi yang mewakili satu komponen kompensasi, seperti gaji pokok, bonus, atau jenis kompensasi lainnya.

Tahunanisasi: Satu entri kompensasi dapat disetahunkan jika - berisi amount atau range yang valid. - dan expected_units_per_year-nya ditetapkan atau dapat diperoleh. Rentang tahunannya ditentukan sebagai (amount atau range) dikali expected_units_per_year.

Kolom
type

CompensationType

Jenis kompensasi.

Default-nya adalah CompensationType.COMPENSATION_TYPE_UNSPECIFIED.

unit

CompensationUnit

Frekuensi jumlah yang ditentukan.

Default-nya adalah CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.

description

string

Deskripsi kompensasi. Misalnya, dapat menunjukkan persyaratan ekuitas atau memberikan konteks tambahan ke estimasi bonus.

expected_units_per_year

DoubleValue

Perkiraan jumlah unit yang dibayarkan setiap tahun. Jika tidak ditentukan, jika Job.employment_types adalah FULLTIME, nilai default akan disimpulkan berdasarkan unit. Nilai default: - JAM: 2080 - HARIAN: 260 - MINGGU: 52 - BULANAN: 12 - TAHUNAN: 1

Kolom union compensation_amount. Jumlah kompensasi. Nilai ini dapat berupa jumlah tetap atau rentang mengambang. compensation_amount hanya ada berupa salah satu diantara berikut:
amount

Money

Jumlah kompensasi.

range

CompensationRange

Rentang kompensasi.

CompensationRange

Rentang kompensasi.

Kolom
max_compensation

Money

Jumlah kompensasi maksimum. Jika dibiarkan kosong, nilai akan ditetapkan ke nilai kompensasi maksimal dan kode mata uang akan disetel agar cocok dengan currency code dari min_compensation.

min_compensation

Money

Jumlah kompensasi minimum. Jika dibiarkan kosong, nilai ditetapkan ke nol dan kode mata uang disetel agar cocok dengan currency code dari max_compensation.

CompensationType

Jenis kompensasi.

Untuk jumlah kompensasi yang ditentukan dalam jumlah non-moneter, jelaskan skema kompensasi di CompensationEntry.description.

Misalnya, format tip dijelaskan dalam CompensationEntry.description (misalnya, "memperkirakan 15-20% tip berdasarkan tagihan pelanggan"). dan perkiraan tips yang diberikan di CompensationEntry.amount atau CompensationEntry.range ($10 per jam).

Misalnya, ekuitas dijelaskan dalam CompensationEntry.description (misalnya, "1% - 2% ekuitas vesting selama 4 tahun, jurang 1 tahun") dan nilai estimasi dalam CompensationEntry.amount atau CompensationEntry.range. Jika tidak ada estimasi nilai, unit akan berstatus CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED, lalu diklarifikasi lebih lanjut di kolom CompensationEntry.description.

Enum
COMPENSATION_TYPE_UNSPECIFIED Nilai default.
BASE Kompensasi dasar: Mengacu pada jumlah uang tetap yang dibayarkan kepada karyawan oleh pemberi kerja sebagai imbalan atas pekerjaan yang dilakukan. Kompensasi dasar tidak termasuk manfaat, bonus, atau potensi kompensasi lainnya dari pemberi kerja.
BONUS Bonus.
SIGNING_BONUS Bonus penandatanganan.
EQUITY Kesetaraan.
PROFIT_SHARING Pembagian keuntungan.
COMMISSIONS Komisi.
TIPS Kiat.
OTHER_COMPENSATION_TYPE Jenis kompensasi lainnya.

CompensationUnit

Frekuensi pembayaran.

Enum
COMPENSATION_UNIT_UNSPECIFIED Nilai default.
HOURLY Per jam.
DAILY Setiap hari.
WEEKLY Mingguan
MONTHLY Setiap bulan.
YEARLY Tahunan.
ONE_TIME Satu kali.
OTHER_COMPENSATION_UNIT Unit kompensasi lainnya.

CompleteQueryRequest

Parameter pelengkapan otomatis.

Kolom
parent

string

Wajib. Nama resource tenant tempat penyelesaian dilakukan.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenant/bar".

Jika ID tenant tidak ditentukan, tenant default akan digunakan, misalnya, "projects/foo".

query

string

Wajib. Kueri yang digunakan untuk menghasilkan saran.

Jumlah karakter maksimal yang diizinkan adalah 255.

language_codes[]

string

Daftar bahasa kueri. Ini adalah kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi lebih lanjut, lihat Tag untuk Mengidentifikasi Bahasa.

Jumlah karakter maksimal yang diizinkan adalah 255.

page_size

int32

Wajib. Jumlah hasil penyelesaian.

Ukuran halaman maksimum yang diizinkan adalah 10.

company

string

Jika disediakan, akan membatasi penyelesaian untuk perusahaan tertentu.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/Company/{company_id}", misalnya, "projects/foo/tenants/bar/Companies/baz".

Jika ID tenant tidak ditentukan, tenant default akan digunakan, misalnya, "projects/foo".

scope

CompletionScope

Cakupan penyelesaian. Defaultnya adalah CompletionScope.PUBLIC.

type

CompletionType

Topik penyelesaian. Nilai defaultnya adalah CompletionType.COMBINED.

CompletionScope

Enum untuk menentukan cakupan penyelesaian.

Enum
COMPLETION_SCOPE_UNSPECIFIED Nilai default.
TENANT Saran hanya didasarkan pada data yang diberikan oleh klien.
PUBLIC Saran didasarkan pada semua data pekerjaan di sistem yang dapat dilihat oleh klien

CompletionType

Enum untuk menentukan topik penyelesaian otomatis.

Enum
COMPLETION_TYPE_UNSPECIFIED Nilai default.
JOB_TITLE

Menyarankan jabatan untuk pelengkapan otomatis tugas.

Untuk jenis CompletionType.JOB_TITLE, hanya tugas yang terbuka dengan language_codes yang sama yang ditampilkan.

COMPANY_NAME

Sarankan nama perusahaan untuk pelengkapan otomatis pekerjaan.

Untuk jenis CompletionType.COMPANY_NAME, hanya perusahaan yang memiliki lowongan dengan language_codes sama yang ditampilkan.

COMBINED

Menyarankan jabatan pekerjaan dan nama perusahaan untuk pelengkapan otomatis pekerjaan.

Untuk jenis CompletionType.COMBINED, hanya lowongan dengan language_codes yang sama atau perusahaan yang membuka lowongan dengan language_codes yang sama yang ditampilkan.

CompleteQueryResponse

Respons kueri pelengkapan otomatis.

Kolom
completion_results[]

CompletionResult

Hasil dari kandidat pekerjaan/perusahaan yang cocok.

metadata

ResponseMetadata

Informasi tambahan untuk pemanggilan API, seperti ID pelacakan permintaan.

CompletionResult

Resource yang mewakili hasil penyelesaian.

Kolom
suggestion

string

Saran untuk kueri.

type

CompletionType

Topik penyelesaian.

image_uri

string

URI gambar perusahaan untuk COMPANY_NAME.

CreateClientEventRequest

Permintaan laporan peristiwa.

Kolom
parent

string

Wajib. Nama resource tenant tempat peristiwa dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat, misalnya, "projects/foo".

client_event

ClientEvent

Wajib. Peristiwa yang dikeluarkan saat pengguna akhir berinteraksi dengan aplikasi pelanggan yang menggunakan Cloud Talent Solution.

CreateCompanyRequest

Permintaan metode CreateCompany.

Kolom
parent

string

Wajib. Nama resource tenant tempat perusahaan dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat, misalnya, "projects/foo".

company

Company

Wajib. Perusahaan yang akan dibuat.

CreateJobRequest

Buat permintaan tugas.

Kolom
parent

string

Wajib. Nama resource tenant tempat tugas dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

job

Job

Wajib. Tugas yang akan dibuat.

CreateTenantRequest

Permintaan metode CreateTenant.

Kolom
parent

string

Wajib. Nama resource project tempat tenant dibuat.

Formatnya adalah "projects/{project_id}", misalnya, "projects/foo".

tenant

Tenant

Wajib. Penyewa yang akan dibuat.

CustomAttribute

Nilai atribut khusus yang dapat difilter atau tidak dapat difilter.

Kolom
string_values[]

string

Tepat satu dari string_values atau long_values harus ditentukan.

Kolom ini digunakan untuk melakukan penelusuran pencocokan string (CASE_SENSITIVE_MATCH atau CASE_INSENSITIVE_MATCH). Untuk string_value yang dapat difilter, jumlah total maksimum 200 nilai diperbolehkan, dengan setiap string_value memiliki ukuran byte tidak lebih dari 500 B. Untuk string_values yang tidak dapat difilter, total ukuran byte maksimum dari string_values yang tidak dapat difilter adalah 50 KB.

String kosong tidak diizinkan.

long_values[]

int64

Tepat satu dari string_values atau long_values harus ditentukan.

Kolom ini digunakan untuk melakukan penelusuran rentang angka. (EQ, GT, GE, LE, LT) di atas long_value yang dapat difilter.

Saat ini maksimum 1 long_values didukung.

filterable

bool

Jika tanda filterable bernilai benar, nilai kolom kustom dapat digunakan untuk filter atribut khusus JobQuery.custom_attribute_filter. Jika false, nilai ini tidak dapat digunakan untuk filter atribut khusus.

Defaultnya adalah false.

keyword_searchable

bool

Jika tanda keyword_searchable benar, kata kunci di kolom kustom dapat ditelusuri berdasarkan pencocokan kata kunci. Jika false, nilai tidak dapat ditelusuri dengan pencocokan kata kunci.

Defaultnya adalah false.

DegreeType

Tingkat gelar pendidikan yang ditetapkan dalam International Standard Classification of Education (ISCED).

Enum
DEGREE_TYPE_UNSPECIFIED Nilai default. Mewakili tanpa gelar, atau pendidikan anak usia dini. Memetakan ke kode ISCED 0. Mis. TK
PRIMARY_EDUCATION Pendidikan dasar yang biasanya merupakan tahap pertama dari pendidikan wajib. Kode ISCED 1. Contoh) SD
LOWER_SECONDARY_EDUCATION Pendidikan menengah bawah; Tahap pertama pembangunan pendidikan menengah pada pendidikan dasar, biasanya dengan kurikulum yang lebih berorientasi pada mata pelajaran. Kode ISCED 2. Contoh) Sekolah menengah
UPPER_SECONDARY_EDUCATION Pendidikan menengah; Tahap kedua/akhir dari pendidikan menengah yang mempersiapkan pendidikan tinggi dan/atau memberikan keterampilan yang relevan dengan pekerjaan. Biasanya dengan rentang opsi subjek dan streaming yang lebih banyak. Kode ISCED 3. Contoh) SMA
ADULT_REMEDIAL_EDUCATION Pendidikan Remedial Dewasa; Program yang memberikan pengalaman belajar yang dibangun di atas pendidikan menengah dan mempersiapkan diri untuk memasuki pasar tenaga kerja dan/atau pendidikan tinggi. Materinya lebih luas daripada pendidikan menengah tetapi tidak serumit pendidikan tinggi. Kode ISCED 4.
ASSOCIATES_OR_EQUIVALENT Associate atau yang setara; Program tersier pendek pertama yang biasanya didasarkan pada praktik, pekerjaan khusus, dan mempersiapkan diri untuk memasuki pasar tenaga kerja. Program-program ini juga dapat memberikan jalan ke program pendidikan tinggi lainnya. Kode ISCED 5.
BACHELORS_OR_EQUIVALENT Sarjana atau yang setara; Program yang dirancang untuk memberikan pengetahuan, keterampilan, dan kompetensi akademik menengah dan/atau profesional yang mengarah ke gelar tersier pertama atau kualifikasi yang setara. Kode ISCED 6.
MASTERS_OR_EQUIVALENT Magister atau yang setara; Program yang dirancang untuk memberikan pengetahuan, keterampilan, dan kompetensi akademik lanjutan dan/atau profesional yang mengarah ke gelar tersier kedua atau kualifikasi yang setara. Kode ISCED 7.
DOCTORAL_OR_EQUIVALENT Doktor atau yang setara; Program yang dirancang terutama untuk mengarah pada kualifikasi penelitian lanjutan, biasanya diakhiri dengan pengiriman dan pembelaan disertasi substantif tentang kualitas yang dapat dipublikasikan berdasarkan penelitian asli. Kode ISCED 8.

DeleteCompanyRequest

Permintaan untuk menghapus perusahaan.

Kolom
name

string

Wajib. Nama resource perusahaan yang akan dihapus.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/Company/{company_id}", misalnya, "projects/foo/tenants/bar/Companies/baz".

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

DeleteJobRequest

Hapus permintaan tugas.

Kolom
name

string

Wajib. Nama resource tugas yang akan dihapus.

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

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

DeleteTenantRequest

Permintaan untuk menghapus tenant.

Kolom
name

string

Wajib. Nama resource tenant yang akan dihapus.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenants/bar".

DeviceInfo

Informasi perangkat yang dikumpulkan dari pencari kerja, kandidat, atau entitas lain yang melakukan pencarian kerja. Memberikan informasi ini akan meningkatkan kualitas hasil penelusuran di seluruh perangkat.

Kolom
device_type

DeviceType

Jenis perangkat.

id

string

ID khusus perangkat. ID harus berupa ID unik yang membedakan perangkat dari perangkat lain.

DeviceType

Enumerasi yang menjelaskan portal akses dan mekanisme eksposur API.

Enum
DEVICE_TYPE_UNSPECIFIED Jenis perangkat tidak ditentukan.
WEB Browser web desktop, seperti Chrome, Firefox, Safari, atau Internet Explorer)
MOBILE_WEB Browser web perangkat seluler, seperti ponsel atau tablet dengan browser Chrome.
ANDROID Aplikasi native perangkat Android.
IOS Aplikasi native perangkat iOS.
BOT Bot, bukan perangkat yang dioperasikan oleh manusia, seperti web crawler.
OTHER Jenis perangkat lainnya.

EmploymentType

Enum yang mewakili jenis pekerjaan suatu pekerjaan.

Enum
EMPLOYMENT_TYPE_UNSPECIFIED Nilai default jika jenis pekerjaan tidak ditentukan.
FULL_TIME Pekerjaan ini menuntut kerja selama beberapa jam yang membentuk pekerjaan purnawaktu, biasanya 40 jam atau lebih per minggu.
PART_TIME Pekerjaan tersebut memerlukan waktu kerja yang lebih sedikit dibandingkan pekerjaan purnawaktu, biasanya kurang dari 40 jam seminggu.
CONTRACTOR Pekerjaan tersebut ditawarkan sebagai karyawan kontrak, bukan karyawan dengan gaji tetap.
CONTRACT_TO_HIRE Pekerjaan ini ditawarkan sebagai posisi kontrak dengan pemahaman bahwa pekerjaan tersebut diubah menjadi posisi penuh waktu di akhir kontrak. Tugas jenis ini juga ditampilkan dengan penelusuran untuk EmploymentType.CONTRACTOR lowongan.
TEMPORARY Pekerjaan ditawarkan sebagai peluang kerja sementara, biasanya interaksi jangka pendek.
INTERN Pekerjaan ini adalah peluang jangka waktu tetap bagi siswa atau pencari kerja tingkat pemula untuk mendapatkan pelatihan kerja, biasanya ditawarkan sebagai posisi musim panas.
VOLUNTEER Ini adalah kesempatan bagi individu untuk menjadi sukarelawan, tanpa mengharapkan kompensasi untuk layanan yang diberikan.
PER_DIEM Pekerjaan itu mengharuskan seorang karyawan untuk bekerja sesuai kebutuhan dengan jadwal yang fleksibel.
FLY_IN_FLY_OUT Pekerjaan ini melibatkan mempekerjakan orang-orang di daerah terpencil dan menerbangkan mereka sementara ke lokasi kerja, alih-alih merelokasi karyawan dan keluarga mereka secara permanen.
OTHER_EMPLOYMENT_TYPE Pekerjaan tidak sesuai dengan jenis lain yang tercantum.

GetCompanyRequest

Permintaan untuk mendapatkan perusahaan berdasarkan nama.

Kolom
name

string

Wajib. Nama resource perusahaan yang akan diambil.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/Company/{company_id}", misalnya, "projects/api-test-project/tenants/foo/perusahaan/bar".

Jika ID tenant tidak ditentukan, tenant default akan digunakan, misalnya, "projects/api-test-project/Company/bar".

GetJobRequest

Mendapatkan permintaan tugas.

Kolom
name

string

Wajib. Nama resource tugas yang akan diambil.

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

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

GetTenantRequest

Permintaan untuk mendapatkan tenant berdasarkan nama.

Kolom
name

string

Wajib. Nama resource tenant yang akan diambil.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenants/bar".

HistogramQuery

Permintaan histogram.

Kolom
histogram_query

string

Ekspresi menentukan permintaan histogram terhadap resource yang cocok (misalnya, pekerjaan, profil) untuk penelusuran.

Lihat SearchJobsRequest.histogram_queries dan SearchProfilesRequest.histogram_queries untuk mengetahui detail sintaksis.

HistogramQueryResult

Hasil histogram yang cocok dengan HistogramQuery yang ditentukan dalam penelusuran.

Kolom
histogram_query

string

Ekspresi histogram yang diminta.

histogram

map<string, int64>

Peta dari nilai facet yang dikaitkan dengan nilai berbeda ke jumlah entri yang cocok dengan nilai yang sesuai.

Format utamanya adalah:

  • (untuk histogram string) nilai string yang disimpan di kolom.
  • (untuk bucket numerik bernama) nama yang ditentukan dalam fungsi bucket(), seperti untuk bucket(0, MAX, "non-negative"), kuncinya akan menjadi non-negative.
  • (untuk bucket numerik anonim) yang diformat sebagai <low>-<high>, misalnya, 0-1000, MIN-0, dan 0-MAX.

HtmlSanitization

Opsi untuk sanitasi konten HTML pada kolom input pengguna, misalnya, deskripsi pekerjaan. Dengan menyetel opsi ini, pengguna dapat menentukan apakah dan bagaimana sanitasi dilakukan di kolom tersebut.

Enum
HTML_SANITIZATION_UNSPECIFIED Nilai default.
HTML_SANITIZATION_DISABLED Menonaktifkan sanitasi pada input HTML.
SIMPLE_FORMATTING_ONLY Membersihkan input HTML, hanya menerima tag markup daftar yang dicetak tebal, miring, diurutkan, dan tidak diurutkan.

Tugas

Sumber daya pekerjaan mewakili sebuah postingan pekerjaan (juga disebut sebagai "listingan pekerjaan" atau "permintaan pekerjaan"). Lowongan merupakan bagian dari Company, yang merupakan entitas perekrutan yang bertanggung jawab atas pekerjaan tersebut.

Kolom
name

string

Diperlukan selama info terbaru tugas.

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

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/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 requisition_id karena nilai ini unik.

company

string

Wajib. Nama resource perusahaan yang mencantumkan lowongan.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/company/{company_id}". Misalnya, "projects/foo/tenants/bar/company/baz".

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

requisition_id

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, language_code, dan requisition_id yang sama.

Jumlah karakter maksimal yang diizinkan adalah 255.

title

string

Wajib. Nama pekerjaan, seperti "Software Engineer"

Jumlah karakter maksimal yang diizinkan adalah 500.

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.

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 requisition_id unik (misalnya 'ReqA' menjadi 'ReqA-1', 'ReqA-2', dan seterusnya.) karena beberapa tugas dengan company, language_code, dan requisition_id yang sama tidak diizinkan. Jika requisition_id 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.

application_info

ApplicationInfo

Informasi lamaran pekerjaan.

job_benefits[]

JobBenefit

Manfaat yang disertakan dengan pekerjaan.

compensation_info

CompensationInfo

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

custom_attributes

map<string, 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 string_values yang dapat difilter, di semua kunci maksimal 200 nilai diizinkan, dengan setiap string tidak lebih dari 255 karakter. Untuk string_values yang tidak dapat difilter, ukuran total maksimum string_values di semua kunci adalah 50 KB.

degree_types[]

DegreeType

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

department

string

Departemen atau area fungsional dalam perusahaan dengan posisi yang lowong.

Jumlah karakter maksimal yang diizinkan adalah 255.

employment_types[]

EmploymentType

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

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.

language_code

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_level

JobLevel

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

promotion_value

int32

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.

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.

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.

posting_region

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.

visibility
(deprecated)

Visibility

Tidak digunakan lagi. Pekerjaan hanya dapat dilihat oleh pemilik.

Visibilitas pekerjaan.

Jika tidak ditentukan, defaultnya adalah Visibility.ACCOUNT_ONLY.

job_start_time

Timestamp

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

job_end_time

Timestamp

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

posting_publish_time

Timestamp

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

posting_expire_time

Timestamp

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 ListJobs API, tetapi dapat diambil dengan GetJob API atau diperbarui dengan UpdateJob API atau dihapus dengan DeleteJob 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, language_code, dan requisition_id 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, posting_publish_time harus ditetapkan sebelum posting_expire_time. 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 job_end_time, 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.

posting_create_time

Timestamp

Hanya output. Stempel waktu saat postingan lowongan ini dibuat.

posting_update_time

Timestamp

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

company_display_name

string

Hanya output. Nama tampilan perusahaan yang mencantumkan lowongan.

derived_info

DerivedInfo

Hanya output. Memperoleh detail tentang postingan lowongan.

processing_options

ProcessingOptions

Opsi untuk pemrosesan tugas.

ApplicationInfo

Detail postingan lowongan yang terkait dengan lamaran.

Kolom
emails[]

string

Gunakan kolom ini untuk menentukan alamat email yang akan dikirimi resume atau lamaran.

Jumlah karakter maksimum yang diizinkan untuk setiap entri adalah 255.

instruction

string

Gunakan kolom ini untuk memberikan petunjuk, seperti "Kirim lamaran Anda ke ..." yang dapat diikuti kandidat untuk melamar pekerjaan.

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

uris[]

string

Gunakan kolom URI ini untuk mengarahkan pemohon ke situs, misalnya untuk menautkan ke formulir permohonan online.

Jumlah karakter maksimum yang diizinkan untuk setiap entri adalah 2.000.

DerivedInfo

Memperoleh detail tentang postingan lowongan.

Kolom
locations[]

Location

Lokasi terstruktur pekerjaan, diselesaikan dari Job.addresses.

locations sama persis dengan Job.addresses dalam urutan yang sama.

job_categories[]

JobCategory

Kategori lowongan berasal dari Job.title dan Job.description.

ProcessingOptions

Opsi untuk pemrosesan tugas.

Kolom
disable_street_address_resolution

bool

Jika disetel ke true, layanan tidak akan berupaya menentukan alamat yang lebih tepat untuk tugas tersebut.

html_sanitization

HtmlSanitization

Opsi untuk sanitasi konten HTML tugas. Kolom yang diterapkan adalah:

  • deskripsi
  • applicationInfo.instruction
  • insentif
  • kualifikasi
  • tanggung jawab

Tag HTML di kolom ini dapat dihapus jika sanitasi tidak dinonaktifkan.

Nilai defaultnya adalah HtmlSanitization.SIMPLE_FORMATTING_ONLY.

JobBenefit

Enum yang mewakili manfaat karyawan yang disertakan dengan pekerjaan tersebut.

Enum
JOB_BENEFIT_UNSPECIFIED Nilai default jika jenis tidak ditentukan.
CHILD_CARE Pekerjaan ini mencakup akses ke program yang mendukung penitipan anak, seperti penitipan anak.
DENTAL Pekerjaan tersebut mencakup layanan gigi yang ditanggung oleh program asuransi gigi.
DOMESTIC_PARTNER Pekerjaan ini menawarkan manfaat khusus kepada pasangan serumah.
FLEXIBLE_HOURS Pekerjaan ini memungkinkan jadwal kerja yang fleksibel.
MEDICAL Pekerjaan tersebut mencakup layanan kesehatan yang ditanggung oleh rencana asuransi medis.
LIFE_INSURANCE Pekerjaan tersebut mencakup paket asuransi jiwa yang disediakan oleh perusahaan atau dapat dibeli oleh karyawan.
PARENTAL_LEAVE Pekerjaan ini memungkinkan cuti bagi orang tua untuk merawat anak yang baru lahir.
RETIREMENT_PLAN Pekerjaan mencakup rencana pensiun di tempat kerja yang disediakan oleh pemberi kerja atau tersedia untuk dibeli oleh karyawan.
SICK_DAYS Pekerjaan tersebut memberi cuti berbayar karena sakit.
VACATION Pekerjaan tersebut mencakup cuti berbayar untuk liburan.
VISION Pekerjaan ini mencakup layanan penglihatan yang dicakup oleh rencana asuransi penglihatan.

JobCategory

Enum yang mewakili kategorisasi atau fokus utama dari peran tertentu. Nilai ini berbeda dengan "industri" yang dikaitkan dengan peran, yang terkait dengan kategorisasi perusahaan yang mencantumkan pekerjaan.

Enum
JOB_CATEGORY_UNSPECIFIED Nilai default jika kategori tidak ditentukan.
ACCOUNTING_AND_FINANCE Pekerjaan akuntansi dan keuangan, seperti Akuntan.
ADMINISTRATIVE_AND_OFFICE Pekerjaan administratif dan kantor, seperti Asisten Administrasi.
ADVERTISING_AND_MARKETING Pekerjaan periklanan dan pemasaran, seperti Manajer Pemasaran.
ANIMAL_CARE Pekerjaan perawatan hewan, seperti Dokter hewan.
ART_FASHION_AND_DESIGN Pekerjaan seni, mode, atau desain, misalnya Desainer.
BUSINESS_OPERATIONS Pekerjaan operasi bisnis, seperti Business Operations Manager.
CLEANING_AND_FACILITIES Pekerjaan pembersihan dan fasilitas, seperti Staf Kustodian.
COMPUTER_AND_IT Pekerjaan komputer dan IT, seperti Administrator Sistem.
CONSTRUCTION Pekerjaan konstruksi, seperti Pekerja Umum.
CUSTOMER_SERVICE Pekerjaan layanan pelanggan, seperti Kasir.
EDUCATION Pekerjaan pendidikan, seperti Guru Sekolah.
ENTERTAINMENT_AND_TRAVEL Pekerjaan hiburan dan perjalanan, seperti Pramugari Penerbangan.
FARMING_AND_OUTDOORS Pekerjaan pertanian atau kegiatan luar ruangan, seperti Park Ranger.
HEALTHCARE Pekerjaan terkait layanan kesehatan, seperti Perawat Terdaftar.
HUMAN_RESOURCES Pekerjaan di bidang sumber daya manusia, seperti Direktur Sumber Daya Manusia.
INSTALLATION_MAINTENANCE_AND_REPAIR Pekerjaan pemasangan, pemeliharaan, atau perbaikan, seperti teknisi listrik.
LEGAL Pekerjaan hukum, seperti Law Clerk.
MANAGEMENT Tugas manajemen, yang sering digunakan bersama dengan kategori lain, seperti Manajer Toko.
MANUFACTURING_AND_WAREHOUSE Pekerjaan manufaktur atau pergudangan, seperti Teknisi Assembly.
MEDIA_COMMUNICATIONS_AND_WRITING Pekerjaan media, komunikasi, atau penulisan, seperti Hubungan Media.
OIL_GAS_AND_MINING Pekerjaan minyak, gas, atau pertambangan, seperti Pengebor Lepas Pantai.
PERSONAL_CARE_AND_SERVICES Pekerjaan perawatan dan layanan pribadi, seperti Penata Rambut.
PROTECTIVE_SERVICES Pekerjaan layanan perlindungan, seperti Petugas Keamanan.
REAL_ESTATE Pekerjaan properti, seperti Agen Pembeli.
RESTAURANT_AND_HOSPITALITY Pekerjaan restoran dan pelayanan, seperti Pelayan Restoran.
SALES_AND_RETAIL Pekerjaan penjualan dan/atau retail, misalnya Rekanan Penjualan.
SCIENCE_AND_ENGINEERING Pekerjaan sains dan teknik, seperti Teknisi Lab.
SOCIAL_SERVICES_AND_NON_PROFIT Pekerjaan layanan sosial atau nonprofit, seperti Pekerja Kasus.
SPORTS_FITNESS_AND_RECREATION Pekerjaan olahraga, kebugaran, atau rekreasi, seperti Pelatih Pribadi.
TRANSPORTATION_AND_LOGISTICS Pekerjaan transportasi atau logistik, seperti Pengemudi Truk.

JobEvent

Peristiwa yang dikeluarkan saat pencari kerja berinteraksi dengan aplikasi yang menerapkan Cloud Talent Solution.

Kolom
type

JobEventType

Wajib. Jenis peristiwa (lihat JobEventType).

jobs[]

string

Wajib. job name(s) yang terkait dengan peristiwa ini. Misalnya, jika ini adalah peristiwa impression, kolom ini berisi ID semua pekerjaan yang ditampilkan kepada pencari kerja. Jika ini adalah peristiwa view, kolom ini berisi ID pekerjaan yang dilihat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", misalnya, "projects/foo/tenants/bar/jobs/baz".

profile

string

profile name yang terkait dengan peristiwa klien ini.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", misalnya, "projects/foo/tenants/bar/profiles/baz".

JobEventType

Enumerasi peristiwa yang dikaitkan dengan perilaku pengguna akhir, seperti pencari kerja.

Enum
JOB_EVENT_TYPE_UNSPECIFIED Peristiwa tidak ditentukan oleh nilai lain yang disediakan.
IMPRESSION Pencari kerja atau entitas lain yang berinteraksi dengan layanan telah mendapatkan tugas yang dirender dalam tampilannya, seperti dalam daftar hasil penelusuran dalam format terkompresi atau terpotong. Peristiwa ini biasanya terkait dengan melihat daftar pekerjaan di satu halaman oleh pencari kerja.
VIEW Pencari kerja, atau entitas lain yang berinteraksi dengan layanan, telah melihat detail pekerjaan, termasuk deskripsi lengkap. Peristiwa ini tidak berlaku untuk melihat cuplikan lowongan yang muncul sebagai bagian dari hasil penelusuran lowongan. Menampilkan cuplikan dikaitkan dengan impression).
VIEW_REDIRECT Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut melakukan tindakan untuk melihat pekerjaan dan diarahkan ke situs pekerjaan yang berbeda.
APPLICATION_START Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut memulai proses atau menunjukkan niat untuk melamar pekerjaan.
APPLICATION_FINISH Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut mengirimkan lamaran untuk pekerjaan.
APPLICATION_QUICK_SUBMISSION Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut mengirimkan lamaran untuk pekerjaan dengan sekali klik tanpa memasukkan informasi. Jika pencari kerja melakukan tindakan ini, kirim peristiwa ini saja ke layanan. Jangan kirim peristiwa JobEventType.APPLICATION_START atau JobEventType.APPLICATION_FINISH.
APPLICATION_REDIRECT Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut melakukan tindakan untuk melamar pekerjaan dan diarahkan ke situs yang berbeda untuk menyelesaikan lamaran.
APPLICATION_COMPANY_SUBMIT Acara ini sebaiknya digunakan saat perusahaan mengirimkan lamaran atas nama pencari kerja. Acara ini dimaksudkan untuk digunakan oleh agen penyedia tenaga kerja yang mencoba menempatkan kandidat.
BOOKMARK Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut menunjukkan minat pada suatu pekerjaan dengan mem-bookmark atau menyimpannya.
NOTIFICATION Pencari kerja atau entitas lain yang berinteraksi dengan layanan telah menerima notifikasi, seperti peringatan email atau notifikasi perangkat, berisi satu atau beberapa listingan pekerjaan yang dihasilkan oleh layanan.
HIRED Pencari kerja atau entitas lain yang berinteraksi dengan layanan tersebut dipekerjakan oleh entitas perekrutan (pemberi kerja). Kirimkan peristiwa ini hanya jika pencari kerja dipekerjakan melalui lamaran yang dimulai oleh penelusuran yang dilakukan melalui layanan Cloud Talent Solution.
SENT_CV Perekrut atau agen penyedia tenaga kerja mengirimkan lamaran atas nama kandidat setelah berinteraksi dengan layanan untuk mengidentifikasi postingan lowongan yang cocok.
INTERVIEW_GRANTED Entitas yang berinteraksi dengan layanan tersebut (misalnya, pencari kerja), diberikan wawancara awal oleh entitas perekrutan (pemberi kerja). Peristiwa ini hanya boleh dikirim jika pencari kerja telah mendapatkan izin untuk diwawancarai sebagai bagian dari lamaran yang dimulai dengan penelusuran yang dilakukan melalui / rekomendasi yang disediakan oleh layanan Cloud Talent Solution.

JobLevel

Enum yang mewakili tingkat pengalaman yang diperlukan untuk pekerjaan itu.

Enum
JOB_LEVEL_UNSPECIFIED Nilai default jika tingkat tidak ditentukan.
ENTRY_LEVEL Kontributor perorangan tingkat pemula, biasanya dengan pengalaman kurang dari 2 tahun dalam peran yang sama. Termasuk karyawan magang.
EXPERIENCED Kontributor perorangan yang berpengalaman, biasanya dengan pengalaman lebih dari 2 tahun dalam peran serupa.
MANAGER Entry- untuk manajer tingkat menengah yang bertanggung jawab untuk mengelola tim yang terdiri dari orang-orang.
DIRECTOR Manajer tingkat senior yang bertanggung jawab untuk mengelola tim manajer.
EXECUTIVE Manajer tingkat eksekutif dan di atasnya, termasuk posisi C-level.

JobOperationResult

Hasil dari JobService.BatchCreateJobs API atau JobService.BatchUpdateJobs API. Atribut ini digunakan untuk mengganti google.longrunning.Operation.response jika berhasil.

Kolom
job_results[]

JobResult

Daftar hasil mutasi tugas dari operasi mutasi batch. Atribut ini dapat berubah hingga status operasi FINISHED, FAILED, atau CANCELLED.

JobResult

Hasil mutasi tugas.

Kolom
job

Job

Di sini, Job hanya berisi informasi dasar termasuk name, company, language_code, dan requisition_id. Gunakan metode getJob untuk mengambil informasi mendetail dari tugas yang dibuat/diperbarui.

status

Status

Status pekerjaan yang diproses. Kolom ini diisi jika pemrosesan job gagal.

JobQuery

Kueri yang diperlukan untuk melakukan kueri penelusuran.

Kolom
query

string

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

Jumlah karakter maksimal yang diizinkan adalah 255.

query_language_code

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/{project_id}/tenants/{tenant_id}/company/{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.

location_filters[]

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.

job_categories[]

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.

commute_filter

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, location_filters akan diabaikan.

Saat ini kami tidak mendukung pengurutan berdasarkan waktu perjalanan.

company_display_names[]

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.

compensation_filter

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.

custom_attribute_filter

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

disable_spell_check

bool

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.

employment_types[]

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.

language_codes[]

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.

publish_time_range

TimestampRange

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

excluded_jobs[]

string

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

Jumlah maksimal nama pekerjaan yang dikecualikan adalah 400.

JobView

Enum yang menentukan atribut tugas yang ditampilkan di kolom MatchingJob.job atau ListJobsResponse.jobs.

Enum
JOB_VIEW_UNSPECIFIED Nilai default.
JOB_VIEW_ID_ONLY Tampilan khusus ID pekerjaan, dengan atribut berikut: Job.name, Job.requisition_id, Job.language_code.
JOB_VIEW_MINIMAL Tampilan minimal lowongan, dengan atribut berikut: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.language_code.
JOB_VIEW_SMALL Tampilan kecil dari lowongan, dengan atribut berikut dalam hasil penelusuran: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.visibility, Job.language_code, Job.description.
JOB_VIEW_FULL Semua atribut yang tersedia disertakan dalam hasil penelusuran.

ListCompaniesRequest

Cantumkan perusahaan yang kliennya memiliki visibilitas ACL.

Kolom
parent

string

Wajib. Nama resource tenant tempat perusahaan dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenant/bar".

Jika ID tenant tidak ditentukan, tenant default akan digunakan, misalnya, "projects/foo".

page_token

string

Indikator awal tempat untuk menampilkan hasil.

page_size

int32

Jumlah perusahaan maksimum yang akan dikembalikan, paling banyak 100. Defaultnya adalah 100 jika diberikan angka non-positif.

require_open_jobs

bool

Tetapkan ke true jika perusahaan yang diminta harus memiliki lowongan.

Nilai defaultnya adalah false (salah).

Jika benar, maksimal page_size perusahaan yang diambil, dan hanya perusahaan yang memiliki pekerjaan terbuka yang akan ditampilkan.

ListCompaniesResponse

Objek respons Perusahaan Daftar.

Kolom
companies[]

Company

Perusahaan untuk klien saat ini.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

metadata

ResponseMetadata

Informasi tambahan untuk pemanggilan API, seperti ID pelacakan permintaan.

ListJobsRequest

Mencantumkan permintaan tugas.

Kolom
parent

string

Wajib. Nama resource tenant tempat tugas dibuat.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

filter

string

Wajib. String filter menentukan tugas yang akan dienumerasi.

Operator yang didukung: =, AND

Kolom yang memenuhi syarat untuk pemfilteran adalah:

  • companyName (Wajib diisi)
  • requisitionId
  • status Nilai yang tersedia: OPEN, EXPIRED, ALL. Secara default ke OPEN jika tidak ada nilai yang ditentukan.

Contoh Kueri:

  • companyName = "projects/foo/tenants/bar/company/baz"
  • companyName = "projects/foo/tenants/bar/Company/baz" AND requisitionId = "req-1"
  • companyName = "projects/foo/tenants/bar/Companies/baz" AND status = "EXPIRED"
page_token

string

Titik awal dari hasil kueri.

page_size

int32

Jumlah maksimum tugas yang akan ditampilkan per halaman hasil.

Jika job_view ditetapkan ke JobView.JOB_VIEW_ID_ONLY, ukuran halaman maksimum yang diizinkan adalah 1.000. Jika tidak, ukuran halaman maksimum yang diizinkan adalah 100.

Defaultnya adalah 100 jika kosong atau angka < 1 ditentukan.

job_view

JobView

Atribut pekerjaan yang diinginkan yang ditampilkan untuk pekerjaan dalam respons penelusuran. Secara default ke JobView.JOB_VIEW_FULL jika tidak ada nilai yang ditentukan.

ListJobsResponse

Menampilkan daftar respons tugas.

Kolom
jobs[]

Job

Lowongan untuk perusahaan tertentu.

Jumlah maksimum item yang ditampilkan didasarkan pada kolom batas yang disediakan dalam permintaan.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

metadata

ResponseMetadata

Informasi tambahan untuk pemanggilan API, seperti ID pelacakan permintaan.

ListTenantsRequest

Mencantumkan tenant yang kliennya memiliki visibilitas ACL.

Kolom
parent

string

Wajib. Nama resource project tempat tenant dibuat.

Formatnya adalah "projects/{project_id}", misalnya, "projects/foo".

page_token

string

Indikator awal tempat untuk menampilkan hasil.

page_size

int32

Jumlah tenant maksimum yang akan ditampilkan, maksimal 100. Defaultnya adalah 100 jika diberikan angka non-positif.

ListTenantsResponse

Objek respons tenant Daftar.

Kolom
tenants[]

Tenant

Tenant untuk klien saat ini.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya.

metadata

ResponseMetadata

Informasi tambahan untuk pemanggilan API, seperti ID pelacakan permintaan.

Lokasi

Resource yang mewakili lokasi dengan informasi geografis lengkap.

Kolom
location_type

LocationType

Jenis lokasi, yang sesuai dengan kolom baris alamat google.type.PostalAddress. Misalnya, "Downtown, Atlanta, GA, USA" memiliki jenis LocationType.NEIGHBORHOOD, dan "Kansas City, KS, USA" memiliki jenis LocationType.LOCALITY.

postal_address

PostalAddress

Alamat pos lokasi yang menyertakan informasi yang dapat dibaca manusia, seperti alamat pos dan alamat pembayaran. Berdasarkan alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau lokasi pengiriman lainnya.

lat_lng

LatLng

Objek yang mewakili pasangan garis lintang/garis bujur.

radius_miles

double

Radius dalam mil dari lokasi pekerjaan. Nilai ini berasal dari kotak pembatas lokasi, tempat lingkaran dengan radius yang ditentukan yang berpusat dari google.type.LatLng mencakup area yang terkait dengan lokasi pekerjaan. Misalnya, saat ini, " Mountain View, CA, USA" memiliki radius 6,17 mil.

LocationType

Enum yang mewakili jenis lokasi.

Enum
LOCATION_TYPE_UNSPECIFIED Nilai default jika jenis tidak ditentukan.
COUNTRY Lokasi tingkat negara.
ADMINISTRATIVE_AREA Negara bagian atau lokasi tingkat yang setara.
SUB_ADMINISTRATIVE_AREA Lokasi tingkat county atau yang setara.
LOCALITY Kota atau lokasi di tingkat yang setara.
POSTAL_CODE Lokasi tingkat kode pos.
SUB_LOCALITY Sublokalitas adalah subdivisi lokalitas, misalnya kota kecil, wilayah, atau arondisemen. Sublokalitas biasanya diakui oleh otoritas politik setempat. Misalnya, Manhattan dan Brooklyn diakui sebagai kota besar oleh Kota New York, dan karenanya dimodelkan sebagai sublokalitas.
SUB_LOCALITY_1 Lokasi tingkat distrik atau yang setara.
SUB_LOCALITY_2 Tampilan tingkat distrik yang lebih kecil atau yang setara.
NEIGHBORHOOD Lokasi tingkat lingkungan.
STREET_ADDRESS Lokasi tingkat alamat.

LocationFilter

Wilayah geografis penelusuran.

Kolom
address

string

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

region_code

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.

lat_lng

LatLng

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

distance_in_miles

double

Jarak_in_miles diterapkan saat 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.

telecommute_preference

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 lat_lng 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

bool

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.

PostingRegion

Enum yang mewakili wilayah postingan lowongan. Pada umumnya, lowongan pekerjaan tidak perlu menyebutkan wilayah. Jika suatu wilayah diberikan, lowongan akan memenuhi syarat untuk penelusuran di wilayah tersebut.

Enum
POSTING_REGION_UNSPECIFIED Jika region tidak ditentukan, tugas hanya akan ditampilkan jika cocok dengan LocationFilter.
ADMINISTRATIVE_AREA

Selain pencocokan lokasi persis, postingan lowongan ditampilkan jika LocationFilter dalam kueri penelusuran berada di wilayah administratif yang sama dengan postingan lowongan yang ditampilkan. Misalnya, jika lowongan ADMINISTRATIVE_AREA diposting di "CA, USA", lowongan tersebut akan ditampilkan jika LocationFilter memiliki "Mountain View".

Wilayah administratif mengacu pada subdivisi administratif tingkat teratas negara ini. Misalnya, negara bagian AS, wilayah IT, negara konstituen Inggris Raya, dan prefektur Jepang.

NATION Selain pencocokan lokasi persis, lowongan ditampilkan jika LocationFilter dalam kueri penelusuran berada di negara yang sama dengan lowongan ini. Misalnya, jika lowongan NATION_WIDE diposting di "USA", lowongan tersebut akan ditampilkan jika LocationFilter memiliki 'Gunung View'.
TELECOMMUTE Pekerjaan memungkinkan karyawan bekerja dari jarak jauh (dari jarak jauh). Jika lokasi diberikan dengan nilai ini, pekerjaan dianggap memiliki lokasi, tetapi kerja jarak jauh diizinkan.

RequestMetadata

Informasi meta yang berkaitan dengan penelusur lowongan atau entitas yang melakukan penelusuran lowongan. Informasi ini digunakan untuk meningkatkan performa layanan.

Kolom
domain

string

Wajib jika allow_missing_ids tidak disetel atau false.

Cakupan atau sumber panggilan layanan yang ditentukan klien, yang biasanya merupakan domain tempat layanan telah diimplementasikan dan saat ini sedang dijalankan.

Misalnya, jika layanan dijalankan oleh klien Foo, Inc., di papan lowongan kerja www.foo.com dan situs karier www.bar.com, kolom ini disetel ke "foo.com" untuk digunakan pada papan lowongan kerja, dan "bar.com" untuk digunakan di situs karier.

Perlu diperhatikan bahwa setiap peningkatan pada model untuk situs tenant tertentu bergantung pada kolom ini yang disetel dengan benar ke domain unik.

Jumlah karakter maksimal yang diizinkan adalah 255.

session_id

string

Wajib jika allow_missing_ids tidak disetel atau false.

String identifikasi sesi unik. Sesi didefinisikan sebagai durasi interaksi pengguna akhir dengan layanan selama jangka waktu tertentu. Hapus kolom ini untuk masalah privasi sebelum memberikannya ke layanan.

Perlu diperhatikan bahwa setiap peningkatan pada model untuk situs tenant tertentu bergantung pada kolom ini yang disetel dengan benar ke ID sesi yang unik.

Jumlah karakter maksimal yang diizinkan adalah 255.

user_id

string

Wajib jika allow_missing_ids tidak disetel atau false.

String identifikasi pengguna unik, seperti yang ditentukan oleh klien. Untuk mendapatkan dampak positif yang kuat pada kualitas penelusuran, pastikan tingkat klien bersifat unik. Hapus kolom ini untuk masalah privasi sebelum memberikannya ke layanan.

Perhatikan bahwa setiap peningkatan pada model untuk situs tenant tertentu bergantung pada kolom ini yang disetel dengan benar ke ID pengguna unik.

Jumlah karakter maksimal yang diizinkan adalah 255.

allow_missing_ids

bool

Hanya disetel jika salah satu dari domain, session_id, dan user_id tidak tersedia karena alasan tertentu. Sebaiknya jangan tetapkan kolom ini dan berikan domain, session_id, dan user_id yang akurat untuk pengalaman layanan terbaik.

device_info

DeviceInfo

Jenis perangkat yang digunakan oleh pencari kerja pada saat panggilan ke layanan.

ResponseMetadata

Informasi tambahan yang ditampilkan ke klien, seperti informasi proses debug.

Kolom
request_id

string

ID unik yang terkait dengan panggilan ini. ID ini dicatat untuk tujuan pelacakan.

SearchJobsRequest

Isi Permintaan panggilan SearchJobs.

Kolom
parent

string

Wajib. Nama resource tenant yang akan ditelusuri.

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}". Misalnya, "projects/foo/tenant/bar". Jika ID tenant tidak ditentukan, tenant default akan dibuat. Misalnya, "projects/foo".

search_mode

SearchMode

Mode penelusuran.

Nilai defaultnya adalah SearchMode.JOB_SEARCH.

request_metadata

RequestMetadata

Wajib. Informasi meta yang dikumpulkan tentang pencari kerja, digunakan untuk meningkatkan kualitas pencarian layanan. ID (seperti user_id) disediakan oleh pengguna, dan harus unik serta konsisten.

job_query

JobQuery

Kueri yang digunakan untuk menelusuri tugas, seperti kata kunci, filter lokasi, dll.

enable_broadening

bool

Mengontrol apakah akan memperluas penelusuran saat memberikan hasil yang jarang. Kueri yang diperluas akan menambahkan hasil ke bagian akhir daftar hasil yang cocok.

Nilai defaultnya adalah false (salah).

require_precise_result_size
(deprecated)

bool

Kolom ini tidak digunakan lagi.

histogram_queries[]

HistogramQuery

Ekspresi menentukan permintaan histogram terhadap tugas yang cocok.

Sintaksis ekspresi adalah panggilan fungsi agregasi dengan faset histogram dan opsi lainnya.

Panggilan fungsi agregasi yang tersedia adalah: * count(string_histogram_facet): Menghitung jumlah entity yang cocok, untuk setiap nilai atribut yang berbeda. * count(numeric_histogram_facet, list of buckets): Menghitung jumlah entity yang cocok dalam setiap bucket.

Tipe data ({i>Data types<i}):

  • Faset histogram: nama facet dengan format [a-zA-Z][a-zA-Z0-9_]+.
  • String: string seperti "string apa pun dengan escape untuk garis miring terbalik untuk tanda petik(")."
  • Bilangan: bilangan bulat dan bilangan floating point seperti 10, -1, dan -0,01.
  • Daftar: daftar elemen dengan pemisah koma(,) yang diapit tanda kurung siku, misalnya, [1, 2, 3] dan ["one", "two", "three"].

Konstanta bawaan:

  • MIN (jumlah minimum mirip dengan java Double.MIN_VALUE)
  • MAX (jumlah maksimum mirip dengan java Double.MAX_VALUE)

Fungsi bawaan:

  • bucket(start, end[, label]): fungsi bawaan bucket membuat bucket dengan rentang [start, end). Perhatikan bahwa bagian akhir bersifat eksklusif, misalnya, bucket(1, MAX, "angka positif") atau bucket(1, 10).

Faset histogram pekerjaan:

  • company_display_name: histogram sebesar Job.company_display_name.
  • Job_type: histogram menurut Job.employment_types, misalnya, "FULL_TIME", "PART_TIME".
  • company_size: histogram sebesar CompanySize, misalnya, "Small", "MEDIUM", "BIG".
  • publish_time_in_month: histogram sebesar Job.posting_publish_time dalam bulan. Harus menentukan daftar bucket numerik dalam spesifikasi.
  • publish_time_in_year: histogram dengan Job.posting_publish_time dalam tahun. Harus menentukan daftar bucket numerik dalam spesifikasi.
  • gelar_types: histogram menurut Job.degree_types, misalnya, "Sarjana", "Master".
  • job_level: histogram menurut Job.job_level, misalnya, "Entry Level".
  • country: histogram menurut kode negara tempat bekerja, misalnya, "US", "FR".
  • admin1: histogram oleh kode pekerjaan admin1, yang merupakan placeholder global yang mengacu pada negara bagian, provinsi, atau istilah tertentu yang digunakan suatu negara untuk menentukan struktur geografis di bawah tingkat negara, misalnya, "CA", "IL".
  • city: histogram dengan kombinasi "nama kota, kode admin1". Misalnya, "Gunung View, CA", "New York, NY".
  • admin1_country: histogram dengan kombinasi "kode admin1, negara", misalnya, "CA, US", "IL, US".
  • city_Coordinate: histogram menurut koordinat GPS pusat kota (lintang dan bujur), misalnya, 37.4038522,-122.0987765. Karena koordinat pusat kota dapat berubah, pelanggan mungkin perlu memperbaruinya secara berkala.
  • lokalitas: histogram menurut Job.language_code, misalnya, "en-US", "fr-FR".
  • language: histogram menurut subtag bahasa Job.language_code, misalnya, "en", "fr".
  • kategori: histogram dengan JobCategory, misalnya, "COMPUTER_AND_IT", "HEALTHCARE".
  • base_compensation_unit: histogram berdasarkan CompensationInfo.CompensationUnit gaji pokok, misalnya, "WEEKLY", "BULANAN".
  • base_compensation: histogram berdasarkan gaji pokok. Harus menentukan daftar bucket numerik sebagai dasar pengelompokan hasil.
  • tahunan_base_compensation: histogram berdasarkan gaji pokok tahunan. Harus menentukan daftar bucket numerik sebagai dasar pengelompokan hasil.
  • tahunan_total_compensation: histogram dengan total gaji tahunan. Harus menentukan daftar bucket numerik sebagai dasar pengelompokan hasil.
  • string_custom_attribute: histogram menurut string Job.custom_attributes. Nilai dapat diakses melalui notasi tanda kurung siku seperti string_custom_attribute["key1"].
  • numerik_custom_attribute: histogram dengan Job.custom_attributes numerik. Nilai dapat diakses melalui notasi tanda kurung siku seperti numerik_custom_attribute["key1"]. Harus menentukan daftar bucket numerik sebagai dasar pengelompokan hasil.

Contoh ekspresi:

  • count(admin1)
  • count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])
  • count(string_custom_attribute["some-string-custom-attribute"])
  • count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
job_view

JobView

Atribut pekerjaan yang diinginkan yang ditampilkan untuk pekerjaan dalam respons penelusuran. Secara default ke JobView.JOB_VIEW_SMALL jika tidak ada nilai yang ditentukan.

offset

int32

Bilangan bulat yang menentukan offset saat ini (yaitu, lokasi hasil awal, di antara tugas yang dianggap relevan oleh API) di hasil penelusuran. Kolom ini hanya dipertimbangkan jika page_token tidak disetel.

Nilai maksimum yang diizinkan adalah 5.000. Jika tidak, error akan ditampilkan.

Misalnya, 0 berarti mengembalikan hasil yang dimulai dari pekerjaan pertama yang cocok, dan 10 berarti kembali dari pekerjaan ke-11. Ini dapat digunakan untuk penomoran halaman, (misalnya, pageSize = 10 dan offset = 10 berarti kembali dari halaman kedua).

page_size

int32

Batasan jumlah tugas yang ditampilkan dalam hasil penelusuran. Meningkatkan nilai ini di atas nilai default 10 dapat memperpanjang waktu respons penelusuran. Nilainya dapat antara 1 dan 100.

page_token

string

Token yang menentukan offset saat ini dalam hasil penelusuran. Lihat SearchJobsResponse.next_page_token untuk penjelasan tentang cara mendapatkan kumpulan hasil kueri berikutnya.

order_by

string

Kriteria yang menentukan bagaimana hasil penelusuran diurutkan. Default-nya adalah "relevance desc".

Opsi yang didukung adalah:

  • "relevance desc": Dengan relevansi menurun, seperti yang ditentukan oleh algoritma API. Nilai minimum relevansi hasil kueri hanya tersedia dengan pengurutan ini.
  • "posting_publish_time desc": Dengan Job.posting_publish_time menurun.
  • "posting_update_time desc": Dengan Job.posting_update_time menurun.
  • "title": Dengan Job.title menaik.
  • "title desc": Dengan Job.title menurun.
  • "annualized_base_compensation": Dengan CompensationInfo.annualized_base_compensation_range tugas yang diurutkan naik. Tugas yang kompensasi dasar tahunannya tidak ditentukan akan ditempatkan di akhir hasil penelusuran.
  • "annualized_base_compensation desc": Dengan nilai CompensationInfo.annualized_base_compensation_range tugas yang menurun. Tugas yang kompensasi dasar tahunannya tidak ditentukan akan ditempatkan di akhir hasil penelusuran.
  • "annualized_total_compensation": Dengan CompensationInfo.annualized_total_compensation_range tugas yang diurutkan naik. Tugas yang kompensasi dasar tahunannya tidak ditentukan akan ditempatkan di akhir hasil penelusuran.
  • "annualized_total_compensation desc": Dengan nilai CompensationInfo.annualized_total_compensation_range tugas yang menurun. Tugas yang kompensasi dasar tahunannya tidak ditentukan akan ditempatkan di akhir hasil penelusuran.
  • "custom_ranking desc": Berdasarkan skor relevansi yang disesuaikan dengan SearchJobsRequest.CustomRankingInfo.ranking_expression dengan faktor bobot yang ditetapkan oleh SearchJobsRequest.CustomRankingInfo.importance_level dalam urutan menurun.
  • Pengurutan lokasi: Gunakan sintaksis khusus untuk mengurutkan tugas berdasarkan jarak:
    "distance_from('Hawaii')": Mengurutkan berdasarkan jarak dari Hawaii.
    "distance_from(19.89, 155.5)": Mengurutkan berdasarkan jarak dari koordinat.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": Memesan menurut beberapa lokasi. Lihat detail di bawah.
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": Memesan menurut beberapa lokasi. Lihat detail di bawah.
    String dapat memiliki maksimum 256 karakter. Jika ada beberapa pusat jarak jauh, pekerjaan yang dekat dengan pusat jarak mana pun akan memiliki peringkat yang tinggi. Jika pekerjaan memiliki beberapa lokasi, lokasi pekerjaan yang paling dekat dengan salah satu pusat jarak akan digunakan. Pekerjaan yang tidak memiliki lokasi akan diberi peringkat di bagian bawah. Jarak dihitung dengan presisi 11,3 meter (37,4 kaki). Strategi diversifikasi masih diterapkan kecuali jika dinonaktifkan secara eksplisit di diversification_level.
diversification_level

DiversificationLevel

Mengontrol apakah pekerjaan yang sangat mirip ditampilkan berdampingan dalam hasil penelusuran. Pekerjaan diidentifikasi sebagai sangat mirip berdasarkan jabatan, kategori pekerjaan, dan lokasi mereka. Hasil yang sangat mirip dikelompokkan sehingga hanya satu tugas representatif dari cluster yang ditampilkan kepada pencari kerja yang lebih tinggi dalam hasil tersebut, sedangkan tugas lainnya ditampilkan lebih rendah dalam hasil tersebut.

Secara default ke DiversificationLevel.SIMPLE jika tidak ada nilai yang ditentukan.

custom_ranking_info

CustomRankingInfo

Mengontrol peringkat dokumen tugas berdasarkan skor relevansi yang ada (ditentukan oleh algoritma API).

disable_keyword_match

bool

Mengontrol apakah akan menonaktifkan pencocokan kata kunci persis pada Job.title, Job.description, Job.company_display_name, Job.addresses, Job.qualifications. Jika penonaktifan pencocokan kata kunci dinonaktifkan, pencocokan kata kunci akan menampilkan lowongan yang tidak cocok dengan filter kategori tertentu saat ada kata kunci yang cocok. Misalnya, untuk kueri “manajer program”, hasil akan ditampilkan meskipun postingan lowongan diberi judul “developer software", yang tidak termasuk dalam ontologi “manajer program”, tetapi justru mencantumkan “manajer program” di deskripsinya.

Untuk kueri seperti "cloud" yang tidak berisi ontologi khusus judul atau lokasi, tugas dengan kecocokan kata kunci "cloud" akan ditampilkan, terlepas dari nilai tanda ini.

Gunakan Company.keyword_searchable_job_custom_attributes jika nilai kolom kustom/string atribut khusus perusahaan yang cocok secara global diperlukan. Mengaktifkan pencocokan kata kunci akan meningkatkan ingatan permintaan penelusuran berikutnya.

Nilai defaultnya adalah false (salah).

CustomRankingInfo

Informasi peringkat kustom untuk SearchJobsRequest.

Kolom
importance_level

ImportanceLevel

Wajib. Mengontrol seberapa penting skor CustomRankingInfo.ranking_expression diterapkan ke posisi peringkat akhir pekerjaan.

Error akan ditampilkan jika tidak ditentukan.

ranking_expression

string

Wajib. Mengontrol peringkat dokumen tugas berdasarkan skor relevansi yang ada (ditentukan oleh algoritma API). Kombinasi ekspresi peringkat dan skor relevansi digunakan untuk menentukan posisi peringkat akhir pekerjaan.

Sintaksis untuk ekspresi ini adalah bagian dari sintaksis SQL Google.

Operator yang didukung adalah: +, -, *, /, dengan sisi kiri dan kanan operator berupa kunci Job.custom_attributes numerik, nilai bilangan bulat/ganda, atau ekspresi yang dapat dievaluasi menjadi angka.

Tanda kurung didukung untuk menyesuaikan prioritas penghitungan. Panjang ekspresi harus kurang dari 100 karakter.

Ekspresi ini dianggap tidak valid untuk suatu tugas jika ekspresi tersebut merujuk ke atribut khusus yang tidak diisi pada tugas atau jika ekspresi menghasilkan pembagian dengan nol. Jika ekspresi tidak valid untuk suatu tugas, pekerjaan tersebut akan didemosikan ke akhir hasil.

Contoh ekspresi peringkat (tahun + 25) * 0,25 - (keaktualan / 0,5)

ImportanceLevel

Tingkat kepentingan untuk CustomRankingInfo.ranking_expression.

Enum
IMPORTANCE_LEVEL_UNSPECIFIED Nilai default jika tingkat kepentingan tidak ditentukan.
NONE Ekspresi peringkat yang ditentukan tidak memiliki nilai penting, skor relevansi yang ada (ditentukan oleh algoritma API) mendominasi posisi peringkat akhir pekerjaan.
LOW Ekspresi peringkat yang diberikan memiliki kepentingan Rendah dalam hal posisi peringkat akhir pekerjaan dibandingkan dengan skor relevansi yang ada (ditentukan oleh algoritma API).
MILD Ekspresi peringkat yang diberikan kurang penting dalam hal posisi peringkat akhir pekerjaan dibandingkan dengan skor relevansi yang ada (ditentukan oleh algoritma API).
MEDIUM Ekspresi peringkat yang diberikan memiliki kepentingan Sedang dalam hal posisi peringkat akhir pekerjaan dibandingkan dengan skor relevansi yang ada (ditentukan oleh algoritma API).
HIGH Ekspresi peringkat yang diberikan sangat penting dalam hal posisi peringkat akhir pekerjaan dibandingkan dengan skor relevansi yang ada (ditentukan oleh algoritma API).
EXTREME Ekspresi peringkat yang diberikan sangat penting, dan mendominasi posisi peringkat akhir pekerjaan dengan skor relevansi yang ada (ditentukan oleh algoritma API) diabaikan.

DiversificationLevel

Mengontrol apakah pekerjaan yang sangat mirip ditampilkan berdampingan dalam hasil penelusuran. Pekerjaan diidentifikasi sebagai sangat mirip berdasarkan jabatan, kategori pekerjaan, dan lokasi mereka. Hasil yang sangat mirip dikelompokkan sehingga hanya satu tugas representatif dari cluster yang ditampilkan kepada pencari kerja yang lebih tinggi dalam hasil tersebut, sedangkan tugas lainnya ditampilkan lebih rendah dalam hasil tersebut.

Enum
DIVERSIFICATION_LEVEL_UNSPECIFIED Tingkat diversifikasi tidak ditentukan.
DISABLED Menonaktifkan diversifikasi. Pekerjaan yang biasanya akan didorong ke halaman terakhir tidak akan diubah posisinya. Hal ini dapat mengakibatkan lowongan yang sangat mirip muncul secara berurutan dalam hasil penelusuran.
SIMPLE Perilaku diversifikasi default. Daftar hasil diurutkan sehingga hasil yang sangat mirip didorong ke akhir halaman terakhir hasil penelusuran. Jika Anda menggunakan pageToken untuk menjelajahi hasil yang ditetapkan, latensi mungkin lebih rendah, tetapi kami tidak dapat menjamin bahwa semua hasil ditampilkan. Jika Anda menggunakan offset halaman, latensi mungkin lebih tinggi tetapi semua hasil ditampilkan.

SearchMode

Enumerasi yang diwakili string dari mode penelusuran lowongan. Layanan beroperasi secara berbeda untuk mode layanan yang berbeda.

Enum
SEARCH_MODE_UNSPECIFIED Mode metode penelusuran tidak ditetapkan. Perilaku penelusuran default sama dengan perilaku penelusuran Job_SEARCH.

SearchJobsResponse

Respons untuk metode SearchJob.

Kolom
matching_jobs[]

MatchingJob

Entitas Lowongan yang cocok dengan SearchJobsRequest yang ditentukan.

histogram_query_results[]

HistogramQueryResult

Hasil histogram yang cocok dengan SearchJobsRequest.histogram_queries tertentu.

next_page_token

string

Token yang menentukan posisi awal halaman hasil berikutnya. Kolom ini kosong jika tidak ada hasil lagi.

location_filters[]

Location

Lokasi memfilter yang diterapkan layanan ke kueri yang ditentukan. Jika ada filter yang berbasis lat-lng, Location.location_type adalah Location.LocationType.LOCATION_TYPE_UNSPECIFIED.

estimated_total_size

int32

Estimasi jumlah tugas yang cocok dengan kueri yang ditentukan.

Jumlah ini tidak dijamin akurat. Untuk mendapatkan hasil yang akurat, lihat SearchJobsResponse.total_size.

total_size

int32

Hasil yang akurat dihitung dengan batas 100.000.

metadata

ResponseMetadata

Informasi tambahan untuk pemanggilan API, seperti ID pelacakan permintaan.

broadened_query_jobs_count

int32

Jika perluasan kueri diaktifkan, kami dapat menambahkan hasil tambahan dari kueri yang diperluas. Angka ini menunjukkan berapa banyak pekerjaan yang ditampilkan dalam bidang pekerjaan yang berasal dari kueri yang diperluas. Hasil ini selalu berada di akhir daftar pekerjaan. Khususnya, nilai 0, atau jika kolom tidak ditetapkan, semua tugas dalam daftar tugas berasal dari kueri asli (tanpa perluasan). Jika kolom ini bukan nol, permintaan berikutnya dengan offset setelah kumpulan hasil ini akan berisi semua hasil yang diperluas.

spell_correction

SpellingCorrection

Hasil pemeriksaan ejaan, dan koreksi.

CommuteInfo

Detail perjalanan yang terkait dengan lowongan ini.

Kolom
job_location

Location

Lokasi digunakan sebagai tujuan dalam perhitungan perjalanan.

travel_duration

Duration

Jumlah detik yang diperlukan untuk mencapai lokasi pekerjaan dari lokasi kueri. Durasi 0 detik menunjukkan bahwa tugas tidak dapat dijangkau dalam durasi yang diminta, tetapi ditampilkan sebagai bagian dari kueri yang diperluas.

MatchingJob

Entri pekerjaan dengan metadata di dalam SearchJobsResponse.

Kolom
job

Job

Resource lowongan yang cocok dengan SearchJobsRequest yang ditentukan.

job_summary

string

Ringkasan pekerjaan dengan informasi inti yang ditampilkan di halaman listingan hasil penelusuran.

job_title_snippet

string

Berisi cuplikan teks dari kolom Job.title yang paling cocok dengan kata kunci kueri penelusuran, jika tersedia. Kata kunci kueri yang cocok diapit oleh tag tebal HTML.

search_text_snippet

string

Berisi cuplikan teks dari Job.description dan kolom serupa yang paling cocok dengan kata kunci kueri penelusuran, jika tersedia. Semua tag HTML di kolom asli akan dihilangkan saat ditampilkan dalam kolom ini, dan kata kunci kueri yang cocok diapit oleh tag tebal HTML.

commute_info

CommuteInfo

Informasi perjalanan yang dibuat berdasarkan CommuteFilter yang ditentukan.

SpellingCorrection

Hasil periksa ejaan.

Kolom
corrected

bool

Menunjukkan apakah kueri sudah diperbaiki oleh pemeriksa ejaan.

corrected_text

string

Output koreksi yang terdiri dari string kata kunci yang dikoreksi.

corrected_html

string

Output yang diperbaiki dengan tag html untuk menyoroti kata yang dikoreksi. Kata yang diperbaiki disebut dengan tag html "...".

Misalnya, kueri input pengguna adalah "software enginear", dengan kata kedua, "enginear", salah. Posisinya harus "insinyur". Saat koreksi ejaan diaktifkan, nilai ini adalah "software engineer".

Tenant

Resource Tenant mewakili tenant dalam layanan. Penyewa adalah grup atau entitas yang berbagi akses bersama dengan hak istimewa tertentu untuk resource seperti profil. Pelanggan dapat membuat beberapa tenant untuk menyediakan isolasi data bagi grup yang berbeda.

Kolom
name

string

Wajib selama update tenant.

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

Formatnya adalah "projects/{project_id}/tenants/{tenant_id}", misalnya, "projects/foo/tenants/bar".

external_id

string

Wajib. ID tenant sisi klien, digunakan untuk mengidentifikasi tenant secara unik.

Jumlah karakter maksimal yang diizinkan adalah 255.

usage_type

DataUsageType

Menunjukkan apakah data yang dimiliki penyewa ini dapat digunakan untuk menyediakan peningkatan produk di penyewa lain.

Perilaku defaultnya adalah DataUsageType.ISOLATED jika tidak disetel.

keyword_searchable_profile_custom_attributes[]

string

Daftar kunci Profile.custom_attributes yang dapat difilter, yang string_values yang sesuai digunakan dalam penelusuran kata kunci. Profil dengan string_values dalam kunci kolom yang ditentukan ini akan ditampilkan jika ada nilai yang cocok dengan kata kunci penelusuran. Nilai kolom kustom dengan tanda kurung, tanda kurung siku, dan simbol khusus tidak dapat ditelusuri sebagaimana adanya, dan harus diapit tanda kutip.

DataUsageType

Enum yang mewakili penggunaan data pengguna yang dimiliki oleh tenant.

Enum
DATA_USAGE_TYPE_UNSPECIFIED Nilai default.
AGGREGATED Data yang dimiliki oleh tenant ini digunakan untuk meningkatkan kualitas penelusuran/rekomendasi di seluruh tenant.
ISOLATED Data yang dimiliki oleh tenant ini digunakan untuk meningkatkan kualitas penelusuran/rekomendasi hanya untuk tenant ini.

TimestampRange

Pesan yang merepresentasikan periode waktu antara dua stempel waktu.

Kolom
start_time

Timestamp

Awal periode (inklusif).

end_time

Timestamp

Akhir periode (eksklusif).

UpdateCompanyRequest

Permintaan untuk memperbarui perusahaan tertentu.

Kolom
company

Company

Wajib. Resource perusahaan untuk menggantikan resource saat ini dalam sistem.

update_mask

FieldMask

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Jika update_mask diberikan, hanya kolom yang ditentukan di company yang akan diperbarui. Jika tidak, semua kolom akan diperbarui.

Mask kolom untuk menentukan kolom perusahaan yang akan diperbarui. Hanya kolom tingkat atas Company yang didukung.

UpdateJobRequest

Perbarui permintaan tugas.

Kolom
job

Job

Wajib. Pekerjaan yang akan diperbarui.

update_mask

FieldMask

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Jika update_mask 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.

UpdateTenantRequest

Permintaan untuk memperbarui tenant yang ditentukan.

Kolom
tenant

Tenant

Wajib. Resource tenant untuk mengganti resource saat ini dalam sistem.

update_mask

FieldMask

Sangat direkomendasikan untuk pengalaman layanan terbaik.

Jika update_mask diberikan, hanya kolom yang ditentukan di tenant yang akan diperbarui. Jika tidak, semua kolom akan diperbarui.

Mask kolom untuk menentukan kolom tenant yang akan diperbarui. Hanya kolom tingkat atas Tenant yang didukung.

Visibilitas

Tidak digunakan lagi. Semua resource hanya dapat dilihat oleh pemilik.

Enum yang menunjukkan pengguna yang memiliki akses lihat ke resource.

Enum
VISIBILITY_UNSPECIFIED Nilai default.
ACCOUNT_ONLY Resource tersebut hanya dapat dilihat oleh akun GCP yang memilikinya.
SHARED_WITH_GOOGLE Resource ini dapat dilihat oleh pemilik serta dapat dilihat oleh aplikasi dan proses lain di Google.
SHARED_WITH_PUBLIC Resource dapat dilihat oleh pemilik dan mungkin dapat dilihat oleh semua klien API lainnya.