Some or all of the information on this page might not apply to Trusted Cloud by S3NS.
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.
- The Metadata URI is used for most interactions, as it accepts the job configuration directly.
- The Upload 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 uses gRPC Transcoding syntax.
Path parameters
| Parameters |
projectId |
string
Project ID of project that will be billed for the job.
|
Request body
The request body contains an instance of Job.
Response body
If successful, the response body contains an instance of Job.
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 the Authentication Overview.
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 2025-07-02 UTC.
[[["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 2025-07-02 UTC."],[[["This API endpoint initiates a new asynchronous job, offering two distinct URI types: Metadata and Upload."],["The Metadata URI handles standard interactions by accepting the job configuration directly, while the Upload URI is specifically for simultaneous transmission of both job configuration and a data stream."],["The request utilizes either the Metadata URI (`POST https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/jobs`) or the Upload URI (`POST https://bigquery.googleapis.com/upload/bigquery/v2/projects/{projectId}/jobs`)."],["Both the request and response bodies utilize the `Job` resource."],["Authorization requires one of several specified OAuth scopes, including `https://www.googleapis.com/auth/bigquery` or `https://www.googleapis.com/auth/cloud-platform`."]]],[]]
