Returns an option to specify the job's fields to be returned by the RPC call. If this option
is not provided all job's fields are returned. JobOption.fields() can be used to
specify only the fields of interest. Job#getJobId(), JobStatus#getState(),
JobStatus#getError() as well as type-specific configuration (e.g. QueryJobConfiguration#getQuery() for Query Jobs) are always returned, even if not specified.
JobField#SELF_LINK and JobField#ETAG can not be selected when listing jobs.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class BigQuery.JobListOption (2.54.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.54.1 (latest)](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.54.0](/java/docs/reference/google-cloud-bigquery/2.54.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.53.0](/java/docs/reference/google-cloud-bigquery/2.53.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.52.0](/java/docs/reference/google-cloud-bigquery/2.52.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.51.0](/java/docs/reference/google-cloud-bigquery/2.51.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.50.1](/java/docs/reference/google-cloud-bigquery/2.50.1/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.49.0](/java/docs/reference/google-cloud-bigquery/2.49.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.48.1](/java/docs/reference/google-cloud-bigquery/2.48.1/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.47.0](/java/docs/reference/google-cloud-bigquery/2.47.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.46.0](/java/docs/reference/google-cloud-bigquery/2.46.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.45.0](/java/docs/reference/google-cloud-bigquery/2.45.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.44.0](/java/docs/reference/google-cloud-bigquery/2.44.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.43.3](/java/docs/reference/google-cloud-bigquery/2.43.3/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.42.3](/java/docs/reference/google-cloud-bigquery/2.42.3/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.41.0](/java/docs/reference/google-cloud-bigquery/2.41.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.40.3](/java/docs/reference/google-cloud-bigquery/2.40.3/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.39.1](/java/docs/reference/google-cloud-bigquery/2.39.1/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.38.2](/java/docs/reference/google-cloud-bigquery/2.38.2/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.37.2](/java/docs/reference/google-cloud-bigquery/2.37.2/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.36.0](/java/docs/reference/google-cloud-bigquery/2.36.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.35.0](/java/docs/reference/google-cloud-bigquery/2.35.0/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.34.2](/java/docs/reference/google-cloud-bigquery/2.34.2/com.google.cloud.bigquery.BigQuery.JobListOption)\n- [2.33.2](/java/docs/reference/google-cloud-bigquery/2.33.2/com.google.cloud.bigquery.BigQuery.JobListOption) \n\n public static class BigQuery.JobListOption extends Option\n\nClass for specifying job list options. \n\nInheritance\n-----------\n\n[Object](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html) \\\u003e com.google.cloud.bigquery.Option \\\u003e BigQuery.JobListOption \n\nInherited Members\n-----------------\n\ncom.google.cloud.bigquery.Option.equals(java.lang.Object) \ncom.google.cloud.bigquery.Option.hashCode() \ncom.google.cloud.bigquery.Option.toString() \n[Object.clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--) \n[Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) \n[Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) \n[Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) \n[Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) \n[Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) \n[Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) \n[Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-)\n\nStatic Methods\n--------------\n\n### allUsers()\n\n public static BigQuery.JobListOption allUsers()\n\nReturns an option to list all jobs, even the ones issued by other users.\n\n### fields(BigQuery.JobField\\[\\] fields)\n\n public static BigQuery.JobListOption fields(BigQuery.JobField[] fields)\n\nReturns an option to specify the job's fields to be returned by the RPC call. If this option\nis not provided all job's fields are returned. `JobOption.fields()` can be used to\nspecify only the fields of interest. Job#getJobId(), [JobStatus#getState()](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.JobStatus#com_google_cloud_bigquery_JobStatus_getState__),\n[JobStatus#getError()](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.JobStatus#com_google_cloud_bigquery_JobStatus_getError__) as well as type-specific configuration (e.g. [QueryJobConfiguration#getQuery()](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.QueryJobConfiguration#com_google_cloud_bigquery_QueryJobConfiguration_getQuery__) for Query Jobs) are always returned, even if not specified.\n[JobField#SELF_LINK](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.BigQuery.JobField#com_google_cloud_bigquery_BigQuery_JobField_SELF_LINK) and [JobField#ETAG](/java/docs/reference/google-cloud-bigquery/latest/com.google.cloud.bigquery.BigQuery.JobField#com_google_cloud_bigquery_BigQuery_JobField_ETAG) can not be selected when listing jobs.\n\n### maxCreationTime(long maxCreationTime)\n\n public static BigQuery.JobListOption maxCreationTime(long maxCreationTime)\n\nReturns an option to filter out jobs after the given maximum creation time.\n\n### minCreationTime(long minCreationTime)\n\n public static BigQuery.JobListOption minCreationTime(long minCreationTime)\n\nReturns an option to filter out jobs before the given minimum creation time.\n\n### pageSize(long pageSize)\n\n public static BigQuery.JobListOption pageSize(long pageSize)\n\nReturns an option to specify the maximum number of jobs returned per page.\n\n### pageToken(String pageToken)\n\n public static BigQuery.JobListOption pageToken(String pageToken)\n\nReturns an option to specify the page token from which to start listing jobs.\n\n### parentJobId(String parentJobId)\n\n public static BigQuery.JobListOption parentJobId(String parentJobId)\n\nReturns an option to list only child job from specify parent job id.\n\n### stateFilter(JobStatus.State\\[\\] stateFilters)\n\n public static BigQuery.JobListOption stateFilter(JobStatus.State[] stateFilters)\n\nReturns an option to list only jobs that match the provided state filters."]]
