> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/fields/latest/batch_job).

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v23/batch_job_query_builder.md.txt) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/resources/batch_job.proto)

A list of mutates being processed asynchronously. The mutates are uploaded
by the user. The mutates themselves aren't readable and the results of the
job can only be read using BatchJobService.ListBatchJobResults.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v23/customer.md.txt) |

Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields **will not segment**
metrics in your `SELECT` clause.

## batch_job.id

Field descriptionOutput only. ID of this batch job.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.long_running_operation

Field descriptionOutput only. The resource name of the long-running operation that can be
used to poll for completion. Only set when the batch job status is RUNNING
or DONE.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.completion_date_time

Field descriptionOutput only. The time when this batch job was completed.
Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00"
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.creation_date_time

Field descriptionOutput only. The time when this batch job was created.
Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00"
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.estimated_completion_ratio

Field descriptionOutput only. The fraction (between 0.0 and 1.0) of mutates that have been
processed. This is empty if the job hasn't started running yet.
Category`ATTRIBUTE` Data Type`DOUBLE` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.executed_operation_count

Field descriptionOutput only. The number of mutate operations executed by the batch job.
Present only if the job has started running.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.execution_limit_seconds

Field descriptionImmutable. The approximate upper bound for how long a batch job can be
executed, in seconds. If the job runs more than the given upper bound,
the job will be canceled.
Category`ATTRIBUTE` Data Type`INT32` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.operation_count

Field descriptionOutput only. The number of mutate operations in the batch job.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.metadata.start_date_time

Field descriptionOutput only. The time when this batch job started running.
Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:30"
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.next_add_sequence_token

Field descriptionOutput only. The next sequence token to use when adding operations. Only
set when the batch job status is PENDING.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.resource_name

Field descriptionImmutable. The resource name of the batch job.
Batch job resource names have the form:

`customers/{customer_id}/batchJobs/{batch_job_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)

## batch_job.status

Field descriptionOutput only. Status of this batch job.
Category`ATTRIBUTE` Data Type `ENUM`
`DONE``PENDING``RUNNING``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.BatchJobStatusEnum.BatchJobStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[batch_job](https://developers.google.com/google-ads/api/fields/v23/batch_job.md.txt)