Send feedback
batch_job
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
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.
Fields from the preceding resources can be selected along with this
resource in your SELECT and WHERE clauses. These fields do not segment
metrics in your SELECT clause.
batch_job.id
Field description Output only. ID of this batch job.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: batch_job
batch_job.long_running_operation
Field description Output 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
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output 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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output 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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output 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
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output only. The number of mutate operations executed by the batch job.
Present only if the job has started running.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Immutable. 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
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output only. The number of mutate operations in the batch job.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Field description Output 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
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
batch_job.next_add_sequence_token
Field description Output only. The next sequence token to use when adding operations. Only
set when the batch job status is PENDING.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
batch_job.resource_name
Field description Immutable. 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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
batch_job.status
Field description Output only. Status of this batch job.
Category ATTRIBUTE
Data Type ENUM
DONE
PENDING
RUNNING
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.BatchJobStatusEnum.BatchJobStatus
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as batch_job.id .
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-11-17 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-11-17 UTC."],[],[]]