Method: jobs.insert
Starts a new asynchronous job.
This API has two different kinds of endpoint URIs, as this method supports a variety of use cases.
- TheMetadata URI is used for most interactions, as it accepts the job configuration directly.
- TheUpload URI is ONLY for the case when you're sending both a load job configuration and a data stream together. In this case, the Upload URI accepts the job configuration and the data as two distinct multipart MIME parts.
HTTP request
- Upload URI, for media upload requests:
POST https://bigquery.googleapis.com/upload/bigquery/v2/projects/{projectId}/jobs - Metadata URI, for metadata-only requests:
POST https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/jobs
The URL usesgRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
projectId |
Project ID of project that will be billed for the job. |
Request body
The request body contains an instance ofJob.
Response body
If successful, the response body contains an instance ofJob.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/bigqueryhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/devstorage.full_controlhttps://www.googleapis.com/auth/devstorage.read_onlyhttps://www.googleapis.com/auth/devstorage.read_write
For more information, see theAuthentication Overview.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.